Is this article helpful?

Set up Microsoft Entra ID provisioning with SCIM

Use SCIM to automatically provision users and groups from Microsoft Entra ID into ShareFile.

Before you begin

To use ShareFile SCIM provisioning with Microsoft Entra ID, you need:

  • A ShareFile Enterprise account
  • A ShareFile account admin
  • A Microsoft Entra ID admin
  • SCIM enabled in ShareFile (see User Provisioning (SCIM))

IMPORTANT: ShareFile SCIM uses your ShareFile account as the tenant context. The SCIM URL you copy from ShareFile is the value you use in Entra as the Tenant URL.

Step 1: Enable SCIM in ShareFile and copy the connection details

  1. Log in to your ShareFile account.

  2. At the bottom of the left navigation, select Account Settings.

  3. Open User Provisioning.

    User Provisioning in Account Settings

  4. Ensure SCIM is enabled.

  5. Copy the following values:

    • URL — you will enter this as the Tenant URL in Entra ID
    • API Key — you will enter this as the Secret Token in Entra ID

Step 2: Create or open your Microsoft Entra enterprise application

If you already have a ShareFile enterprise application in Entra ID, open it and skip to Step 3.

To create a new non-gallery enterprise application:

  1. Go to the Azure portal.

    Azure portal home page

  2. In the global search bar, search for Enterprise applications and select it.

    Search for Enterprise applications in the Azure portal

  3. Select + New application.

    Enterprise applications list

  4. In the Microsoft Entra App Gallery, select + Create your own application.

    Browse Microsoft Entra App Gallery

  5. Enter a name for the app, select Integrate any other application you don't find in the gallery (Non-gallery), then select Create.

    Create your own application panel

Step 3: Configure SCIM connectivity in Entra ID

  1. Open your ShareFile enterprise application. In the left navigation, select Provisioning.

    ShareFile enterprise application overview

  2. Select Connect your application to create a new provisioning configuration.

    Provisioning landing page

  3. In the Admin credentials section, enter the ShareFile values:

    • Set Authentication method to Bearer authentication
    • Paste the ShareFile URL into Tenant URL
    • Paste the ShareFile API Key into Secret Token

    New provisioning configuration with admin credentials

  4. Select Test connection to verify the credentials.

  5. Select Save to save the configuration.

Step 4: Configure user attribute mappings

ShareFile only uses a subset of the attributes Entra can send. Keep the mappings listed below and remove any that ShareFile does not use.

  1. In the left navigation, select Attribute mapping.

    Attribute mapping overview

  2. Select Provision Microsoft Entra ID Users to open the user attribute mappings.

    User attribute mappings

Supported user mappings

ShareFile SCIM attributeRequiredRecommended Entra sourceNotes
userNameYesuserPrincipalNameUse the same source as the user's primary ShareFile email when possible
activeYesEntra defaultUsed for deactivation and reactivation
name.givenNameYesgivenNameRequired for user creation
name.familyNameYessurnameRequired for user creation
externalIdYesobjectIdUse a stable Entra identifier
emails[type eq "work"].valueYesuserPrincipalName or mailShareFile requires an email on create
emails[type eq "work"].primaryRecommendedTrueMarks the work email as primary
urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organizationOptionalcompanyNamePopulates Organization/Company in ShareFile

User mapping guidance

  • Map externalId to objectId
  • Keep userName and the primary work email aligned
  • Remove unused mappings such as displayName (ShareFile derives display name from given/family name), title, department, manager, costCenter, and division

Step 5: Configure group attribute mappings

Supported group mappings

ShareFile SCIM attributeRequiredRecommended Entra sourceNotes
displayNameYesdisplayNameUsed as the ShareFile group name
externalIdYesobjectIdStable group identifier; required for idempotent sync
membersYesmembersUsed to sync group membership

Group mapping guidance

  • Keep group mappings minimal and remove extra attributes ShareFile does not use: name.formatted, addresses.*, phoneNumbers.*
  • Prefer groups with direct user membership
  • Do not rely on nested groups for ShareFile membership sync

Step 6: Assign users and groups to the application

  1. In the Entra enterprise application, open Users and groups.

    Users and groups page

  2. Select + Add user/group.

  3. Assign the users and groups you want ShareFile to provision.

  4. If you want group sync, make sure the relevant groups are assigned.

Step 7: Start provisioning

  1. In the left navigation, select Overview.

  2. Select Start provisioning.

    Start provisioning

  3. Monitor Entra provisioning logs during the initial sync.

After provisioning starts:

  • Assigned users are created in ShareFile
  • Supported user updates sync automatically
  • Users can be deactivated or reactivated through Entra
  • Assigned groups are created in ShareFile
  • Group membership changes sync to ShareFile

Troubleshooting

The ShareFile URL or API Key is missing

  • Confirm the account is on an Enterprise plan
  • Confirm SCIM is enabled under Account Settings > User Provisioning

Connection test fails in Entra

  • Verify the ShareFile URL was pasted into Tenant URL
  • Verify the ShareFile API Key was pasted into Secret Token
  • Verify Authentication method is set to Bearer authentication

Users fail to provision

Check that the following mappings exist and are populated:

  • userName
  • active
  • name.givenName
  • name.familyName
  • Primary work email
  • externalId

Users provision, but company/organization is blank

Map urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization to companyName.

Group membership is incomplete

  • Confirm the group is assigned to the app
  • Confirm the members mapping is present
  • Avoid nested groups