SCIM Provisioning with Okta

The short version

After this setup, assigning a person in Okta gives them Delivr access, and unassigning them removes it. You need the SCIM URL and token from Delivr. See SCIM Provisioning for how to get them and for the prerequisites.

Okta can add SCIM provisioning only to an app integration that has SSO. Use the Okta app integration that you already use for Delivr sign-in. If Provisioning has no SCIM option, ask Okta support to enable it. Okta does not support SCIM on OpenID Connect integrations that were created in the Classic experience.

Steps in Okta

  1. In the Okta Admin Console, open your Delivr app integration. Select the General tab.
  2. In App Settings, select Edit. Set Provisioning to SCIM, then select Save.
  3. Select the Provisioning tab. Under Settings > Integration, select Edit.
  4. In SCIM connector base URL, paste the SCIM URL from Delivr.
  5. Set the field name of the unique identifier for users to userName.
  6. Under Supported provisioning actions, select Push New Users and Push Profile Updates. Select Push Groups if you use group rules in Delivr.
  7. Set Authentication Mode to HTTP Header. Paste the Delivr token into the Authorization field.
  8. Select Save.

Send the email address as userName

Delivr finds a person by the email address, and it looks a person up by userName. Set userName to the person's email address. Okta sends the Okta username as userName by default, so check the userName mapping on the To App page if your Okta usernames are not email addresses. Only addresses in your verified domain are provisioned.

Turn on the provisioning actions

  1. In Provisioning > Settings > To App, select Edit.
  2. Enable Create Users, Update User Attributes, and Deactivate Users.
  3. Select Save.

Assign people and groups

  1. Open the Assignments tab. Assign the people or groups that need Delivr.
  2. If you use group rules, open the Push Groups tab and push each group. Use a different group for push than for assignment, because Okta does not support one group for both. Assign every member of a pushed group to the app too.
  3. In Delivr, open Settings > Security, then Manage provisioning. Check that Last used has a time and that the people show as Active.

Troubleshooting

  • No one gets access: the panel needs at least one rule. See Choose who gets access.
  • A person shows Ignored, outside the domain: their email address is not in the verified domain of the SSO connection.
  • Okta reports an authorization error: the token is wrong or replaced. Copy the current token, or select Replace token in Delivr and paste the new one.
  • A group is missing in Delivr: push the group again from the Push Groups tab.

Vendor documentation


Did this page help you?