> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# SCIM (User Provisioning)

> Automate the user lifecycle in anny with SCIM: provision, update, and deactivate accounts straight from your identity provider.

SCIM, System for Cross-domain Identity Management, is an open standard that lets you automate user lifecycle management in cloud-based applications and services. In this article, we explain how to set up a SCIM integration with anny.

## Who is this feature for?

This feature is primarily aimed at IT admins. It is especially helpful for:

* Automatically creating new employees before they log in for the first time.
* Instantly revoking booking rights when someone leaves the company.
* Centrally managing and synchronizing profile attributes (such as departments or locations) directly from the IdP.

SCIM is ideal for organizations that want to completely eliminate manual account maintenance in anny and establish a "single source of truth".

## What changes with SCIM?

* **From an admin perspective:** You no longer need to manually create, edit, or deactivate anny accounts. anny automatically mirrors the status of your IdP.
* **From a customer perspective:** Users don't notice the change. They still log in via SSO (SAML), but their profile in anny is always up to date.

<Warning>
  **Important:** As soon as SCIM is active, user attributes (such as name, department, or role) are transferred *exclusively* via SCIM. The existing attribute mapping via the regular SSO login (SAML) is ignored by anny from that moment on, since SCIM acts as the sole data source.
</Warning>

## Where do you find the feature in anny?

You find the configuration under **Account settings** > **SSO & Security**. Requirements:

* You have admin access in anny.
* You have admin access to your identity provider (e.g. Microsoft Entra).
* The anny application already exists in your IdP for the SSO login.

![SSO & Security overview](https://downloads.intercomcdn.eu/i/o/niegcmk9/135498013/746e0bfaebb3e13656f07e9ccc7a/generalsso.png?expires=1784851200\&signature=88a3522d0d6cd269e2870a7c02265e996b98debbe64cc9bdd5914985c7a6bd41\&req=0dZqwVHyrDYrlxv2%2BtxgpiWdkbWYJe%2FUkPzISax6atMagRJ3wjDcjRqo5V7%2B%0ALwvWi1GbNGhJTovnw0PS45lPJw%3D%3D%0A)

<Warning>
  **Important:** For security reasons, the SCIM token is shown to you in anny only once. Copy it right away and enter it in your system immediately.
</Warning>

## How the logic works

* Your identity provider monitors changes to the assigned users (e.g. new department, account lock).
* When a change occurs, the IdP sends this info to anny's SCIM interface over an invisible channel (backchannel).
* anny validates the request using the secret token.
* The profile in anny is updated immediately, completely independent of whether the person is currently logged in.

Through this continuous background process, both systems always have the same data.

## Setting up SCIM with a generic IdP (e.g. Okta, Google)

The principle is nearly identical across almost all providers, even if the menus have different names.

<Steps>
  <Step title="Copy URL and token">
    In anny, go to **SSO & Security** > **SCIM** and copy the URL and token.
  </Step>

  <Step title="Open the provisioning menu">
    Open the provisioning menu in your IdP application (often called "API Integration" or "App Provisioning").
  </Step>

  <Step title="Insert credentials">
    Insert the tenant URL as the "Base URL" and the token as the "API Token" (or Bearer Token).
  </Step>

  <Step title="Test the connection">
    Test the connection and start the sync cycle.
  </Step>
</Steps>

*Result:* Even external or less common systems now communicate seamlessly with the anny user database.

## Setting up SCIM in Microsoft Entra

With these instructions, you set up SCIM so that Microsoft Entra automatically provisions your users for anny.

<Steps>
  <Step title="Open SCIM in anny">
    In anny, open **Account settings** > **SSO & Security** and select **SCIM**.
  </Step>

  <Step title="Copy tenant URL and token">
    Copy the **tenant URL** and the **token**.
  </Step>

  <Step title="Open the anny application in Entra">
    In Microsoft Entra, open the existing anny application for which you want to set up provisioning.

    ![anny application in Microsoft Entra](https://downloads.intercomcdn.eu/i/o/niegcmk9/135499866/5617750dba9e30465ec5fd89fcb2/scim3.png?expires=1784851200\&signature=85bda47e2c58a413f5b4471e2f18299a5ea7736e4b8c32ada7d2281eed517d3c\&req=0dZqwVHzpDEulxv2%2Btxgpq3QJOuAsNa6wSFg%2BX7sENaKUEBwDxNOs5UiJJCN%0AYJiV3dqaqy8P43G7PHN5rJv8Sw%3D%3D%0A)
  </Step>

  <Step title="Configure provisioning">
    Go to the **Provisioning** area and start a new configuration there (or select the existing one).
  </Step>

  <Step title="Enter credentials">
    Enter the copied **tenant URL** into the field of the same name and insert the **token** into the **Secret Token** field.

    ![Insert tenant URL and token](https://downloads.intercomcdn.eu/i/o/niegcmk9/135498982/eb8a9e78dab0fe6259bcf3628d8d/scim1.png?expires=1784851200\&signature=4d065e0a291bbb57010928d288a301294576eb41ef222a4c3b51ccbfb3b33110\&req=0dZqwVHypT8qlxv2%2BtxgpibUAYPUFEutS0tRKGhZavxJOaggnAKJWa%2FcErgH%0A4fraGRRuHqd%2FSi6D1xPDTPINdA%3D%3D%0A)
  </Step>

  <Step title="Test the connection">
    Click **Test Connection** to check whether Entra can reach anny's SCIM interface.
  </Step>

  <Step title="Save the configuration">
    Save the configuration once the test is successful.
  </Step>

  <Step title="Start provisioning">
    Then activate provisioning via the **Start provisioning** button.

    <img src="https://mintcdn.com/anny-85c98540/WI0eDTofsGdW2lVL/images/image-2.png?fit=max&auto=format&n=WI0eDTofsGdW2lVL&q=85&s=dfde7439c3bd1c70db7339534a8fdb2a" alt="Image" width="2072" height="1166" data-path="images/image-2.png" />
  </Step>
</Steps>

Microsoft Entra now provisions users via SCIM.

<Note>
  **Note:** Provisioning takes some time. Plan for some waiting time before you check the result in anny.
</Note>
