Create users automatically from Microsoft Entra (SCIM)
ℹ️ With user provisioning, you can automatically add and remove users in PinToMind without having to invite or manage them manually.
User access is managed through your identity provider, such as Microsoft Entra, and automatically synchronised with PinToMind using the SCIM standard.
GO TO:
Before you start
- The account must have Single Sign-On set up. See Get started with Single Sign-On.
- You must be Account Owner on the account.
- You must be able to manage the PinToMind enterprise app in Microsoft Entra.
Turn on user provisioning in PinToMind
-
Go to Account settings → Single Sign-On and select User provisioning (SCIM). You also find the
button on Account settings → Users.
- Select Enable user provisioning.
- You get a Tenant URL and a secret token. Copy both. The token is only shown this one time, so paste it into Entra before you close the page.
- Choose which role new users get under Default role for new users. The default is Editor.
Set up provisioning in Microsoft Entra
The PinToMind app in the Entra gallery currently supports Single Sign-On only. If you open Provisioning in that app, you get the message "Out of the box automatic provisioning … is not supported". That's why you set up provisioning in a separate app. Single Sign-On keeps working as before through the app you already have.
- Go to Entra admin center → Enterprise applications and choose New application → Create your own application.
- Give the app a name, for example "PinToMind user provisioning". Choose Integrate any other application you don't find in the gallery (Non-gallery), then Create.
- Open the new app, choose Provisioning and set Provisioning Mode to Automatic.
- Under Admin Credentials, paste the Tenant URL and the secret key (Secret Token) from PinToMind.
- Choose Test Connection to check that Entra can reach PinToMind, then save.
- Open Mappings and turn off Provision Microsoft Entra ID Groups. PinToMind syncs users only, not groups.
- Open Provision Microsoft Entra ID Users and check where userName comes from. The default is userPrincipalName. If your usernames are not the same as your email addresses, change it to mail. PinToMind matches users on their email address.
- Go to Users and groups and add the same users or groups that have access to the PinToMind Single Sign-On app.
- Go back to Provisioning and set Provisioning Status to On.
Entra syncs at regular intervals, usually every 40 minutes, so new users can take a while to show up in PinToMind. To test with a single user right away, use Provision on demand in the app.
ℹ️ Make sure both apps have the same users and groups. A user added only to the provisioning app is created in PinToMind but can't sign in with Single Sign-On.
What happens to the users
- New users are added to the account with the default role, and can log in with SSO straight away. They don't need an invitation.
- Users who already exist in PinToMind are linked to the Entra user by email address. They keep the role and access they have.
- If you change a name or email address in Entra, it is updated in PinToMind too. If the user is also on other PinToMind accounts, we don't change the email address, only the name.
- If you remove a user from the app in Entra, or disable the user, the user is removed from the account. The only account owner on an account can't be removed this way.
Users managed by Entra are marked SCIM on Account settings → Users.
You decide the role in PinToMind. Entra only sets the role when the user is created, and never
changes it afterwards. To give a user another role or access to more channels, do it on
Account settings→ Users as usual.
Generate a new token
If the token has gone astray, or you want to replace it for another reason, select New token on
the user provisioning page. The old token stops working immediately, so paste the new one into
Entra under Admin Credentials straight away.
Turn off user provisioning
Select Disable on the user provisioning page. The users stay on the account, but Entra can no
longer create, change or remove them. Remember to turn off provisioning in Entra too, or it will
report errors.
Other identity providers
User provisioning follows the SCIM 2.0 standard, so it can also work with other identity providers
that support SCIM, such as Okta. Use the Tenant URL as the address and the secret token as the
Bearer token. We sync users, not groups.
Questions? Contact us at support@pintomind.com!