Prerequisites
Before you configure provisioning for ScreenSteps in Okta, make sure that you have configured your Single Sign-On options in ScreenSteps.
The following provisioning features are supported:
-
Push New Users
- New users created through OKTA will also be created in the third party application.
- The default
timezone
for new users will be the account time zone (set in your ScreenSteps account settings). - The default
User type
will be set toreader
if no User type is set.
-
Push Profile Updates
- Updates made to the user's profile through OKTA will be pushed to the third party application.
-
Push User Deactivation
- Deactivating the user or disabling the user's access to the application through OKTA will deactivate the user in the third party application.
-
Push Groups
- Groups and their members can be pushed to remote systems.
-
Reactivate Users
- User accounts can be reactivated in the application.
If you enter an incorrect User type in Okta the error message you will receive will not be very specific. It may only say:
Bad Request: Errors reported by remove server.
If you see this error, please make sure that you have set the User type to one of:
- admin
- editor
- reader
Configuration Steps
Search for ScreenSteps in the App directory and select Add.
Enter your ScreenSteps account name (from your ScreenSteps URL) in the Site Name field and then select Done.
Get your ScreenSteps API Token and SCIM URL
View how to generate a ScreenSteps API Token.
Enter Credentials in Okta
- Go to Provisioning in the ScreenSteps App
- Select Configure API Integration
- Select Enabled API Integration
- Enter the ScreenSteps API Token in the OAuth Bearer Token field
- Select Test API Credentials
If the test succeeds then select Save. If it does not succeed then make sure that you copied the correct values from ScreenSteps.
If you set a User Type for a group, then any user that is added to that group will have their role updated in ScreenSteps. Available roles are:
- admin
- editor (labeled as "Contributor" in the ScreenSteps application)
- reader (default)
You may see the "learner" option in Okta, but this role has been deprecated in ScreenSteps.
If a user belongs to more than one group only one role value will be updated in ScreenSteps. The value updated is determined by the priority levels of the groups (see Okta's documentation for more information). The first group a user belongs to is the value that will be updated in ScreenSteps.
Select Directory > Groups
Select Group
Edit App
- Select Applications
- Select the edit icon for the ScreenSteps app
Set the User type
- Enter a value of admin, editor, or reader (Time zone is not required).
- Select Save
Group Push is an Okta feature that lets you push existing Okta groups and their memberships to ScreenSteps. To learn more about this feature please refer to About Group Push in Okta's documentation.
0 Comments
Add your comment