Okta SCIM Org Roles

Update Okta User Org Role

For every user, Statsig surfaces a SCIM field named statsigOrgRole. Through this field, you can manage organization user roles. Currently, Okta can only push role updates to Statsig.

Step 1. Create the Custom Attribute in Okta

Navigate to Directory > Profile Editor and select the User (default) Okta profile. This represents all of the Okta users’ attributes. Scroll down and press Add Attribute and fill out the new attribute to have the variable name statsigOrgRole.

Step 2. Create the Custom Attribute in the Statsig SCIM Integration

Now Navigate to the Statsig SCIM Integration's User Profile in the Profile Editor. Add an new attribute that matches the following format:

• Variable name: statsigOrgRole
• External namespace: urn:ietf:params:scim:schemas:core:2.0:User

Step 3. Create a Mapping from Statsig to Okta for the Custom Attribute

On the same Statsig SCIM profile editor, navigate to the Mappings button. Scroll down to the new attribute statsigOrgRole and map user.statsigOrgRole to the Okta attribute statsigOrgRole.

Step 4. Create a mapping from Okta to Statsig for the Custom Attribute

Now navigate to the Okta User to Statsig SCIM user mapping.

Scroll down to the statsigOrgRole attribute and map user.statsigOrgRole to the Okta attribute statsigOrgRole.

Now all users will be synced with their organization role. On the Statsig SCIM integration you can modify a user’s role directly as well.

Step 5. Modify Integration Mappings

Navigate to the Statsig SCIM integration provisioning section. Under the “To App” tab, scroll down to the statsigOrgRole attribute.

Set the attribute value to Map from Okta Profile and statsigOrgRole. Set apply on Create and update.

Navigate to the “To Okta” tab and scroll down to the statsigOrgRole attribute.

Set the attribute value to Map from Statsig Profile and statsigOrgRole. Set apply on Create.