Skip to main content
This guide walks you through configuring SCIM provisioning for Brellium using Microsoft Entra ID (formerly Azure Active Directory). SCIM provisioning lets you create, update, and deactivate Brellium users from Microsoft Entra ID.
The screenshots come from a Brellium test tenant. Your application names, organization name, and IDs will be different.

Prerequisites

Before you configure SCIM provisioning, ensure you have:

Access the Brellium setup portal

IT administrators can open the SSO and SCIM setup portal on their own. In Brellium, go to Control Center > Settings. The Single sign-on and Directory sync (SCIM) sections each have an Edit configuration button. Each button opens the setup portal for that connection in a new tab, so you can configure and change settings without a support ticket.
Brellium Team Settings page showing the Single sign-on connection with its Client ID, the Directory sync (SCIM) section, and an Edit configuration button for each

Brellium Control Center > Settings — the Single sign-on and Directory sync (SCIM) sections

Before you can use the setup portal, make sure that:
  1. SSO and SCIM are turned on for your organization. If you do not see the Single sign-on and Directory sync (SCIM) sections on the settings page, contact your customer success manager to turn on the feature for your organization. You can open the SSO and SCIM configuration only after the feature is on.
  2. You have the can edit sso settings permission. Your Brellium account must have the can edit sso settings permission under Settings. The can edit org settings permission does not give access to SSO and SCIM. If you do not have the permission, ask a Brellium administrator in your organization to give it to you.
Brellium Settings permissions: can view page, can edit org settings, and can edit sso settings

The can edit sso settings permission under Settings

Supported features

SCIM only pushes groups that are directly assigned to the Brellium SCIM enterprise application. If Brellium also needs groups that are not assigned to the app (for example, location or department groups), you must grant Brellium read access to group memberships in Microsoft Graph. See Microsoft Graph Permissions for Group Sync.

Supported profile attributes

Core attributes

Enterprise User extension attributes

The following attributes use the urn:ietf:params:scim:schemas:extension:enterprise:2.0:User schema namespace.
The SCIM userName attribute in Brellium follows an email address format. Ensure the userName attribute is mapped to a UPN or email field in Microsoft Entra ID that uses an email address format.

Get the SCIM endpoint URL and token

  1. In Brellium, go to Control Center > Settings.
  2. Under Directory sync (SCIM), click Edit configuration. The setup portal opens in a new tab.
  3. Copy the SCIM endpoint URL and the token. You use them in the Connect Microsoft Entra ID to Brellium step.
If you cannot open the setup portal, see Access the Brellium setup portal.
Treat the secret token like a password. Do not send it by email or chat.

Configuration steps

1

Create a non-gallery enterprise application

SCIM provisioning uses a separate enterprise application from the one you use for SSO.
  1. In the Microsoft Entra admin center, go to Entra ID > Enterprise apps > All applications.
  2. Click New application.
Enterprise applications list showing the BRELLIUM SSO app and the New application button

Enterprise applications — click New application

  1. On the Browse Microsoft Entra App Gallery page, click Create your own application.
Browse Microsoft Entra App Gallery page with the Create your own application button

Browse Microsoft Entra App Gallery — click Create your own application

  1. Enter a name for the application (for example, BRELLIUM SCIM).
  2. Select Integrate any other application you don’t find in the gallery (Non-gallery).
  3. Click Create.
Create your own application panel with the name BRELLIUM SCIM and the Non-gallery option selected

Create your own application — select Non-gallery

Ignore the suggested gallery applications. Brellium is not in the Microsoft Entra App Gallery.
2

Assign users and groups

  1. In the new SCIM application, go to Manage > Users and groups.
  2. Click Add user/group.
  3. Select the same users and groups that are assigned to your Brellium SSO application, then click Assign.
BRELLIUM SCIM Users and groups page with a group assigned

Users and groups — assign the same users and groups as the SSO application

Assign the same users and groups to both the SSO application and the SCIM application. Users that are assigned to only one application cannot sign in, or are not provisioned.
Only the groups you assign here are pushed to Brellium. To give Brellium other groups as well, complete the Microsoft Graph Permissions for Group Sync guide after this one.
3

Connect Microsoft Entra ID to Brellium

  1. In the SCIM application, go to Manage > Provisioning.
  2. On the Get started with application provisioning page, click Connect your application.
BRELLIUM SCIM provisioning Get started page with the Connect your application button

