Available on: Enterprise plan
Set up by: Company-level admin
The guide provides steps to configure provisioning for Miro Enterprise accounts. For available functionality, rules that Miro SCIM follows and possible issues and how to resolve them please first see here.
In this article:
Prerequisites
The Miro SCIM API is used by SSO partners to help provision, manage users and teams (groups). SAML based SSO must be properly set up and be functional in your Miro Enterprise account before you start configuring automated provisioning. The instructions on how to set up SSO can be found here.
Setting up Provisioning
Once the application is created during SSO configuration, you will see its settings:
- Choose the Provisioning item on the left panel and then change Provisioning Mode from Manual to Automatic:
- Provide Admin Credentials:
a) Use https://miro.com/api/v1/scim/ as Tenant URL
b) Provide the Secret Token. You can obtain it from the SSO section of your Miro settings like so:
c) Click Test Connection button right below the Secret Key edit box.
If the connection passes the test, you will get the following notification:
If there is no confirmation, double-check the Tenant URL and make sure that it is not blocked by firewalls and any other traffic interceptors inside your network, as well as make sure the API Token is correct. - Save the configuration:
Mappings
Miro SCIM API makes use of a part of metadata Azure AD attaches to users and groups. This section explains the required mappings between Miro SCIM API and Azure AD attributes.
Users
- Choose the Provisioning tab on the left side, then click Synchronize Azure Active Directory Users to Miro:
- Default mappings are expected to be enough. However, double-check that synchronization is enabled for users and all required methods (Create, Update, Delete) are ON:
| Azure AD attribute | Miro Attribute |
|---|---|
| userPrincipalName | |
| displayName;
formated; givenName + " " + familyName; userName |
Full name |
Please note that Miro will recognize Azure users by their UPNs. This means that for successful authentication in Miro UPN must remain the same as it was when the user was originally provisioned to Miro otherwise the connection between Azure and Miro in regards to this user will break (Azure will fail to push updates about this user). If you need to update the attribute, please reach out to Miro support for assistance so we first update user data on our side.
Groups
- Choose the Provisioning tab on the left, then click Synchronize Azure Active Directory Groups to Miro.
- Default mappings are expected to be enough. Check that synchronization is enabled for groups and uncheck Create and Delete methods - note that Miro SCIM API does not support creating and deleting teams.
- Click Save.
User and Group Assignments
Miro SCIM Provisioning can help you to provision and de-provision users to your Enterprise account, as well as to automatically distribute them across teams. Users or Groups from Azure Active Directory should be assigned to Miro SCIM Provisioner application to be automatically managed in Miro. To assign users and groups to the application, follow the steps below.
We recommend provision users through assigning groups. In that case, when user is removed from all assigned groups in Azure AD, the same user will be removed from all teams in Miro (note that they will still stay a member of the Enterprise account). To deactivate a user in your Enterprise account, deactivate them in Azure AD, which will send a corresponding request to Miro. To delete a user from Miro, use the Active Users page in Miro.
- Choose Provisioning tab on the left. In the Settings section make sure the scope is set to the one you expect to be synced with Miro. We suggest using "Sync only assigned users and groups".
- Choose User and groups tabs on the left panel, then click Add user:
- On the Add assignment screen, choose Users and groups tab, then select users and groups from the list. NOTE: Miro SCIM API does not create new teams in Miro. Please see the SCIM features list here.
- Click Select, then Assign buttons.
- Assigned users and groups will appear in the list.
Enabling and disabling provisioning
When the initial set up is complete, switch Provisioning Status toggle to enable the provisioning.
- Choose Provisioning tab on the left.
- Click On option on the Provisioning Status toggle.
- Hit Save. This will start the initial provisioning that might take some time. Go back in about 20 minutes and check the bottom of the page for the status.
Whenever needed, choose the Off option to disable the provisioning. Note that Azure updates the data intermittently so if you need an urgent update, Stop the provisioning and then Start again. Resync will be immediate and will also carry with it the updates.