---
updatedAt: 2025-09-02T23:14:20.000Z
agentTools:
  projectIndex: https://docs.doppler.com/llms.txt
---

# Okta SCIM

Configure Okta to automatically provision users in Doppler using SCIM.

This guide will show you how to set up an Okta SCIM 2.0 application to automatically provision and manage user access to Doppler.

## Requirements

* [Enterprise subscription](https://doppler.com/pricing)
* Domain Verified ([Settings page](https://dashboard.doppler.com/workplace/settings#verified-domains))
* Okta Developer Account
* [Okta SAML application for Doppler](https://docs.doppler.com/docs/okta-saml)

## Enable SCIM in Doppler

In a separate tab, browse to your Doppler workplace. Click on the **Team** link in the left navigation menu and then click on the **SSO** tab.

<Image align="center" width="80%" src="https://files.readme.io/6e319dccdb937beaf9c12ebaccdd3a58f005355663dee69cb8910aac918b7b2b-JumpCloud_SCIM-4.png" />

Scroll down to the **SCIM 2.0** section, choose **Enabled** from the status dropdown menu, and then click **Save**.

<Image align="center" width="80%" src="https://files.readme.io/90a2175d69235b78d73afe4e6155cc96749455253d70a4e2658a0060f47b9702-JumpCloud_SCIM-5.png" />

After doing so, a new **Base URI** and **Authentication** option will appear. These will both be used in the next section to further configure Okta SCIM provisioning.

## Enable Okta SCIM Provisioning

> 📘
>
> This guide assumes you've already setup an [Okta SAML application for Doppler](https://docs.doppler.com/docs/okta-saml). If you haven't, please follow that link and create one before continuing.

In your existing [Okta SAML application](https://docs.doppler.com/docs/okta-saml), browse to the **General** and click the **Edit** link in the top right corner of the **App Settings** section, then check the **Enable SCIM provisioning** box and click **Save**.

<Image align="center" width="80%" src="https://files.readme.io/1d5e42f5644b7aa3d0e505d95578e34eba3f3416e20bc995c5cd747b56204888-Okta_SCIM.png" />

## Configure Okta Provisioning Integration Settings

Back on the **Provisioning** tab in your Okta application's settings page, click on the **Integration** option under **Settings** on the left side of the page, and then click the **Edit** link on the top right corner under **SCIM Connection**.

<Image align="center" width="80%" src="https://files.readme.io/bdf85a1a2ef5c8c0f33824d29bd8aff8bf3a2bfd6eb17ad02838918d962d04c9-Okta_SCIM-1.png" />

Next, switch back to your Doppler browser tab and copy the contents of the **Base URI** field by clicking the clipboard icon next to it.

<Image align="center" width="80%" src="https://files.readme.io/98fa264ab27c755e3964522e7bbc2959df4b9aef8c06c9b15267cb50af981208-Okta_SCIM-2.png" />

Swap back to your Okta browser tab and paste that into the **SCIM connector base URL** field. Next, set the value of the **Unique identifier field for users** field to `email` and check the **Push New Users**, **Push Profile Updates**, and **Push Groups** checkboxes.

<Image align="center" width="80%" src="https://files.readme.io/0f2f79702c00e1448848c77cc41601c053ee7e939d92e0346ba7785e5b33fe31-Okta_SCIM-4.png" />

Swap back to your Doppler browser tab and click on the **Manage** link next to the **Authentication** option.

<Image align="center" width="80%" src="https://files.readme.io/e224d1bfd8e511776666d0c7e87804dbe7bbf28c463ee3720c39ab50cc91c816-Okta_SCIM-3.png" />

> ❗️
>
> The next step involves rolling your SCIM token. If you're setting up SCIM for the first time, it's fine to proceed with this operation. However, if you had already setup SCIM previously keep in mind that performing a roll will **invalidate** the old token, so any existing SCIM setup using that token will **stop working** until it's updated with the new token.

This will open up a new browser tab that takes you to the SCIM section of the Tokens page of your Doppler workplace. Once there, click on the **Roll** link.

<Image align="center" width="80%" src="https://files.readme.io/fa4ed90f1ce1044a503fe30635f768ac2788799965595c6e7161b028b66feab8-Okta_SCIM-5.png" />

This will open up a new dialog containing the new token. Copy the token by clicking on the clipboard icon next to it.

<Image align="center" width="60% " src="https://files.readme.io/f501cf52f9caaa245c6c4d2cb8441cc5305e2165672767885a5e0551f58e704f-JumpCloud_SCIM-6.png" />

Swap back to your Okta browser tab and choose **HTTP Header** from the **Authentication Mode** dropdown menu. Next, paste the SCIM access token you just copied into the **Authorization** field under the **HTTP Header** section, then click Save.

<Image align="center" width="80% " src="https://files.readme.io/d73c4fef1c3d2bd6e4c6e7ff1cba185b215b6ceb67e0e65e4dedadddf888b9f4-Okta_SCIM-6.png" />

## Configure Okta Provisioning to App Settings

Browse to the **Provisioning** tab and click on the **To App** option under **Settings** on the left side of the page, then click the **Edit** link in the top right corner under **Provisioning To App**. Next, check the **Enable** box next to **Create Users**, **Update User Attributes**, and **Deactivate Users**, then click **Save**.

<Image align="center" width="80%" src="https://files.readme.io/c7111cfbe56704e1dde37e4a26b78122026c044288809a51b42f852b45df9746-Okta_SCIM-7.png" />

## Configure Okta Push Groups

> 🚧
>
> It's assumed that you've already configured Okta application assignments when setting up the initial SAML application. If you haven't already done so, make sure you do that before proceeding with this step.

This is where you configure Okta to push groups of users you have setup in Okta into Doppler. As an example, you might have a Doppler Engineers group in Okta. Setting that up as a push group will create a Doppler Engineers group in Doppler with the same users as members.

Click on the **Push Groups** tab and then click the **+ Push Groups** button. Choose **Find groups by name** from the dropdown menu.

<Image align="center" width="80%" src="https://files.readme.io/c77734fd3a0db69b70ec15139b608adf9a10472055c4f8441e8649b4324c6e82-Okta_SCIM-8.png" />

Search for a group you want to add and choose it from the dropdown menu.

<Image align="center" width="80%" src="https://files.readme.io/72ece6a71d24eda72b76e23e43650e9702ac00eb8469cdd7fa82ca8ec2abcc1f-Okta_SCIM-9.png" />

After adding the group, make sure you have Create Group selected in the **Match result & push action** column and then click either **Save** or **Save & Add Another** depending upon whether you have more groups to add or not.

> 🚧
>
> When setting this up, we assume you've not created any groups in your Doppler workplace prior to enabling SCIM. If you had and the name matches one you're trying to add from Okta, change the **Create Group** option to **Link Group** instead. Generally, we recommend setting this up without any pre-existing groups in Doppler though.

<Image align="center" src="https://files.readme.io/de021248072ac479af92cd9393e23ff7219a0a093a5a461e8c673c1cd52ba5e6-Okta_SCIM-10.png" />

After saving, the group will be pushed immediately and you should be able to see the Group and Users in Doppler once the push completes.

Now, whenever new users are added, updated, or deactivated in Okta, Doppler will receive the relevant API call to sync changes to its user records.

> 👍 Awesome Work!
>
> You've now set up an Okta SCIM 2.0 application to automatically provision and manage user access to Doppler.