Get started with application provisioning — click Connect your application

  1. Set Select authentication method to Bearer authentication.
  2. In Tenant URL, paste the SCIM endpoint URL from Brellium, then add ?aadOptscim062020 to the end of it.
  3. In Secret token, paste the token from Brellium.
  4. Click Test connection and wait for the message Connection test for ‘BRELLIUM SCIM’ was successful.
  5. Click Create.
New provisioning configuration page with Bearer authentication, the Tenant URL ending in ?aadOptscim062020, the secret token, and a successful connection test

Admin credentials — Tenant URL ends with ?aadOptscim062020

Add the ?aadOptscim062020 query parameter to the end of the Tenant URL. This flag opts your application into Microsoft’s SCIM compliance fixes and resolves known Microsoft Entra ID provisioning issues. Without it, provisioning can fail with attribute or PATCH request errors.
4

Map externalId to objectId

  1. In the SCIM application, go to Manage > Attribute mapping, and stay on the Users tab.
  2. On the row where Source Attribute is mailNickname and Target Attribute is externalId, click the edit icon.
BRELLIUM SCIM Attribute mapping Users tab with the mailNickname to externalId row highlighted

Attribute mapping — edit the mailNickname → externalId row

  1. Change Source attribute (Microsoft Entra ID) to objectId.
  2. Click Apply.
Edit Attribute Mapping page with Source attribute objectId and Target attribute externalId

Edit Attribute Mapping — source attribute objectId, target attribute externalId

The objectId never changes, so Brellium can match a user even if their name or email changes. A mailNickname can change.
5

Match users by email

  1. Back on the Attribute mapping page, click the edit icon on the row where Source Attribute is mail and Target Attribute is emails[type eq "work"].value.
Attribute mapping Users tab showing objectId mapped to externalId and the mail row highlighted

Attribute mapping — edit the mail → emails row

  1. Select Yes for Match objects using this attribute.
  2. Set Matching precedence to 2.
  3. Click Apply.
Edit Attribute Mapping page for mail with Match objects using this attribute checked and Matching precedence set to 2

Edit Attribute Mapping — match objects using mail, matching precedence 2

Entra ID first matches users by userPrincipalName (precedence 1). If no user matches, it tries the work email (precedence 2). This prevents duplicate users in Brellium when a user already exists with the same email.
6

Remove the manager mapping and save

  1. On the Attribute mapping page, click the delete icon on the manager row.
Attribute mapping Users tab with the manager row highlighted and the Delete mapping tooltip

Attribute mapping — delete the manager row

  1. Check that the list now shows:
    • userPrincipalName → userName with matching precedence 1
    • mail → emails[type eq "work"].value with matching precedence 2
    • objectId → externalId
    • No manager row
  2. Click Save, and confirm if Entra ID asks you to.
Attribute mapping Users tab with userPrincipalName and mail as matching attributes, objectId mapped to externalId, and no manager row

Attribute mapping — final user mappings

7

Turn on group provisioning (optional)

  1. Go to Manage > Provisioning and expand Mappings.
  2. Check the Enabled column for Provision Microsoft Entra ID Groups:
    • To push assigned groups to Brellium, make sure it is Yes.
    • To push only users, select Provision Microsoft Entra ID Groups, set Enabled to No, and save.
BRELLIUM SCIM Provisioning page with Mappings expanded showing Provision Microsoft Entra ID Groups and Provision Microsoft Entra ID Users both enabled

Mappings — Provision Microsoft Entra ID Groups and Users

8

Start provisioning

  1. On the same Provisioning page, expand Settings and set Scope to Sync only assigned users and groups.
  2. Set Provisioning Status to On.
  3. Click Save.
BRELLIUM SCIM Provisioning page with Provisioning Status set to On

Provisioning — set Provisioning Status to On and save

  1. Go to Overview. If Current cycle status shows Initial sync paused, click Start provisioning.
BRELLIUM SCIM provisioning Overview with the Start provisioning button and current cycle status Initial sync paused

Provisioning overview — click Start provisioning

Microsoft Entra ID begins the initial provisioning cycle. The initial cycle can take longer than later cycles, which run every 40 minutes.
To test before the first cycle, use Provision on demand to provision one or two users and check the result.
9

Verify provisioning

  1. In the SCIM application, go to Monitor > Provisioning logs and check the status of provisioned users.
  2. In the Brellium user directory, verify that the users were created with the correct profile attributes.
  3. Change a test user’s profile in Microsoft Entra ID (for example, the job title) and verify that the change appears in Brellium after the next cycle.
  4. Unassign a test user from the SCIM application and verify that the user is deactivated in Brellium.

Troubleshoot

Support

If you have questions or encounter issues not covered in this guide, contact the Brellium support team: