> ## Documentation Index
> Fetch the complete documentation index at: https://hc.saas-manager.biz.nuro.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Configure SCIM

> You need to enable SAML before using SCIM.

### How to configure SCIM

You need to enable SAML before using SCIM. Refer to the [SAML configuration guide](/en/it-management/settings/sni7chcawy-saml) and enable SAML first.

#### Obtain your organization's SCIM credentials

Go to **Settings > Security** and open the **SCIM** section to get the tenant URL and secret token required for your IdP. If no secret token exists, click the generate button.

Each organization can only have one SCIM secret token at a time. Generating a new token immediately invalidates the previous one.

<img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1769741440373-2026-01-30-11-34-39.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=7e3d6e991d2c245181c618cb09cf0b2e" alt="Screenshot" width="1444" height="1182" data-path="images/it-management/msu9u84kyh/1769741440373-2026-01-30-11-34-39.png" />

#### Configure SCIM invitation emails

When provisioning users via SCIM, you can choose whether to send an invitation email to newly added users.

#### Prerequisites

* SAML must be configured and enabled.

* The invitation email toggle appears only after a secret token has been generated.

* This setting applies to users created after SCIM is configured. Invitation emails are not re-sent to already-provisioned users.

#### Configuration steps

1. Go to **Settings > Security > SCIM > Secret token** and click **Regenerate Secret Token**.\
   Note: Regenerating the token invalidates the previous token. If you are already using the token in your IdP, update the token on the IdP side as well.
2. Once the token is generated, an **Invitation email** toggle appears below it.\
   **Do not send:** The user is created without any notification email.\
   **Send:** An invitation email to the service is automatically sent when the user is created.
3. Use the **Invitation email** toggle to choose your preference.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1769743168106-2026-01-30-11-41-29.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=6d132aabaaebc745523294083360d210" alt="Screenshot" width="1428" height="340" data-path="images/it-management/msu9u84kyh/1769743168106-2026-01-30-11-41-29.png" />

### Enable SCIM in your IdP

Open the application you created in your IdP for SAML.

#### Entra ID

Entra ID guide

1. Select **Provisioning** from the side menu and click the **Get Started** button.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1639291924203-screen-shot-2021-03-25-at-15-41-30.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=40182db01e7604cc695119fffddf2be6" alt="Screenshot" width="1610" height="908" data-path="images/it-management/msu9u84kyh/1639291924203-screen-shot-2021-03-25-at-15-41-30.png" />

2. Select **Automatic** mode.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1639291947775-screen-shot-2021-03-25-at-15-42-05.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=e0fd1bd138064dbc5c25330196e45fbc" alt="Screenshot" width="1610" height="913" data-path="images/it-management/msu9u84kyh/1639291947775-screen-shot-2021-03-25-at-15-42-05.png" />

3. Enter the tenant URL and secret token obtained from the service.\
   For **Select authentication method**, choose **Bearer authentication**.\
   Click **Save** in the upper left to save the settings.\
   (When running Test Connection, SAML must be enabled in the service.)

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1768974697996-entra-id-provision-configuratio.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=effa3fc5390f8f5a9d437f494c79df76" alt="Screenshot" width="2582" height="1420" data-path="images/it-management/msu9u84kyh/1768974697996-entra-id-provision-configuratio.png" />

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1768974806336-cs-20260121-005013-2-x.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=658b56377c2973a45e36b2e27e9808e8" alt="Screenshot" width="1036" height="332" data-path="images/it-management/msu9u84kyh/1768974806336-cs-20260121-005013-2-x.png" />

   <Info>
     You do not need to store the secret token elsewhere.\
     You can regenerate it whenever you need a new one.
   </Info>

4. Open **Mappings** and disable group provisioning.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1639291997133-screen-shot-2021-03-30-at-18-00-26.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=afdf2bfd38e39b6fbd4e5c551c44fce4" alt="Screenshot" width="1610" height="913" data-path="images/it-management/msu9u84kyh/1639291997133-screen-shot-2021-03-30-at-18-00-26.png" />

5. Select **Provision Entra ID Users** and configure the **Microsoft Entra ID Attribute** as shown in the image below.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1768975092130-cs-20260121-005014-2-x.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=9d6aa075be5b8bfde42162dc5a8970e6" alt="Screenshot" width="3020" height="1546" data-path="images/it-management/msu9u84kyh/1768975092130-cs-20260121-005014-2-x.png" />

6. Configure the attributes as shown in the image below.\
   Confirm that the **Matching precedence** for `userPrincipalName` is set to `1`.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1639292034349-screen-shot-2021-03-25-at-17-18-58.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=b3308cc1a40dc7db0ad4db063899b3df" alt="Screenshot" width="1610" height="914" data-path="images/it-management/msu9u84kyh/1639292034349-screen-shot-2021-03-25-at-17-18-58.png" />

7. Click **Save** in the upper left again to complete the setup.\
   Users assigned to the application are automatically provisioned to the service.

#### Okta

<Info>
  The service now supports the Okta Integration Network (OIN), which makes configuration easier. See the setup guide here: [SAML/SCIM configuration with Okta Integration Network](/en/it-management/settings/wllb3ml0pq-oin)
