Host Key Defined
The host is key is an identifier unique to Telligent Connect for Sitecore as a product. Its job is to identify itself as a service to the remote framework installed on the community. This identifier is used during the user authentication process to determine if a user is valid.
The Sitecore contextual user is used by Telligent Connect for Sitecore to locate a community account. It does this by using the full Sitecore user name, email address, and the Telligent Connect for Sitecore host key.
To successfully match a Sitecore user to an existing community user, the information from Sitecore (username, email and key) must match an existing user on the community. If a single one of these pieces of information fails to match, the user will be treated anonymously unless that user can be generated.
In the event that a look-up for a user returns no results, a user will be created provided the following conditions are met:
- The username (from Sitecore) is not in use on the community
- The email address(from Sitecore) is not in use on the community
- The username passes any restrictions defined in the community such as pattern or banned terms
- There are no other restrictions on account creation
If the conditions for user creation are met, a user is automatically created on the community using the same username and email address provided by Sitecore. In addition to creating the user, the host key for Telligent Connect for Sitecore is also stored with the user to be used during the look-up process as mentioned previously.
Communities with Pre-Existing Users
Telligent Connect for Sitecore authentication will not work by default on a community that has a pre-existing user base that was established before using Telligent Connect for Sitecore. The reason for this is that none of those users were created with the Telligent Connect for Sitecore host key. Without the host key, a requested user will fail the matching process of username, email and host key.
If you want to use your existing users and they already match a Sitecore user by username and email address, you will have to configure the framework on the community site to not use the host key in the user matching process:
- Log into your Telligent Enterprise as an administrator.
- Navigate to Control Panel > Site Administration > Site Configuration > Manage Plugins.
- Locate the Remote Studio Widget Support plugin and click Configure.
- Add 9304875024db42509bf88ac09f5d5691 to the Safe Host keys and click Save.
- Click Save at the bottom of the plugin management screen.