Step 0: Prerequisites
Expected you have already created an application for StoryChief inside Okta.
Step 1: Enable provisioning
Enable SCIM provisioning inside the general settings.
Connector base URL: https://api.storychief.io/scim/v2
Unique identifier field for users: email
Authentication Mode: HTTP Header
Use a Bearer token for authentication (which you can create here)
Step 2: Creating the roles field
Creating users in StoryChief requires them to have a role.
We will be adding a role field to the StoryChief User Profile inside of Okta, so each time a user is assigned to the StoryChief app, you are able to set their role.
Navigate to Directory > Profile Editor > StoryChief User
On the Profile Editor, click "Add attribute"
Use the following values
Data type: string
Display name: StoryChief Role
Variable name: storychief_role
External name: roles.^[type=='primary'].value
External namespace: urn:ietf:params:scim:schemas:core:2.0:User
Enum: Yes, Define enumerated list of values
Attribute members: Owner - owner / Admin - admin / Writer -writer / Guest - guest / Client - client
Attribute required: Yes
Attribute type: Personal
Step 3: Mapping
On the StoryChief Profile Editor, choose "Mappings".
Now set the following mapping for Okta User to StoryChief.
We'll set a default value for new users to be "guest". Depending on your use-case you can set any other role here as a default value (or keep it empty).
You might see other possible mappings here, but those you can keep unmapped
Okta | StoryChief |
user.firstName | givenName |
user.lastName | familyName |
user.email | |
"guest" | storychief_role |
