Home
Administering Connections 7.0
Welcome to the HCL Connections documentation site. HCL Connections is social networking software designed for the workplace. Its features help you to establish dynamic networks that connect you to the people and information you need to achieve your business goals.
Optional post-installation tasks
Complete the post-installation tasks that are relevant to your deployment.
Enabling anonymous access for the Rich Content Widget component
Define a system user to impersonate HTTP read-only requests to the File AppData API for the Rich Content Widget component.

Administering Connections 7.0
Welcome to the HCL Connections documentation site. HCL Connections is social networking software designed for the workplace. Its features help you to establish dynamic networks that connect you to the people and information you need to achieve your business goals.
- What's new in HCL Connections
  Find out about features that are new or updated in this release of HCL Connections.
- Product overview
  Learn how to deploy, customize, and administer the HCL Connections social networking product.
- Planning
  Before installing HCL Connections™, study the system requirements, deployment options, and documentation conventions.
- Installing Connections
  To install HCL Connections™, you need to follow a detailed series of procedures.
- Installing or upgrading Component Pack for Connections
  HCL Connections 7.0 now supports the latest Component Pack based in Harbor, an open-source container and Helm registry hosted by HCL for the Component Pack build. Deployments that are new or carrying Component Pack 7 will use this approach for a simplified installation/upgrade process, while releases prior to 7.0 will first need to upgrade to Component Pack 7 using a zip file and a local Docker registry.
- Post-installation tasks
  After installation, you need to perform further tasks to ensure an efficient deployment.
- Optional: Installing and configuring Tiny Editors for HCL Connections
  The Tiny editors are alternative rich-text editors which can be installed for HCL Connections™. They provide additional features and extensive customization options not available with the default editor.
- Optional post-installation tasks
  Complete the post-installation tasks that are relevant to your deployment.
  - Adding a node to a cluster
    Add a node to an existing cluster.
  - Configuring a reverse caching proxy
    Configure a reverse proxy that directs all traffic to your HCL Connections deployment to a single server.
  - JavaScript configuration
  - Enabling locked domains
    Assuming that you have completed the server setup previously described, to enable locked domains in HCL Connections, specify an additional attribute in the LotusConnections-config.xml to ensure that only ConnectionsOpensocial application is mapped to the locked domain host.
  - Configuring the custom ID attribute for users or groups
    Configure HCL Connections to use custom ID attributes to identify users and groups in the LDAP directory.
  - Post-installation tasks for Connections PDF Export
    PDF Export requires the wkhtmltox binary package in order to render PDF documents. This is a binary dependency that needs to be deployed on your HCL Connections server. The necessary installation steps are outlined below.
  - Post-installation tasks for Connections Touchpoint
    Touchpoint is an onboarding wizard aimed at increasing adoption for first time users. It provides a wizard that runs the user through mandatory steps: accepting policies and suggests content (people and communities) to follow in order to prepare a more customized and enhanced experience.
  - Configuring external collaboration
    External collaboration allows internal and external users to work together in your HCL Connections deployment. You can either configure this feature to allow self-registration by external users who received an invitation, or you can manage registration with a custom setup tailored to your particular environment.
  - Integrating Connections Sidebar with a website
    Configure a web application on a company-managed server to be able to display the Connections Sidebar, so that your users can see their important updates without leaving the website.
  - Configuring Files to use an object store
    Configure HCL Connections Files to seamlessly work with an external object store, providing scalability and data recovery for your deployment, while enabling faster access to files for users.
  - Installing and deploying HCL Connections Docs
    To extend HCL Connections to offer users a way to view documents, spreadsheets, and presentations within the Files application, install and set up Viewer from HCL Connections Docs.
  - Deploying URL preview in an environment where anonymous access is disabled
    To deploy URL preview optionally in an environment where anonymous access is disabled within HCL Connections, you must define a system user as a proxy for the oEmbed/image proxy services so that it can perform HTTP requests.
  - Enabling anonymous access for the Rich Content Widget component
    Define a system user to impersonate HTTP read-only requests to the File AppData API for the Rich Content Widget component.
  - Customizing browser cookie cleanup on user logout
    You can manage and add to the list of browser cookies to be cleaned up on user logout.
  - Configuring an NGINX server for long polling
    If you deploy an NGINX proxy server to manage push notifications for HCL Connections™, you can configure it to use load balancing and thus provide a greater long poll interval.
  - Setting up and configuring a WAS proxy server for long poll testing
    HTTP long polling can be used to push updates to a web client. A connection is held open between the web client and the web server so that when the server has new information it can push it to the client. That connection is then closed. For Connections Social Cloud, a WebSphere® Application Server (WAS) proxy server must be used to test this function.
  - Configuring notifications
    Enable support for email notifications in HCL Connections applications.
- Uninstalling
  Uninstall HCL Connections.
- Upgrading and updating
  Upgrade HCL Connections and its supporting software to the latest release and then update the installation with the latest interim fixes or cumulative fixes. Refer to the What's New in HCL Connections to review the features in the latest release and gather download links or links to the latest fix list and update strategy information.
- Administering
  Run administration and maintenance tasks to keep your environment up-to-date. For example, learn how to customize your deployment or how to use the wsadmin utility to edit configuration files. You can also schedule tasks, maintain application databases, moderate content, or manage users and their roles.
- Customizing
  Customize HCL Connections™ to fit your environment.
- Security
  HCL Connections™ provides a flexible security infrastructure that supports an open, easily shareable data model.
- Mobile
  See the HCL Connections™ Mobile documentation for Connections Cloud and Connections on-premises.
- Developing
  Get information about how to use the APIs provided with HCL Connections™ and how to use Connections Customizer to modify the Connections pages that are returned to users.
- Troubleshooting and support
  To isolate and resolve problems with your HCL products, you can use the troubleshooting and support information. This information contains instructions for using the problem-determination resources that are provided with your HCL products, including HCL Connections™.

Enabling anonymous access for the Rich Content Widget component

Define a system user to impersonate HTTP read-only requests to the File AppData API for the Rich Content Widget component.

About this task

To enable anonymous access for Rich Content Widget optionally in an environment within IBM Connections, you must define a system user to impersonate HTTP read-only requests to the File AppData API, and to be used by the Rich Content Widget component to retrieve content that is stored in File AppData for public Communities.

Procedure

Define a new system user in your user repository who can log in to Connections. Create a LDAP non-administrative account that is dedicated to the rteJAASAuth alias.
Note: In the next steps, the Rich Content Widget component is configured to log in as this system user when performing HTTP request against Connections resources. To avoid leaking private resources from Connections, it is important to ensure that this user does not have access to any private resource on the Connections environment such as not being a member of a community, or a participant in an activity.
- This system user only should be used for accessing public information stored in File AppData by public communities instead of an actual user on the platform.
- Do not use the default admin user, since administrative users have access to all Connections content, including private content.
Create a JAAS authentication alias, if it does not exist, named rteJAASAuth, and then set the user name and password of the user who is defined in step 1 as follows:
1. Log in to the WebSphere Application Server Integrated Solutions console.
2. In the WebSphere Application Server Integrated Solutions console, select Security > Global Security.
3. Use the + icon to expand Java Authentication and Authorization Service.
4. Click J2C authentication data.
5. Find the rteJAASAuth alias.
  - If the alias exists, click it to open it, add the user name and password of the user who is defined in step 1, and then click Save.
  - If the alias doesn't exist, create it, set the user name and password of the user who is defined in step 1, and then click Save.
Synchronize the WebSphere Application Server nodes, and then restart the Rich Content Widget application to apply the settings.