Skip to Content
You are viewing a beta version of Clerk Docs
Visit the latest docs
Clerk logo

Clerk Docs

Ctrl + K
Go to clerk.com

Use Okta Workforce for SAML SSO

You will learn how to:

    • Use Okta Workforce to enable single sign-on (SSO) via SAML for your Clerk application.

Tutorial

Set up an enterprise connection in Clerk

To create a SAML connection in Clerk:

  1. Navigate to the Clerk Dashboard(opens in a new tab).
  2. In the navigation sidebar, select User & Authentication > Enterprise Connections(opens in a new tab).
  3. Select the Create connection button.
  4. You will be presented with a modal to create a new connection. Fill in the required fields and for the Identity Provider, select Okta Workforce.
  5. Next, on the Connection page, do not select the Enable connection toggle just yet. You need to fully configure your IdP first before exposing your connection to your users.
  6. Leave this page open. You will need to come back to it to complete the setup.

Create a new enterprise application in Okta

To create a new enterprise application in Okta:

  1. Navigate to Okta(opens in a new tab) and sign in.
  2. In the Okta dashboard, select Admin in the top right corner.
  3. In the navigation sidebar, select the Applications dropdown and select Applications.
  4. Select the Create App Integration button.
  5. In the Create a new app integration modal, select the SAML 2.0 option and select the Next button.
  6. Once redirected to the Create SAML Integration page, fill in the General Settings fields. An App name is required.
  7. Select the Next button to continue.

Configure your service provider

Once you have moved forward from the General Settings instructions, you will be presented with the Configure SAML page.

To configure your service provider (Clerk), you must add these two fields to your IdP's application:

  • Single sign-on URL - This is a unique identifier for your SAML connection that your IdP application needs.
  • Audience URI (SP Entity ID) - This is your application's URL that your IdP will redirect your users back to after they have authenticated in your IdP.

To fill out the appropriate values for these fields:

  1. In the Clerk Dashboard, find the Service Provider configuration section.
  2. Copy the Single sign-on URL and Audience URI (SP Entity ID).
  3. In the Okta dashboard, paste these values into their respective fields.

Map Okta claims to Clerk attributes

Mapping the claims in your IdP to the attributes in Clerk ensures that the data from your IdP is correctly mapped to the data in Clerk.

  1. In the Okta dashboard, find the Attribute Statements (optional) section.
  2. For the Name field, enter mail.
  3. For the Value field, choose user.email from the dropdown.
  4. Select the Add Another button to add another attribute.
  5. For the Name field, enter firstName.
  6. For the Value field, choose user.firstName from the dropdown.
  7. Select the Add Another button to add another attribute.
  8. For the Name field, enter lastName.
  9. For the Value field, choose user.lastName from the dropdown.
  10. Scroll to the bottom of the page and select the Next button to continue.
  11. You will be redirected to the Feedback page. Fill out the feedback however you would like and select the Finish button to complete the setup.

Configure your identity provider

Once you have completed the setup in Okta, you will be redirected to the application instances page with the Sign On tab selected.

  1. Under Sign on methods, copy the Metadata URL.
  2. In the Clerk Dashboard, find the Identity Provider configuration section.
  3. Under the Metadata configuration option, paste the Metadata URL.
  4. Select the Save changes button to complete the setup.

Enable the connection for Clerk

To make the connection available for your users to authenticate with:

  1. In the Clerk Dashboard, scroll to the top of the Connection page.
  2. Toggle on the Enable connection option.

Assign selected user or group in Azure

You need to assign your users/user groups to your enterprise application. For example, if you were part of the Clerk organization, you would have access to users and groups in the Clerk organization. In this case, you could assign one or more users or entire groups to the enterprise application you just created.

  1. In the Okta dashboard, select the Assignments tab.
  2. Select the Assign dropdown. You can either select Assign to people or Assign to groups.
  3. In the search field, enter the user or group of users that you want to assign to the enterprise application.
  4. Select the Assign button next to the user or group that you want to assign.
  5. Select the Done button to complete the assignment.

Last updated on April 2, 2024

What did you think of this content?

Clerk © 2024