ClickHelp Documentation

Salesforce SSO Integration

You can log in to your ClickHelp documentation portal using your Salesforce account for authentication. Let's see, how you can configure this:

  • Log in to your Salesforce org using an administrator account and go to Setup.
  • Open the App Manager page and click New Connected App.

  • Specify the name for the new connected application.
  • Now you need to get some information from your ClickHelp portal. Open it, go to SSO Settings and get the Redirect URL field value for the Salesforce connection item.

  • Go back to Salesforce, check the Enable OAuth Settings box, put the redirect URL taken from ClickHelp to the Callback URL field and move the following scopes to the Selected OAuth Scopes list:
    * Access your basic information (id, profile, email, address, phone)
    * Allow access to your unique identifier (openid)
  • Save changes and find the Consumer Key and Consumer Secret values on the app summary page.
  • Put these values to the Client ID and Client Secret fields of the Salesforce connection settings in your ClickHelp portal. Enable the connection and save changes.
  • Now, it should be possible to login to your ClickHelp portal using the Salesforce OpenID Connect provider. However, you may need to change up some security settings beforehand. For this, go to the Manage Connected Apps screen in Salesforce and click the application you registered a minute ago.

  • Click Edit Policies and set the "All users may self-authorize" value for the Permitted Users field, and the "Relax IP restrictions" for the IP Relaxation field.

  • That’s all, you can login to your ClickHelp portal using your Salesforce credentials - the corresponding option will appear on the Login screen.