Skip to main content

SCIM with Microsoft Entra

This guide walks you through setting up SCIM (System for Cross-domain Identity Management) provisioning with Microsoft Entra ID for your Swimm workspace.

Prerequisites​

Before you begin, ensure you have:

  • Admin access to your Microsoft Entra ID tenant
  • Admin access to your Swimm workspace
  • The SCIM tenant URL and secret token provided by Swimm

Setup Steps​

1. Navigate to Microsoft Entra ID​

In the Azure portal, go to Microsoft Entra ID from the main navigation menu.

Navigate to Microsoft Entra ID

2. Access Enterprise Applications​

From the Microsoft Entra ID overview page, navigate to Enterprise applications under the Manage section.

Select Enterprise applications

3. Create a New Enterprise Application​

Click New application to create a new enterprise application for Swimm SCIM integration.

Create new Enterprise application

4. Configure Provisioning Settings​

Navigate to the Provisioning section of your newly created application and enter the following details:

  • Tenant URL: https://mycompany-swimm.io/api/scim
  • Secret Token: The token

Both are provided by your Swimm workspace administrator.

Click Test Connection to verify the configuration.

Configure provisioning with tenant URL and secret token

5. Enable Provisioning​

Once the test connection is successful:

  1. Set the Provisioning Mode to Automatic
  2. Configure your Mappings and Settings as needed
  3. Set the Provisioning Status to On
  4. Click Save to apply your changes
Enable provisioning

Next Steps​

After enabling provisioning:

  • Users and groups assigned to this enterprise application will be automatically provisioned to your Swimm workspace
  • User lifecycle changes (additions, updates, deactivations) will be automatically synchronized
  • You can monitor provisioning activity in the Provisioning logs section

Troubleshooting​

If you encounter issues:

  • Verify that the tenant URL and secret token are correct
  • Check that the enterprise application is assigned to the appropriate users and groups
  • Review the provisioning logs for detailed error messages
  • Ensure your Swimm workspace has SCIM provisioning enabled

This document is automatically kept up to date using Swimm.