# Add and remove people from Entra ID or Okta (SCIM)

> Let your identity provider add people to a workspace, turn their access off when they leave, and give groups a role.

Source: https://artavolo.com/page/provision-people-scim

With provisioning, the people of a workspace follow your company directory. When someone is assigned to Artavolo in Microsoft Entra ID or Okta, they join the workspace. When they leave or are unassigned, their access is turned off. Groups come over too, and you decide what role each group gives. It uses SCIM 2.0, the standard both providers speak.

## Turn it on in Artavolo

1. Open the workspace's people: **Share** on a base, then the workspace's collaborators (you need to be an owner of the workspace).
2. Under **Provisioning from Entra ID or Okta**, choose what new people join as (**Read only** or **Contributor**) and click **Turn on**.
3. Copy the **SCIM address** and the **token**. The token is shown once; if you lose it, click **Make a new token** (the old one stops working).

## Microsoft Entra ID

1. In the Entra admin center, open **Enterprise applications**, click **New application**, then **Create your own application**. Name it Artavolo and choose *Integrate any other application you don't find in the gallery*.
2. In the new application, open **Provisioning** and set the mode to **Automatic**.
3. Paste the SCIM address as the **Tenant URL** and the token as the **Secret token**, click **Test Connection**, then **Save**.
4. Under **Users and groups**, assign the people and groups who should be in the workspace.
5. Back in Provisioning, set the status to **On**. Entra sends changes about every 40 minutes; **Provision on demand** sends one person at once.

## Okta

1. In the Okta Admin Console, create an app integration for Artavolo (or open the one you use for sign-in). On its **General** tab, set **Provisioning** to **SCIM**.
2. On the **Provisioning** tab, under **Integration**, paste the SCIM address as the **SCIM connector base URL**, use **userName** as the unique identifier, tick *Push New Users*, *Push Profile Updates* and *Push Groups*, choose **HTTP Header** authentication and paste the token. Test, then save.
3. Under **To App**, turn on *Create Users*, *Update User Attributes* and *Deactivate Users*.
4. Assign people and groups on the **Assignments** tab, and choose the groups to send on **Push Groups**.

## Give groups a role

Groups your provider pushes are listed under Provisioning in the workspace's people. Give a group **Contributor** and everyone in it can edit; leave it at **No change** and its members keep the default. A person gets the highest role any of their groups gives.

## What happens to people

- **Someone new** gets an account and an e-mail with a link to choose a password (or they sign in with your single sign-on, where it is set up). Someone who already has an Artavolo account with the same e-mail joins with it.
- **Deactivated or unassigned**: their access to the workspace and its bases is turned off. Their records, comments and history stay, and turning them on again restores the same access.
- **Deleted**: they leave the workspace and its bases. Their account stays, since it may belong to other workspaces.
- **Owners** are never changed by provisioning; make and remove owners in Artavolo. The workspace's last owner is never turned off.
- Names change in Artavolo only for accounts provisioning made. Every change is in the audit log, marked "via SCIM".

The people list marks who comes from your identity provider. Turning provisioning off stops the token; the people it added stay.

## Related

- [Share a base and invite people](https://artavolo.com/page/collaboration-guide)
- [Roles and permissions: who sees what](https://artavolo.com/page/who-sees-what)
- [Set up single sign-on](https://artavolo.com/page/single-sign-on)
