User provisioning is available to Enterprise customers, the same as SSO. Email contact@meshapi.ai to turn it on for your organization.
Before you start
You need:- SSO set up, with your email domain verified. Provisioning only creates people on that domain or its subdomains. See Single Sign-On.
- An owner or admin role in the Mesh organization. Custom roles and admin keys cannot set up provisioning.
- Admin access to your Okta org.
Set up provisioning
Okta cannot provision through the OIDC app you created for SSO, so provisioning uses a second app from Okta’s catalog. People keep signing in through the first one. Mesh matches the two by email.1
Create a provisioning token in Mesh
- In the Dashboard, go to Settings → Single sign-on. Below your identity provider, find User provisioning (SCIM) and click Set up provisioning.
- Copy both values from the yellow box:
- SCIM base URL:
https://auth.meshapi.ai/api/auth/scim/v2 - Token
- SCIM base URL:
2
Add the SCIM app in Okta
- In the Okta Admin Console, go to Applications → Applications → Browse App Catalog.
- Search for SCIM 2.0 Test App (Header Auth) and click Add Integration.
- Name it
Mesh SCIM. Under Application visibility, tick Do not display application icon to users: people sign in through your SSO app, not this one. - Click Done.
3
Connect it to Mesh
- Open the Mesh SCIM app → Provisioning → Configure API Integration, and tick Enable API integration.
-
Fill in:
- Click Test API Credentials, then Save.
4
Turn on the provisioning actions
- Still on Provisioning, choose To App and click Edit.
- Tick Create Users, Update User Attributes, and Deactivate Users. Leave Sync Password off; Mesh has no passwords.
- Click Save.
5
Assign people
On the Mesh SCIM app’s Assignments tab, assign the same people or groups as your SSO app. Each one appears under Settings → People in Mesh within seconds.Assigning a group to both apps keeps sign-in and membership in step.
Map Okta groups to roles
By default everyone Okta provisions is a Member. To make the people in an Okta group Admins:1
Push the group from Okta
On the Mesh SCIM app, open Push Groups → Push Groups → Find groups by name, pick the group, and click Save.
2
Map it in Mesh
- Under Settings → Single sign-on → User provisioning (SCIM) → Group roles, click Add group.
- Pick the group by name and choose Admin.
- Click Save.
- Someone in no mapped group is a Member. Taking them out of the group demotes them.
- The highest role wins when someone is in several mapped groups.
- Renaming the group in Okta changes nothing. The map follows the group, not its name.
- Provisioning only moves people between Admin and Member. It never changes an owner’s or a viewer’s role; set those in Mesh. A viewer Okta unassigns still leaves.
- A manual role change can be overwritten. If you make someone an Admin in Mesh but no mapped group says so, the next sync makes them a Member again. Use a group instead.
What each change does
Some changes are deliberately one-way:
- The organization owner is never removed or re-roled, whatever Okta sends.
- Removing someone in Mesh sticks. If you remove a member under Settings → People, provisioning does not re-add them, even while Okta still assigns them.
- Access ends within 15 minutes. Suspended API keys stop at once. A Dashboard session they already hold keeps working until its current token expires, at most 15 minutes, and they cannot get a new one.
Manage the connection
Everything below is on Settings → Single sign-on → User provisioning (SCIM), and needs a signed-in owner or admin. Anyone who can read your org’s settings can see the card.See what is set up
The card shows the SCIM base URL, each token with its expiry and when Okta last used it, and the Group roles map. Tokens themselves are never shown again after you copy them.Replace a token
1
Create the new token
Click New token and copy it from the yellow box. The old token keeps working.
2
Put it in Okta
In the Mesh SCIM app → Provisioning → Integration → Edit, replace the API Token with
Bearer followed by the new token. Click Test API Credentials, then Save.3
Revoke the old token
Back on the card, click Revoke next to the old token.
Revoke a token
Click Revoke next to it. It stops working at once, and Okta’s next push fails until it has a working token.Change the group map
Under Group roles, change a group’s role or click the delete icon next to it, then Save. The change applies to existing members straight away.Turn off provisioning
Click Turn off provisioning and confirm. Okta can no longer add or remove anyone, and the people it added stay members. To turn it back on, click Set up provisioning again and give Okta the new token.Read the setup with an admin key
Read the setup with an admin key
An admin key holding
org:read can read the same setup the card shows, for audits or monitoring. It cannot change anything.Troubleshooting
Okta’s Reports → System Log and the Mesh SCIM app’s push status show why a change did not arrive.Related
Single Sign-On (Okta)
Set up sign-in with Okta first.
Organizations & Teams
Roles, and what happens to keys when someone leaves.