Prerequisites
Before you configure SCIM provisioning, ensure you have:- Administrator access to your Microsoft Entra ID tenant (Application Administrator or higher)
- A Brellium account with the can edit sso settings permission, with SSO and SCIM turned on for your organization (see Access the Brellium setup portal)
- SSO configured for Brellium (see the SSO Configuration for Microsoft Entra ID guide)
- The SCIM endpoint URL and secret token from Brellium (see Get the SCIM endpoint URL and token)
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 Control Center > Settings — the Single sign-on and Directory sync (SCIM) sections
- 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.
- 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.

The can edit sso settings permission under Settings
Supported features
Supported profile attributes
Core attributes
Enterprise User extension attributes
The following attributes use theurn:ietf:params:scim:schemas:extension:enterprise:2.0:User schema namespace.
Get the SCIM endpoint URL and token
- In Brellium, go to Control Center > Settings.
- Under Directory sync (SCIM), click Edit configuration. The setup portal opens in a new tab.
- Copy the SCIM endpoint URL and the token. You use them in the Connect Microsoft Entra ID to Brellium step.
Configuration steps
Create a non-gallery enterprise application
- In the Microsoft Entra admin center, go to Entra ID > Enterprise apps > All applications.
- Click New application.

Enterprise applications — click New application
- On the Browse Microsoft Entra App Gallery page, click Create your own application.

Browse Microsoft Entra App Gallery — click Create your own application
- Enter a name for the application (for example,
BRELLIUM SCIM). - Select Integrate any other application you don’t find in the gallery (Non-gallery).
- Click Create.

Create your own application — select Non-gallery
Assign users and groups
- In the new SCIM application, go to Manage > Users and groups.
- Click Add user/group.
- Select the same users and groups that are assigned to your Brellium SSO application, then click Assign.

Users and groups — assign the same users and groups as the SSO application
Connect Microsoft Entra ID to Brellium
- In the SCIM application, go to Manage > Provisioning.
- On the Get started with application provisioning page, click Connect your application.

Get started with application provisioning — click Connect your application
- Set Select authentication method to Bearer authentication.
- In Tenant URL, paste the SCIM endpoint URL from Brellium, then add
?aadOptscim062020to the end of it. - In Secret token, paste the token from Brellium.
- Click Test connection and wait for the message Connection test for ‘BRELLIUM SCIM’ was successful.
- Click Create.

Admin credentials — Tenant URL ends with ?aadOptscim062020
Map externalId to objectId
- In the SCIM application, go to Manage > Attribute mapping, and stay on the Users tab.
- On the row where Source Attribute is
mailNicknameand Target Attribute isexternalId, click the edit icon.

Attribute mapping — edit the mailNickname → externalId row
- Change Source attribute (Microsoft Entra ID) to
objectId. - Click Apply.

Edit Attribute Mapping — source attribute objectId, target attribute externalId
objectId never changes, so Brellium can match a user even if their name or email changes. A mailNickname can change.Match users by email
- Back on the Attribute mapping page, click the edit icon on the row where Source Attribute is
mailand Target Attribute isemails[type eq "work"].value.

Attribute mapping — edit the mail → emails row
- Select Yes for Match objects using this attribute.
- Set Matching precedence to
2. - Click Apply.

Edit Attribute Mapping — match objects using mail, matching precedence 2
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.Remove the manager mapping and save
- On the Attribute mapping page, click the delete icon on the
managerrow.

Attribute mapping — delete the manager row
- Check that the list now shows:
userPrincipalName→userNamewith matching precedence1mail→emails[type eq "work"].valuewith matching precedence2objectId→externalId- No
managerrow
- Click Save, and confirm if Entra ID asks you to.

Attribute mapping — final user mappings
Turn on group provisioning (optional)
- Go to Manage > Provisioning and expand Mappings.
- 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.

Mappings — Provision Microsoft Entra ID Groups and Users
Start provisioning
- On the same Provisioning page, expand Settings and set Scope to Sync only assigned users and groups.
- Set Provisioning Status to On.
- Click Save.

Provisioning — set Provisioning Status to On and save
- Go to Overview. If Current cycle status shows Initial sync paused, click Start provisioning.

Provisioning overview — click Start provisioning
Verify provisioning
- In the SCIM application, go to Monitor > Provisioning logs and check the status of provisioned users.
- In the Brellium user directory, verify that the users were created with the correct profile attributes.
- 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.
- 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:- Email: sso.support@brellium.com