Skip to main content

Set Up Okta SSO for Catalog

In this guide, you’ll learn how to set up Okta SSO in Catalog.

Okta Administrator

You must be a Okta Administrator to complete this process.

Create Okta App Integration​

To use Okta as your Single Sign-On provider, you'll want to create a new App Integration in Okta.

  1. Open the admin panel for your Okta organization

  2. Click on Applications.

  3. Click on Create App Integration.

    Creating an App Integration in Okta

  4. For Create a new app integration:

    1. OIDC - OpenID Connect as the Sign-in method.
    2. Web Application as the Application Type and then create the new app integration.

  5. On the settings page for this newly created integration, enter the following:

    1. App Integration Name - You can use Catalog or any name.
    2. Grant type: AuthorizationCode
    3. Sign-in redirect URIs:
      1. https://api.castordoc.com/auth/okta/callback for accounts using app.castordoc.com
      2. https://api.us.castordoc.com/auth/okta/callback for accounts using app.us.castordoc.com
    4. Sign-out redirect URI:
      1. https://app.castordoc.com for accounts in the EU server
      2. https://app.us.castordoc.com for accounts in the US server
    5. Controlled Access - Select the setting that is appropriate for your organization.
    Enter the app integration name and grant type
    Enter the sign-in and sign-out redirect URIs
    Choose the access type for your organization

  6. Click Save. You'll now be at a window with all your App Integration settings. Keep this browser tab open as you'll need to enter some information from it into Catalog.

Get Your Okta Application Information​

You'll gather the information needed for Catalog.

  1. Get your Okta domain by clicking on your username and then copying the domain name.

  2. In the app settings, under General, copy the Client ID and Client Secret.

Add Your Connection Settings to Catalog​

You'll use your Okta Domain, Okta Client Id, and Okta Client Secret.

  1. Open Catalog > Settings > Authentication.
  2. Click Setup under Okta.
  3. Enter your Okta Domain, Okta Client Id, and Okta Client Secret then Save Configuration.