---
title: "Okta SAML 2.0 SSO Setup"
canonical: "https://help.agiloft.com/space/HELP/43716924/Okta+SAML+2.0+SSO+Setup"
format: markdown
---
This article provides instructions for setting up SAML 2.0 single sign-on (SSO) with Okta as the Identity Provider (IdP). It also includes instructions on how to log in with SSO after the integration and make sure other users log in with SSO as well.

> Macro (include)

# Set Up SAML 2.0 SSO

> Macro (include)

## > Macro (anchor)

Create a SAML SSO Profile

> Macro (include)

## > Macro (anchor)

Configure Service Provider Details

> Macro (include)

At this point, you can't finish the setup in Agiloft until you configure your IdP. Continue to [Configure Okta](#configure_idp) for instructions on setting up your IdP.

## > Macro (anchor)

Configure Okta

Follow the steps below to integrate Agiloft CLM as a SAML service provider in Okta.

> ℹ️ These are general steps for integrating an application in Okta. If the options you see in the Admin Console or your practices for integrating apps differ from those described here, refer to Okta's [documentation](https://help.okta.com/oie/en-us/content/topics/apps/apps_app_integration_wizard_saml.htm) on creating SAML app integrations to complete the task.

1. First, download the X.509 certificate from Agiloft:
  1. Go to **Setup > Access > Configure SAML 2.0 Profiles**.
  2. Select the profile for this IdP, then click Download X.509 Certificate. The file is downloaded as a .txt file.
  3. Go to the directory where the certificate was downloaded.
  4. Rename the file to change the extension from `.txt` to `.crt`.
2. Now, edit the profile for this IdP and go to the Service Provider Details tab.
3. Leave the Agiloft Service Provider Details open in your browser and log in to the [Okta Admin Console](https://login.okta.com/) in another tab.
4. In Okta, go to **Applications > Applications**, then click Create App Integration.
5. Select SAML 2.0 and click Next.
6. Under General Settings, enter a Name for the application, configure any optional settings, then click Next.
7. Under SAML settings, complete the following fields. Refer to Okta's [SAML field reference](https://help.okta.com/en-us/content/topics/apps/aiw-saml-reference.htm) for information about the fields.
  1. **Single sign-on URL**: The URL from the SAML 2.0 Assertion Consume Service (ACS) Endpoint field in Agiloft CLM.
    - If you updated the KB to support multiple SAML providers, the URL looks similar to: `https://example.agiloft.com/gui2/spsamlsso?project=Example+KB+Name&profileId=65cddbb0-63e5-4adf-a002-e23b2ab9f65e`
    - If you didn't update the KB to support multiple profiles, the URL looks similar to: `https://example.agiloft.com/gui2/spsamlsso?project=Example+KB+Name`
  2. **Audience URI (SP Entity ID)**: The URL from the Agiloft (SP) Entity Id field in Agiloft CLM. For example: `https://example.agiloft.com/Example_KB_Name` or `https://example.agiloft.com/gui2/spsamlsso?project=Example_KB_Name__65cddbb0-63e5-4adf-a002-e23b2ab9f65e`
  3. **Default RelayState**: Leave this field blank.
  4. **Name ID format**: Accept the default value, Unspecified.
  5. **Application username**: Select the same identifier you selected in the "Name identifier format in SAML Assertion sent by IdP" field in Agiloft CLM. Or select a different identifier and change the value in Agiloft CLM to match. Email is typically chosen.
8. Click the link to Show Advanced Settings. Accept the default options, except for the following fields:
  1. **Assertion Encryption**: Change this value to Encrypted.
  2. **Encryption Certificate**: Browse for and upload the X.509 Certificate that you downloaded from Agiloft CLM.
  3. **Authentication context class**: Change this value to Unspecified.
9. If you want to create or update user records in Agiloft CLM based on attributes from Okta, add Attribute Statements to send in the SAML assertion. See Okta's [documentation](https://help.okta.com/oie/en-us/content/topics/apps/define-attribute-statements.htm) on defining attribute statements for instructions.
10. If you want to assign groups in Agiloft CLM based on group attributes in Okta, add Group Attribute Statements to the SAML assertion. See Okta's [documentation](https://help.okta.com/oie/en-us/content/topics/apps/define-group-attribute-statements.htm) on defining group attribute statements for instructions.
11. Save the names of any attribute statements to a note so you can refer to them later, then click Next.
12. Complete the feedback page and click Finish. The console displays the Sign On tab for the new application.
13. On the Sign On tab, retrieve the IdP metadata XML contents to use for configuring IdP details in Agiloft CLM:
  1. On the right side of the screen under SAML Setup, click View SAML setup instructions.
  2. At the bottom of the instructions screen, copy all of the XML contents in the "Provide the following IDP metadata to your SP provider" text box to a note so you can refer to it later.
14. Finally, assign the application to the users and groups who need access to log in with SSO:
  1. In the Admin Console, click the Assignments tab.
  2. Assign the users and groups who need access to Agiloft CLM with SAML SSO.
  3. Click Done.

Now that Okta is configured, return to Agiloft CLM. If you want to configure IdP attribute to Agiloft CLM field mappings, continue to [Configure User Group, Team, and Fields Mapping](#mapping) below. If you don't want to configure mappings, proceed to [Configure Identity Provider Details](#identity_provider). 

## > Macro (anchor)

Configure User Group, Team, and Fields Mapping

> Macro (include)

### > Macro (anchor)

SAML Attribute Mapping

The following image shows some attribute statements that are configured for a SAML application in Okta:

![Attribute Statements in Okta](media://d4725a84-4131-4acc-9164-7857dccde01d)

To map the attributes to fields in Agiloft CLM, enter the attribute Names in the relevant fields on the User Field(s) Mapping tab.

![User FIelds Mapping in Agiloft](media://cd075f54-f37f-4509-a2a5-9823f5a1723b)

Now that user, group, and team mappings are configured, proceed to [Configure Identity Provider Details](#identity_provider) to complete the SAML SSO setup.

## > Macro (anchor)

Configure Identity Provider Details

> Macro (include)

# > Macro (anchor)

Log in with SAML

> Macro (include)

# > Macro (anchor)

Force SSO Login

> Macro (include)

# > Macro (anchor)

Generating a Key Pair

> Macro (include)

#### Related articles

> Macro (contentbylabel)