Skip to content

Microsoft Entra ID integration

People sign in to EvenTier with their Microsoft Entra ID accounts over SAML 2.0 or OpenID Connect (OIDC). To keep the user list current, Entra can push changes with SCIM provisioning, or EvenTier can read users and their photos from Microsoft Graph on a schedule with directory sync.

Set up in
Admin → Settings → Organization settings → Authentication · Admin → Settings → Directory sync
Who can set it up
Sign-in: a full administrator. SCIM and directory sync: the Manage settings permission.

Single sign-on over SAML or OIDC

Connect Entra ID as the workspace's identity provider (IdP) for your verified email domains, test the connection, then require single sign-on (SSO). Passwords are refused only while SSO is required and the connection is on and complete, so an unfinished or switched-off connection never locks the workspace out.

  • SAML needs Entra to sign both the response and the assertion
  • The email comes from Entra's emailaddress claim, and the name from the display name or the given name and surname
  • Just-in-time (JIT) provisioning creates first-time users as Employees or Agents, never as administrators
  • Failed sign-ins are recorded with their reason under Security events in the audit log
  • A SAML logout request from Entra ends the EvenTier session

SCIM provisioning from an enterprise application

Entra's provisioning service creates, updates and deactivates EvenTier users and pushes group membership to EvenTier's SCIM 2.0 endpoint. Unassigning someone from the application deactivates their EvenTier account. That ends their access and keeps their request history.

  • New SCIM users start as Employees
  • A group named "Team: Network Ops" adds its members to that team
  • A group named "Role: Service Desk" assigns that role, but only if you turn on Directory sync can assign this role for it
  • SCIM never deactivates the only person who can manage users and roles, and never changes the sign-in email of someone with administrator access
  • Workspace admins are notified when a group grants a role or adds people to a team

Directory sync from Microsoft Graph

Instead of SCIM, EvenTier can read users from Microsoft Graph with an app registration you create. It syncs every 15 minutes or less often, as you choose, and can be limited to the members of one group. Preview changes lists who would be created, updated or deactivated without changing anything, and a manual sync can be queued only after a preview.

  • Name, email, job title and department come from the directory. An account disabled in Entra is deactivated in EvenTier
  • New users get the default role you pick, Employee or Agent
  • You choose whether people removed from the directory are deactivated or left active
  • By default, a run deactivates at most a quarter of the users it manages, and always at least one. If more have left the directory, it deactivates none of them and reports why
  • Existing accounts are linked by exact email only when you allow it for a run, and never for administrators
  • As with SCIM, the only person who can manage users and roles is never deactivated, and administrators' sign-in emails are never changed
  • Each sync is listed under Recent runs with its counts and errors

Profile photos from Entra ID

Directory sync imports each member's Entra photo and checks it again once a day, skipping a photo whose Graph version has not changed. A photo the member uploaded themselves always takes priority.

  • Uses the sync's User.Read.All permission. If photo reads are refused, the run notes that photos were skipped and still completes
  • OIDC sign-in cannot import the Microsoft photo, because Graph needs the member's own token for it. Entra photos come through directory sync or Teams replies

Set up Microsoft Entra ID

  1. 01

    Verify your email domain

    Enter your email domain. At your DNS provider, publish the TXT record shown on the page at _eventier-login.<domain>, then choose Verify. Add any other domain your staff sign in with under Additional verified domains. A verified domain stays trusted for 90 days after its last successful check.

    Where:
    Admin → Settings → Organization settings → Authentication
    Permission:
    Full administrator
  2. 02

    Connect Entra over SAML

    Choose Provider type SAML 2.0. In Entra, set up SAML sign-on for an enterprise application with the SP entity ID and ACS URL shown in EvenTier, and choose Sign SAML response and assertion. EvenTier's metadata is also published at https://<your host>/api/org-auth/saml/<workspace slug>/metadata. Paste Entra's IdP SSO URL, IdP entity ID and X.509 signing certificate into EvenTier.

    Where:
    Admin → Settings → Organization settings → Authentication
    Permission:
    Full administrator
  3. 03

    Or connect Entra over OIDC

    Choose Provider type OIDC. In Entra, register a web application with this redirect URI: https://<your host>/api/org-auth/oidc/callback. Paste the issuer URL, client ID and client secret into EvenTier. EvenTier does not look up the other endpoints, so also copy the authorization, token and user info URLs from the discovery document at <issuer>/.well-known/openid-configuration.

    Where:
    Admin → Settings → Organization settings → Authentication
    Permission:
    Full administrator
  4. 04

    Test, then require SSO

    Turn the connection on and choose whether new users are created automatically, and with which role. Choose Test SSO. Once the test passes, set Authentication mode to SSO required. EvenTier lets you require SSO only when the connection covers your own email domain.

    Where:
    Admin → Settings → Organization settings → Authentication
    Permission:
    Full administrator
  5. 05

    Provision users with SCIM

    Turn SCIM on, choose when the token expires or pick Never expires, and generate the token. It is shown only once. In Entra, create a non-gallery enterprise application, open Provisioning and set the mode to Automatic. Enter https://<your host>/api/scim/v2/<workspace slug> as the Tenant URL and the token as the Secret Token.

    Where:
    Admin → Settings → Organization settings → Authentication → SCIM provisioning
    Permission:
    Manage settings
  6. 06

    Or set up directory sync

    Register an application in Entra with a client secret and the Microsoft Graph User.Read.All application permission, with admin consent. In EvenTier, enter the directory (tenant) ID, the application (client) ID and the secret. Choose the interval, the default role and what happens to people removed from the directory, and optionally a group object ID to limit the sync to. Then choose Test connection, Preview changes and Queue sync, in that order.

    Where:
    Admin → Settings → Directory sync
    Permission:
    Manage settings

Data flow

With SSO and SCIM, EvenTier receives only what Entra sends and has no standing access to your directory. Directory sync reads users from Microsoft Graph with the permission you grant. Nothing is written back to Entra ID.

At sign-in

  • A signed SAML response and assertion, or an OIDC ID token and user info
  • The person's email address and name

Through SCIM

  • User create, update and deactivate requests from Entra's provisioning service
  • Group names and members, for team and role mapping

Through directory sync

  • Each user's object ID, user principal name, mail, given name, surname, display name, job title, department and whether the account is enabled
  • Profile photos, checked again once a day

Questions about Microsoft Entra ID

Should I use SCIM or directory sync?
Either keeps the user list current. With SCIM, Entra pushes changes to EvenTier, and pushed groups can add people to teams and assign roles. With directory sync, EvenTier reads users from Microsoft Graph on a schedule, brings Entra photos with them, and lets you preview a manual sync first.
Can Entra create administrators in EvenTier?
Not unless you allow it. Just-in-time provisioning and directory sync create Employees or Agents, and SCIM creates Employees. A SCIM group can assign a role by name only if you turn on Directory sync can assign this role for that role, so leave it off for privileged roles.
Which Entra permission does directory sync need?
The Microsoft Graph User.Read.All application permission with admin consent, plus a client secret. That one permission covers listing users and reading their photos.

Get notified when signup opens.

EvenTier is in private early access. Leave your work email and we will let you know when you can create a workspace.

No card. We use your email only for your early-access invite and launch news. Privacy Policy