SCIM Provisioning

The short version

  • SCIM provisioning lets your identity provider (IdP) add people to Delivr, set their roles, and remove them when they leave.
  • When you unassign a person in your IdP, they lose access in Delivr and are signed out. Nobody has to open Delivr.
  • Setup takes about five minutes. Copy a SCIM URL and a token from Delivr into your IdP, then assign people.
  • Step-by-step guides: Okta and Microsoft Entra ID.

Before you start

  • Your organization needs an active single sign-on (SSO) connection. The connection must be on an email domain that you verified.
  • Only people whose email address is in that domain are provisioned. Delivr ignores any other address that your IdP sends.
  • You must be able to edit organization settings in Delivr.

Set up provisioning in Delivr

  1. Open Settings > Security. Find your connection in the Single sign-on list.
  2. Select Set up provisioning. The Provisioning panel opens.
  3. Check Identity provider, then select Set up provisioning again.
  4. Copy the SCIM URL and the SCIM token. Delivr shows the token one time. If you lose it, select Replace token.
  5. Paste both values into your IdP. Use the guide for Okta or Microsoft Entra ID.

The SCIM URL has the form https://api.delivr.ai/api/v1/scim/v2/<directory-id>. Use the URL exactly as the panel shows it.

If the connection is not active, Set up provisioning is disabled. Turn the connection on first.

Choose who gets access

Provisioning gives no access until a rule says what access to give. Rules are in the Access section of the panel.

  1. Select Add rule.
  2. In Who, choose Everyone assigned in your IdP, or one IdP group.
  3. In Where, choose This organization or A project. If you choose a project, select it in Project.
  4. In Role, choose a role. You cannot choose Owner.
  5. Select Save rule.

If your domain already has a join policy, the panel starts with one rule for everyone assigned. Confirm it or change it.

If a person matches more than one rule at the same place, they get the highest role. Rules at different places all apply.

If you use group rules, your IdP must push the groups to Delivr. Delivr lists a group only after your IdP pushes it.

What your IdP controls

  • Adding people: a person assigned in your IdP gets a Delivr account and the access that your rules give.
  • Removing people: if your IdP deactivates or deletes a person, Delivr deactivates their access and signs them out. Delivr keeps the account and the history. If you assign the person again, their access returns.
  • Owners: rules never give the Owner role, and your IdP never removes the last active owner. Delivr keeps that owner active and shows Your last owner was kept active. Add another owner in Members.
  • Members your IdP never pushes: they stay as they are. Delivr does not manage them.
  • Editing in Delivr: you cannot edit the access of a person that your IdP manages. Delivr answers with a message such as "Okta manages this person's access. Change it in Okta." Change it in your IdP.

Welcome email

Delivr emails each person once, when your IdP first gives them access. The email is on by default. To turn it off, use Email people when they first get access in the Settings section of the panel.

How fast changes apply

Delivr applies a change when your IdP sends it. Every 15 minutes, a scheduled check compares Delivr with your IdP and corrects any change that Delivr missed. How often your IdP sends changes depends on the IdP. Microsoft Entra ID syncs about every 40 minutes.

Safety limit for removals

Suppose one scheduled check finds that people are missing from your IdP. If the count is more than 10, and more than 10% of your provisioned people, Delivr keeps their access. This protects you if someone recreates or misconfigures the IdP app.

The panel shows Removals are on hold, and Delivr emails your organization's owners. Check who is assigned in your IdP. If the list is right, select Apply removals.

Manage the token

  • Replace token issues a new token. The old token keeps working for 7 days, so your IdP does not stop while you paste the new one.
  • Last used shows when the IdP last called Delivr. Check it before you revoke the old token.
  • Revoke old token ends the old token at once.

Pause provisioning

Select Pause provisioning to stop Delivr from applying changes. People keep the access they have when you pause. While provisioning is paused, Delivr refuses the changes your IdP sends, and the IdP reports them as errors.

After you select Resume provisioning, retry the failed provisioning in your IdP so that it sends those changes again. The scheduled check corrects only the changes Delivr received, so it does not replace this retry. Then check that people who left show as Deactivated.

Check status

The Status section shows when your IdP last sent a change and when the last scheduled check ran. It also shows the number of people in each state. The Activity list shows recent changes and their results. A person with an address outside your domain shows as Ignored, outside the domain.

Not supported

Delivr supports Okta, Microsoft Entra ID, OneLogin, JumpCloud, and other SCIM 2.0 providers. Google Workspace is not supported.


Did this page help you?