---
updatedAt: 2026-02-10T18:03:03.000Z
agentTools:
  projectIndex: https://docs.scalr.io/llms.txt
---

# Okta

<Callout icon="💡" theme="default">
  ### Note

  Scalr supports all SAML 2.0 providers; this is an example of a commonly used one.
</Callout>

## Configure Okta

In Okta, go to the admin portal, select applications, and then Browse App Catalog.

<Image border={false} src="https://files.readme.io/8862d9e-Screenshot_2023-02-07_at_10.15.52_AM.png" title="Screenshot 2023-02-07 at 10.15.52 AM.png" />

Browse the app catalog for Scalr:

<Image align="center" border={false} width="smart" src="https://files.readme.io/1770189-Screenshot_2023-02-07_at_10.16.04_AM.png" />

Select the **Add Integration** option to proceed to configuration.

Under the **Sign On tab**, go to SAML 2.0 and update Groups to **Matches regex** and the value is `.*`:

<Image align="center" border={false} width="smart" src="https://files.readme.io/ad5db39-Screenshot_2023-03-06_at_2.08.57_PM.png" />

Go to the Scalr account scope, click on **Integrations** and then **Okta** to obtain the IDP ID:

<Image align="center" border={false} width="smart" src="https://files.readme.io/0ec4ad6-Screenshot_2023-09-15_at_9.21.30_AM.png" />

In Okta, go to the **Advanced Sign-on Settings**, add the Scalr subdomain and IDP ID. Also, make sure that the **Application username format** in the **Credentials Details** in Okta is set to **Email**.

<Image align="center" border={false} width="smart" src="https://files.readme.io/5ed2612-Screenshot_2023-03-06_at_2.09.33_PM.png" />

In Okta, click on **View SAML setup instructions** on the right-hand side to obtain the metadata URL and paste it into Scalr:

<Image align="center" border={false} width="smart" src="https://files.readme.io/77ec8f4-Screenshot_2023-09-15_at_9.22.38_AM.png" />

You can now verify the connection in Scalr. The SAML integration is now complete, you can set up automatic provisioning by proceeding with the rest of this document.

## Provisioning/SCIM Settings

<Callout icon="❗️" theme="error">
  Before configuring SCIM please make sure SAML is configured and enabled.
</Callout>

Note: This is included in the [enterprise plan](https://scalr.com/enterprise-plan). Contact [support](http://support.scalr.com/) if you have any questions.

## Supported Features

* Create Users
* Update User Attributes
* Deactivate Users
* Import Users
* Import Groups
* Group Push

## Configuration Steps

Scalr supports the SCIM (System for Cross-domain Identity Management) protocol to automatically add and remove users from Scalr. To enable it, first generate the SCIM token from Scalr by going to the Security->SSO settings and clicking "Enable SCIM Provisioning". This will be used in Okta in a later step.

<Image align="center" border={false} width="smart" src="https://files.readme.io/f3c0eeb73212e4738531f72856be8c8f6fb9a60583f023536c880612e3c91e0e-Screenshot_2025-01-02_at_10.39.42_AM.png" />

Open the **Provisioning** tab in Okta and select the **Configure API Integration** button. You will then see the following options:

<Image align="center" border={false} width="smart" src="https://files.readme.io/020410a-Screenshot_2023-02-07_at_10.19.11_AM.png" />

Check the **Enable API Integration** checkbox. Add the API token from earlier.

Once you are finished, click the Test API Credentials button to test your configuration and save.

Click on the **To App** tab in the provisioning settings and check off **Create Users, Update User Attributes,** and **Deactivate Users**.

<Image align="center" border={false} width="smart" src="https://files.readme.io/0cbb9a3-Screenshot_2023-02-07_at_10.19.26_AM.png" />

## Default Scalr Role

Optionally, a default Scalr role can be set for all newly provisioned users. If a role is not specified, the users will be assigned the `account:read` permission to give them access to Scalr, with minimal permissions:

<Image align="center" border={false} src="https://files.readme.io/042064983859373dcb8297d39c661e2dd29587cd9c21133058a4ccd72cd674ba-Screenshot_2025-01-02_at_10.42.46_AM.png" />

# Sibling pages

* [Microsoft Entra](https://docs.scalr.io/scalr/docs/microsoft-entr.md)
* [JumpCloud](https://docs.scalr.io/scalr/docs/jumpcloud.md)
* [Google Workspace](https://docs.scalr.io/scalr/docs/google-workspace.md)