Appearance
Connect your Microsoft Entra ID tenant so imper.ai can identify new hires, set their corporate password, and verify their first sign-in during enrollment.
This article explains how to connect your Microsoft Entra tenant to imper.ai and verify a successful connection.
Prerequisites
Before you begin, make sure of the following:
Microsoft Entra ID administrator privileges.
Admin access to the imper.ai Admin Console.
Your organization has approved third-party integrations with Microsoft Entra.
You have copied your Tenant ID :
Log in to the Azure Portal using your administrator credentials.
Navigate to Microsoft Entra ID > Tenant Properties.
Copy the Tenant ID.
Procedure
Follow these steps to connect Microsoft Entra to your imper.ai environment:
Log in to imper.ai using your admin credentials or Single Sign-On (SSO).
Go to Settings > Integrations.
Navigate to Microsoft Entra , and click Connect. The Microsoft login pop-up opens.
Enter your Tenant ID (found in Azure > Tenant Properties) and click Enter.
Click Open Link to be redirected to the Microsoft Authorization page.
Approve the requested permissions on the Microsoft Authorization page.
Once complete, the Installation Completed Successfully opens.
Verify Connectivity
After connecting, imper.ai automatically performs several checks:
Validates the Entra tenant.
Pulls basic identity metadata.
Confirms the domain.
Displays the integration connection status.
Shows the last sync timestamp.
If any required permission is missing, imper.ai displays a notification in the Integration panel.
Permissions
During enrollment, imper.ai uses Microsoft Entra in two ways - reading identity data to fetch and identify new hires, and writing to set their corporate password. Each role requires its own permissions, so the connection needs both read and write access.
For the full list of permissions and how each one is used, see Microsoft Entra Permissions.