Skip to Content
🔗

Set up single sign-on

Updated 2026-11-20

With single sign-on, your team signs in to Lynx with the account they already have in your identity provider, with its password and its multi-factor rules. The Lynx Keycloak SSO module works with Keycloak and with other OpenID Connect providers.

  1. In your identity provider, create a client for Lynx with the redirect URL https://<your Lynx address>/auth_oauth/signin, and note its client ID and secret.
  2. In Lynx, install Lynx Keycloak SSO from the Apps app.
  3. Settings > General Settings, Integrations section, OAuth Authentication: click OAuth Providers and open the Keycloak (OIDC) provider.
  4. Enter the issuer URL (for example https://id.example.com/realms/example), the client ID and the client secret, then click Discover Endpoints and Test Connection.
  5. Choose whether users are created on their first sign-in and which groups they receive, then tick Allowed to show the sign-in button on the login page.

Note: An existing user is matched by email address. If your provider sends group membership, you can map provider groups to Lynx groups on the provider, and choose an Employee Group whose members become internal users while everyone else becomes a portal user.

Tip: Keep one administrator able to sign in with a password and two-factor authentication, in case the identity provider is unreachable.

Single sign-on modules are Premium modules: your plan must include them.

Was this article helpful?
Thank you for your feedback. Still stuck? Contact us