</Info>

#### Supported features

| Feature                                     | Description                                                                       |
| ------------------------------------------- | --------------------------------------------------------------------------------- |
| Create new users                            | When a user is created in Okta, a corresponding user is created in the service.   |
| Update user profiles                        | User information updated in Okta is reflected in the service.                     |
| Deactivate (and reactivate) or delete users | Deactivations, reactivations, and deletions in Okta are reflected in the service. |

#### Prerequisites

* You need to enable SAML before using SCIM. Refer to the [SAML configuration guide](/en/it-management/settings/sni7chcawy-saml) and enable SAML in advance.

#### Configuration steps

1. Open your application from **Applications**, go to the **Sign on** tab, and change **Application username format** to **Email**.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1660616034172-image.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=96efa3002e7c38eed7f39bfdb2fc46bc" alt="Screenshot" width="2798" height="1634" data-path="images/it-management/msu9u84kyh/1660616034172-image.png" />

2. On the **General** tab, select **Enable SCIM provisioning** under **Provisioning**.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1660612067340-image.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=365d83d14d9cd831cac552eb7aac97a4" alt="Screenshot" width="2852" height="1640" data-path="images/it-management/msu9u84kyh/1660612067340-image.png" />

3. Open the **Provisioning** tab and enter the following information.

   | Field                               | Value                                                                                                                                 |
   | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
   | `SCIM connector base URL`           | Enter the **Tenant URL** obtained from the service                                                                                    |
   | `Unique identifier field for users` | Enter **userName**                                                                                                                    |
   | `Supported provisioning actions`    | Check the following values:<br />- **Import New Users and Profile Updates**<br />- **Push New Users**<br />- **Push Profile Updates** |
   | `Authentication Mode`               | Select **HTTP Header**                                                                                                                |
   | `Authorization`                     | Enter the **Secret Token** obtained from the service                                                                                  |

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1660615923097-image.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=9179e920d65972438c02082220912e55" alt="Screenshot" width="2624" height="1640" data-path="images/it-management/msu9u84kyh/1660615923097-image.png" />

4. Click **Test Connector Configuration** and confirm that everything succeeds except **Push groups** and **Import groups**.

5. After a successful test, click **Close** and save.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1660612449151-image.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=4912b95a4e6155c5b24cc087beefb5b7" alt="Screenshot" width="856" height="1076" data-path="images/it-management/msu9u84kyh/1660612449151-image.png" />

6. In the **To App** section on the next screen, enable the following:\\

   * Create Users\\
   * Update User Attributes\\
   * Deactivate Users

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1639292106949-screen-shot-2021-04-28-at-17-29-01.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=6cf910b40dfb474c6d8d34612d17628e" alt="Screenshot" width="1610" height="893" data-path="images/it-management/msu9u84kyh/1639292106949-screen-shot-2021-04-28-at-17-29-01.png" />

7. Scroll further down on the same screen to the **Attribute Mappings** section.\
   Match the configuration to the screenshot.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1639292125433-screen-shot-2021-04-28-at-17-30-14.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=ff9f87aa55d48b43ae610e39d7a0e7a1" alt="Screenshot" width="1610" height="895" data-path="images/it-management/msu9u84kyh/1639292125433-screen-shot-2021-04-28-at-17-30-14.png" />

8. This completes the setup.\
   Users assigned to the application are automatically provisioned to the service.

#### Known issues and troubleshooting

<Info>
  The service does not yet support provisioning from the application to Okta. Leave the **To Okta** settings at their default (disabled).
</Info>

#### OneLogin

OneLogin guide

1. Open the **Configuration** page and enter the following values.

   | Field               | Value                                              |
   | ------------------- | -------------------------------------------------- |
   | `SCIM Base URL`     | Enter the `Tenant URL` obtained from the service   |
   | `SCIM Bearer Token` | Enter the `Secret Token` obtained from the service |

2. Click **Enable** to activate. If no errors appear, click **Save**.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1639292193541-screen-shot-2021-04-28-at-18-52-20.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=2ac0b42f6cc69425ffe2d8b3413ef599" alt="Screenshot" width="1610" height="942" data-path="images/it-management/msu9u84kyh/1639292193541-screen-shot-2021-04-28-at-18-52-20.png" />

3. Open the **Provisioning** page.\
   Enable **Enable provisioning**.\
   Optionally, change what happens when a user is deleted in OneLogin.

4. Save the settings.

   <img src="https://mintcdn.com/admina-sbn/KLrPVaxE9MhiOOfJ/images/it-management/msu9u84kyh/1639292216159-screen-shot-2021-04-28-at-18-58-22.png?fit=max&auto=format&n=KLrPVaxE9MhiOOfJ&q=85&s=093448cf4fae7377610ece8375370aa3" alt="Screenshot" width="1610" height="942" data-path="images/it-management/msu9u84kyh/1639292216159-screen-shot-2021-04-28-at-18-58-22.png" />

5. This completes the setup.\
   Users assigned to the application are automatically provisioned to the service.
