User Provisioning (SCIM)
OktaEnterprise
Setting up provisioning to Multi-Router in Okta: the app, the connection, and pushing users and groups.
Okta provisions people to Multi-Router through a SCIM app with header authentication. The app holds the SCIM base URL and directory token from Multi-Router, sends Multi-Router the people assigned to it, and pushes the groups that rules match on. This page covers the Okta side; the Multi-Router side is on Connecting Your Directory.
Adding the app
The app comes from Okta's catalog:
- In the Okta Admin Console, open Applications, then Browse App Catalog.
- Search for SCIM 2.0 Test App (Header Auth), select it, and choose Add Integration.
- Name the app, such as Multi-Router Provisioning, and finish adding it.
Connecting it
The app's Provisioning tab holds the connection to Multi-Router:
- On the app's Provisioning tab, select Configure API Integration and turn on Enable API integration.
- Enter the SCIM base URL from Multi-Router as the Base URL, and the directory token as the API Token.
- Select Test API Credentials. Multi-Router's connection health panel shows Okta's contact.
- Save.
Provisioning features
Under Provisioning, then To App, turn on the features Multi-Router supports:
| Okta feature | Effect in Multi-Router |
|---|---|
| Create Users | Assigned people are added to Multi-Router. |
| Update User Attributes | Changes to a person's name, department and other attributes follow. |
| Deactivate Users | Unassigned or deactivated people are suspended. |
The attributes Multi-Router reads include the username, email, name, title, department, division, organization, cost center and employee number. See SCIM Endpoint.
Assigning people
Okta provisions the people and groups assigned to the app. Assign groups on the Assignments tab, and Okta pushes their members to Multi-Router. Each person then follows the arrival setting and the rules.
Pushing groups
Group rules in Multi-Router match groups that Okta pushes. On the Push Groups tab, push each group a rule should match, such as Engineering. Okta then keeps the group's name and members in step, and Multi-Router re-checks the rules for each member that joins or leaves. Push a group after its members are provisioned, so every member exists in Multi-Router when the group arrives.