ClickHelp supports the OpenID Connect technology of single sign-on. To learn more about this technology, refer to this web resource: http://openid.net/connect/
Contributors or Power Readers can authenticate in your documentation portal through a third-party authentication service: your own endpoint that implements an OpenID Connect Identity Provider or one of the supported endpoints available on the Internet.
Configuring Multiple Identity Providers
ClickHelp gives you the flexibility to connect and manage multiple SSO providers simultaneously. This is particularly useful for organizations that need to grant access to different user groups, such as employees and external users, all within a single documentation portal.
You can configure each provider individually in the ClickHelp portal settings. Once configured, all active providers will be available as options on your portal's login page, allowing users to choose the appropriate method for their authentication.
Setting the Default Login Method
In the SSO settings, you can specify the default login behavior for your portal. This setting determines what users see when they navigate to your main login page:
- ClickHelp Login: The default view will be the standard ClickHelp login form with login and password fields.
- Specific SSO Provider: You can select one of your configured SSO providers as the default. In this case, the login page will prominently feature a button to log in with that specific provider, streamlining the process.
This setting controls the initial user experience but does not restrict users from choosing other active login methods if they are available.
Login with the idp Parameter
To create an even more seamless authentication experience, ClickHelp supports a special idp parameter in the URL. This feature allows you to bypass the login page entirely and redirect users directly to a specific identity provider's authentication flow.
You can append the idp parameter to any restricted page URL (i.e., any page that requires login) or directly to the login page URL. Example: https://portal.clickhelp.co/login?idp=Google
By leveraging these features—multiple providers, a configurable default method, and the direct idp parameter—you can tailor the login experience precisely to your organization's needs and user workflows.
To learn more about configuring each SSO providers, refer to the following topics:
- SSO User Matching
- Use Google as SSO Provider
- Use Microsoft Entra ID as SSO Provider
- Use Salesforce as SSO Provider
- Use a Custom Identity Provider