Using OpenID Connect for Single Sign On
If you're using OpenID Connect to let users log in to your own app already, you can use that exact same login for HelpDocs. 💪
Setup, Requested Scopes & Claims
To use OpenID Connect federation with HelpDocs you'll need to make sure you've got a standards-compliant OpenID Connect server with a public provider endpoint that our servers can use for discovery.
We request the openid, email and profile scopes from your OpenID Connect server. If email is not provided, login will fail for your users.
We expect custom claims for email, given_name & family_name. You can also provide role (
externalviewer) and a comma separated list of user_groups if you want to assign these at login.
When you set up HelpDocs in your SSO provider it'll ask you for a callback URL. That's
https://your-domain.helpdocs.io/login/oidc/callback (replacing "your-domain" with your HelpDocs subdomain).
Setting Up OpenID Connect SSO in HelpDocs
Lastly you need to set up OpenID Connect in your HelpDocs dashboard. You'll need your server's Provider URL, Client ID and Client Secret for this step.
- Head to Settings > Access Control (or click here)
- Under Single Sign-On, click OpenID Connect
- Fill in your Provider URL, Client ID and Client Secret
- Hit Connect
If everything's gone ok, you'll now see a button on the login page of your account to log in with OpenID Connect.