HCL Connections Setup

Technical User Configuration

The Raytion HCL Connections Connector synchronizes data from HCL Connections via the native API. In order to do so, the connector agent must authorize itself against HCL Connections.

Thus, to enable the connector agent to access all data required for indexing, user name and password of a technical user have to be configured. Refer to the Configuration section for details on the technical user credential properties.

In order to extract the sought-for information, the technical user must have read access to:

  1. the content to be synchronized, i.e., the search-admin role must be assigned for blogs, communities, files, forums, profiles, and wikis.

    A search-admin role can for instance be assigned in the integrated solutions console. For each HCL Connections application, users and groups can be mapped to the search-admin role.

  2. the communities and wiki members that are necessary for principal traversals. For this, the global-moderator role must be assigned for communities and the widget-admin role must be assigned for wikis.

In order to test whether the search-admin role was correctly provided, open one of the following SPI URLs: 
https://connections.company.com/blogs/seedlist/myserver
https://connections.company.com/communities/seedlist/myserver
https://connections.company.com/communities/calendar/seedlist/myserver
https://connections.company.com/dogear/seedlist/myserver
https://connections.company.com/dm/atom/seedlist/myserver
https://connections.company.com/files/seedlist/myserver
https://connections.company.com/forums/seedlist/myserver
https://connections.company.com/news/seedlist/myserver
https://connections.company.com/profiles/seedlist/myserver
https://connections.company.com/wikis/seedlist/myserver

The first point is of major importance, since the technical user must be able to read all data, including secured data, from HCL Connections' search API.

In the example above, the password is provided as clear text for testing purposes. Generally, you want to encrypt your password. To obtain the encrypted form of your password, use the Password Encryptor Tool which is delivered together with the connector.

HCL Connections Account Settings

In summary, these are mandatory configuration fields:

raytion.connector.agent.connections.server.username

Login name of a technical user for accessing the HCL Connections server

raytion.connector.agent.connections.server.password

Password of the technical user for accessing the HCL Connections server