Skip to content
Bexxo Help

Help The platform aideRub_annuaire

Connect the Microsoft Entra ID directory

For administrators Updated on 13 November 2026

Connect Microsoft Entra ID to your organisation to synchronise automatically the people and groups used by all portal services (PhishTrainer, Academy…). Allow about 15 minutes.
On this page
  1. Purpose
  2. Create the synchronisation group
  3. Create the application and record its identifiers
  4. Allow reading of users and groups
  5. Create a client secret
  6. Connect the directory in the portal
  7. After go-live

Purpose

In Microsoft Entra, you create a group and a read-only application (steps 1 to 4). In the portal, you enter its identifiers and start the synchronisation (step 5): only the organisation's administrator can do this.

The screenshots show the portal in French; the English labels are given in the text.

Prerequisite: in Microsoft Entra ID, the right to create a group and an app registration, and to grant admin consent (Global Administrator role or equivalent).

The requested permissions only allow reading your users and groups: Bexxo cannot modify, create or delete anything in Entra ID.

1Create the synchronisation group

Only the members of this group are synchronised. Afterwards, adding or removing a person from the group is enough to include or exclude them from the next synchronisation. You can create several groups, for example one per department.

  1. In the Microsoft Entra admin center (entra.microsoft.com), go to Entra ID › Groups › All groups, then click New group.
  2. Group type: Security; Membership type: Assigned; Group name: a recognisable name, for example Bexxo - Sync.
  3. Under Members, add the people to synchronise, then create the group.
Microsoft Entra: creating a security group for synchronisation
An assigned security group: its members are synchronised with Bexxo.

2Create the application and record its identifiers

  1. In Entra ID › App registrations, click New registration and name the application, for example Bexxo - Directory synchronisation.
  2. Supported account types: Single tenant only (Accounts in this organizational directory only in earlier versions of the portal).
  3. Leave the Redirect URI field empty, then click Register.

The application's Overview page shows two identifiers (GUID) to copy:

On the Azure pageField in the portal
Application (client) IDClient ID
Directory (tenant) IDTenant ID

3Allow reading of users and groups

  1. In the application's menu, open API permissions › Add a permission › Microsoft Graph.
  2. Be sure to choose Application permissions (not “Delegated permissions”).
  3. Add these two permissions:
PermissionWhat it allows
User.Read.AllRead the list of users (name, email, language, account status…).
Group.Read.AllRead the groups and the membership of each group.
Microsoft Graph: Group.Read.All and User.Read.All as Application permissions, status not granted
As long as the status shows “Not granted”, admin consent still has to be granted.
  1. Click Grant admin consent for [your organisation] and confirm. The status of both permissions must change to “Granted” (if needed, click Refresh).
Grant admin consent button

Essential step: without this consent, the synchronisation fails with a permissions error.

4Create a client secret

  1. In Certificates & secrets › Client secrets, click New client secret.
  2. Expiration: according to your policy (Microsoft recommends less than 12 months, 24 at most). Note the date: the secret must be renewed before then.
  3. Click Add and immediately copy the Value.

Copy the Value column, not “Secret ID”. It is displayed only once: if you do not copy it, you have to create a new secret.

5Connect the directory in the portal

  1. In My organization › Directory and SSO, add a Microsoft Entra ID directory. In the Connection section, enter the tenant ID, the client ID and the secret value, then save.
  2. Test the connection. If it fails, check the admin consent first (step 3).
  3. In Imported groups, add the group from step 1 and save: without a group, the whole directory is imported.
  4. Set the people's permissions and the frequency. Automatic synchronisation only runs if Import active is ticked and the frequency is not Manual.
  5. Preview, check the result, then synchronise: the sign-in accounts are created and each new account receives an invitation.

Filters are optional and the field matching is prefilled. For people to sign in with their Microsoft account, also fill in SSO sign-in.

Encryption active: the vault must be unlocked to enter these settings, and your Bexxo Protected agent is the one that queries the directory.

The agent that queries the directory when encryption is activeInstall the Bexxo Protected agent

After go-live

  • Renew the secret: before it expires, create a new one (step 4), enter it in Connection and save.
  • Least privilege: do not add any permission besides User.Read.All and Group.Read.All.

Procedure created from the Microsoft documentation: Register an application with the Microsoft identity platform.

Didn’t find the answer? Contact us