Skip to main content

​
OIDC SSO Integration

This guide explains how to configure OpenID Connect (OIDC) Single Sign-On (SSO) for your organization on our platform.

​
Prerequisites

Before you begin, ensure you have the following:
  1. OIDC Provider Account: Access to an OIDC provider (e.g., Microsoft Azure AD, Google, Auth0).
  2. Client Credentials: Obtain these details from your OIDC provider:
    • Client ID
    • Client Secret
    • Authorization Endpoint
    • Token Endpoint
    • User Info Endpoint
  3. User Mapping Keys: Determine the keys your OIDC provider uses for user details:
    • User Identifier Key (e.g., userPrincipalName, email)
    • First Name Key
    • Last Name Key

​
Configuration Steps

​
Step 1: Enable OIDC SSO

  1. Go to Organization Single Sign-On (SSO) settings in the application.
  2. Toggle SSO to Enabled.
  3. Select OIDC as the SSO protocol.

​
Step 2: Fill in the Required Fields

Fill out the following fields using information from your OIDC provider:

​
Step 3: Configure User Mapping

Specify the user information fields returned by your OIDC provider:
Note: If your OIDC provider uses the same key for both first and last names (e.g., displayName), use that key in both fields.

​
Step 4: Save Changes

Click the Save Changes button to store your configuration. The SSO login will be enabled for your organization.

​
Testing the Integration

  1. Log out of your account.
  2. Click Sign In on the login page.
  3. Select the Sign in with SSO option.
  4. Authenticate through your OIDC provider.
  5. Verify that:
    • You are redirected back to the application.
    • User details (e.g., name, email) are correctly displayed.

​
Example Configuration for Microsoft Azure AD

Here’s an example configuration for Azure AD: Replace <tenant-id> with your Azure AD tenant ID.

​
Troubleshooting

  • Invalid Client ID/Secret: Ensure the client ID and secret are correct.
  • Authorization Error: Verify the authorization endpoint URL and ensure the redirect URI matches the one registered with your OIDC provider.
  • User Info Mapping Issues: Test the user info endpoint response using a tool like Postman to confirm the keys match your configuration.
Need help? Contact our support team for assistance!