---
title: "Configuring Corporate Sign In and User Provisioning with Okta"
canonical: "https://documentation.chaos.com/space/LIC5/244351129/Configuring%20Corporate%20Sign%20In%20and%20User%20Provisioning%20with%20Okta"
format: markdown
---
This page provides information on how to configure Corporate Sign In to Chaos services with Okta.

## **Overview**

---

<span style="color: #000000">In this section we explore how you can integrate your Okta identity provider with Chaos, so that your employees benefit from the </span><span style="color: #000000">**Corporate Sign In**</span><span style="color: #000000"> functionality.</span>


## **Prerequisites**

---

<span style="color: #000000">Before doing the steps in this section, make sure to </span>reach out to Chaos<span style="color: #000000"> first to request the Corporate Sign In feature.</span>

In order to proceed with configuring login with SSO through Okta, you must:

- Have administrative access to an Okta tenant
- <span style="color: #000000">Have a Chaos account with an active commercial subscription</span>

## **Supported Features**

---

<span style="color: #000000">Chaos supports the following features for Single Sign-On using OpenID Connect:</span>

- SP-initiated SSO (Single Sign-On)

<span style="color: #000000">Chaos supports the following features for automated user provisioning using SCIM:</span>

- <span style="color: #000000">Create users</span>
- <span style="color: #000000">Update user attributes</span>
- <span style="color: #000000">Deactivate users</span>
- <span style="color: #000000">Import users</span>

Features with limited support:

- Deleting users in Okta currently does not apply to the account in Chaos.
- When a user's primary email (login email) is changed, a new user is provisioned in Chaos

For more information on the listed features, visit the [Okta Glossary](https://help.okta.com/okta_help.htm?type=oie&id=ext_glossary).


## **Adding the Chaos Application to Okta**

---


1. Log in to your **Okta **portal and navigate to the **Applications** page.
2. Select **Browse App Catalog**
3. Search for the **Chaos application**<span style="color: #272727"> and select it.</span>
4. <span style="color: #272727">From the </span><span style="color: #272727">**Chaos**</span><span style="color: #272727"> app page, select ➕</span><span style="color: #272727">**App Integration**</span>
5. <span style="color: #272727">Enter </span><span style="color: #272727">**Application label**</span><span style="color: #272727"> - </span><span style="color: #272727">*Chaos*</span><span style="color: #272727">, then click </span><span style="color: #272727">**Done**</span>

![image](media://a10236a0-20f6-421c-81c8-0625c145c65b)

![image](media://fb108478-93a9-4304-8527-3529ed86f1dc)


## **Configuration by Chaos Support**

---


As part of your initial request to Chaos Support, you will be asked to provide several configuration details.

1. In the **Sign On **tab, under **Settings**, copy the **Client ID **and **Client Secret**
2. Open the **OpenID Provider Metadata** link, and copy the Issuer URL
3. Provide the Issuer URL, Client ID, Client Secret, Domain name, and Chaos administrator account to Chaos Support
4. Chaos Support team will perform the initial configuration as needed. After this is done, you can proceed with the next steps.

![image](media://ef9bedd1-fe10-439f-9348-e5548c903286)


## **Configuring Okta for Single Sign-on to Chaos (OpenID Connect)**

---


From the application page, under the **Assignments **tab, use the **Assign **menu to assign people and groups to the application.

![image](media://df2388ec-55dd-4247-99e8-039d41736fd1)


## **Configuring Okta for automatic user provisioning (SCIM)**

---


1. From the application page, under the **General** tab, click **Edit **on the App Settings section:
  1. Enter **SCIM URL** as provided by Chaos support
  2. Save
2. Navigate to the **Provisioning **tab and click **Configure API Integration**
  1. Check **Enable API Integration**.
  2. Set **API Token** as provided by Chaos Support
  3. Click the **Test API Credentials** button to verify that the credentials are working
  4. Save
3. Edit the **Provisioning to App** section:
  1. Enable *Create Users, Update User Attributes, Deactivate Users*
  2. Save
4. Validate the **Attribute Mappings** as shown in the screenshot. Make sure that the following attribute mappings are defined as a minimum:
  - Username, Given Name, Family Name, Email, Primary Email Type

![image](media://982af0cd-09a4-4eda-a5bb-0208e15514a8)

![image](media://ed466669-6709-4093-903f-fb03e2fc2a71)

![image](media://5efb61db-4bfa-436a-bd8e-e8e76aa32cea)


## **Using the Single Sign-on (SP-initiated SSO)**

---


After the Chaos application has been configured, users can use their corporate credentials to sign in to Chaos.

1. From the Chaos Sign-in screen, select **Continue with corporate email**
2. Enter your corporate email and click **Next**
3. You will be redirected to the Okta sign in page, where you can use your corporate credentials to sign in
4. If your credentials are valid, you will be will be logged into Chaos.

![image](media://8511ee54-c581-4e1b-b5bf-49b09c3358e9)

## **Troubleshooting**

---

<span style="color: #000000">If you encounter any issues during the setup process, do not hesitate to reach out to </span><span style="color: #000000">[Chaos Support](https://support.chaos.com/hc/en-us/requests/new)</span><span style="color: #000000">.</span>