Skip to content

Connect Microsoft Entra ID

Identiguard reads Entra ID through Microsoft Graph. You register an application in the client’s directory, grant it read-only permissions and give Identiguard its details. Identiguard then polls Microsoft Graph on an interval you choose.

You need:

  • A role in Entra ID that can register applications and grant admin consent.
  • The admin role in the Identiguard workspace. Members and viewers see Only workspace admins can create tenants. and a disabled Admin Access Required button.
  • A free tenant slot on the plan. See the plan tenant limit.
  1. In the Entra admin centre, go to App registrations → New registration.
  2. Give it a name, such as Identiguard, and register it.
  3. Copy the Directory (tenant) ID and the Application (client) ID.
  4. Under Certificates & secrets, create a client secret and copy its Value. Do not copy the Secret ID.

Under API permissions, add these as Microsoft Graph application permissions, then choose Grant admin consent.

Permission What it enables
IdentityRiskyUser.Read.All Risky users
IdentityRiskEvent.Read.All Risk detections, such as password spray and leaked credentials
AuditLog.Read.All Directory audits and sign-ins
IdentityRiskyServicePrincipal.Read.All Workload identity risk. Needs the Workload ID Premium licence.
ServiceHealth.Read.All The Entra ID status page

The tenant’s Edit page checks these six permissions and shows each as Granted or Not granted.

Permission Report section Also counts as granted with
Reports.Read.All MFA coverage. Also needs Entra ID P1. AuditLog.Read.All
RoleManagement.Read.Directory Global Administrator count RoleManagement.Read.All or Directory.Read.All
Policy.Read.All Conditional Access inventory
Application.Read.All App credential expiry Directory.Read.All
SecurityEvents.Read.All Microsoft Secure Score
IdentityRiskyUser.Read.All Current risky users

Grant only what the client is comfortable with. A missing permission removes that one stream or report section and nothing else.

  1. Open the workspace and go to Tenants.
  2. Under Create a tenant, find the Entra ID card (caption Microsoft ecosystem) and choose Connect. The page Add New Entra ID Tenant opens.
  3. Fill in the form. Every field is described in the table below.
  4. Under Event Subscriptions, tick the streams to collect. Nothing is ticked when the page opens, and you must tick at least one.
  5. Choose Create Entra ID Tenant. The button reads Creating… while Identiguard works.
Section Field Rules
Basic Details Tenant Name Required. 100 characters or fewer. No line breaks or control characters.
Basic Details Customer Name Optional for Entra ID. The field suggests customer names already used in the workspace.
Basic Details Azure AD Tenant ID Required. The Directory (tenant) ID. Must be a UUID, such as xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Basic Details Poll Interval (minutes) Required. From 5 to 60 on this form. The default is 5.
Basic Details Client ID Required. The Application (client) ID. Must be a UUID.
Credentials Client Secret Required. The secret Value from the app registration.
Event Subscriptions Subscribed Event Types At least one stream.

There is no Environment field for Entra ID.

The form lists five streams. Select All ticks all five and Clear All unticks them.

Stream label on the form Needs
Risky users: accounts Entra has flagged as at risk IdentityRiskyUser.Read.All
Risk detections: password spray, leaked credentials, atypical travel and 19 more IdentityRiskEvent.Read.All
Directory audits: role & PIM changes, consent grants, MFA tampering, CA policy changes (needs AuditLog.Read.All) AuditLog.Read.All
Sign-ins: risky sign-ins and Conditional Access failures (needs AuditLog.Read.All + P1) AuditLog.Read.All and Entra ID P1
Workload identity risk: risky service principals and their risk detections The Microsoft Entra Workload ID Premium licence, plus IdentityRiskyServicePrincipal.Read.All and IdentityRiskEvent.Read.All
  1. Identiguard asks Microsoft for a token with the tenant ID, client ID and secret. Nothing is saved unless Microsoft accepts them.
  2. On a trial workspace, this check also claims the directory for the trial. One Entra directory can be used in one trial only.
  3. You return to the Tenants page.
  4. The first events arrive after the first poll.
  1. Open Tenants.
  2. In Tenant overview, choose the pencil icon (Edit) on the Entra ID tenant.
  3. Read Reporting permissions (optional). Each row shows Granted or Not granted.
  4. If a row shows Not granted, add that permission in the Entra admin centre under API permissions and choose Grant admin consent.
  5. Reload the Edit page. Identiguard reads the permissions from Microsoft each time the page loads. There is no refresh button.
  • Entra ID events arrive on the poll interval, not instantly. Say so in a demo.
  • Client secrets expire. Put the expiry date in the client’s calendar and see Rotate credentials.
  • You cannot change the directory later. To move to another directory, delete the tenant and create it again.
  • Deleting the tenant changes nothing inside Entra ID. Revoke the app registration’s secret yourself if you no longer need it.
  • To change streams or the poll interval later, see Managing tenants.

Field errors show in red under the field. Other errors show as a red toast. A toast that starts with Failed to create tenant: comes from the server.

What you see Why What to do
“Only workspace admins can create tenants.” and a disabled Admin Access Required button Your role is member or viewer Ask a workspace admin to create the tenant.
“Tenant name cannot be empty”, “Tenant name must be 100 characters or fewer” or “Tenant name cannot contain line breaks or control characters” The tenant name breaks a rule Fix the name.
“Azure AD Tenant ID is required” or “Must be a valid Azure AD Tenant ID (UUID format)” The tenant ID is blank or is not a UUID Copy the Directory (tenant) ID from the app registration overview.
“Application (Client) ID is required” or “Must be a valid Application (Client) ID (UUID format)” The client ID is blank or is not a UUID Copy the Application (client) ID from the app registration overview.
“Client Secret is required” The secret is blank Paste the secret Value, not the Secret ID.
“Poll interval must be at least 5 minutes” or “Poll interval cannot exceed 60 minutes” The interval is out of range for the create form Enter a number from 5 to 60. You can set a longer interval on the Edit page later.
“At least one event type must be selected” No stream is ticked Tick at least one stream.
“Invalid event type submitted” The page sent a stream that is not on the allowed list Reload the page and select the streams again.
What you see Why What to do
“Failed to create tenant: Microsoft rejected these credentials. Check the directory (tenant) ID, client ID and client secret.” Microsoft refused the token request Check all three values. The secret may have expired, or you pasted the Secret ID in place of the Value.
“Failed to create tenant: Could not verify these credentials with Microsoft. Try again in a few minutes.” Microsoft did not answer Try again in a few minutes.
“Failed to create tenant: Microsoft Entra did not accept this client ID and client secret for that tenant, so it cannot be added. Check them and try again.” Trial workspace. Microsoft refused the credentials during the trial check. Check all three values, as above.
“Failed to create tenant: Identiguard could not reach Microsoft Entra to check these credentials. Try again in a few minutes.” Trial workspace. Microsoft did not answer. Try again in a few minutes.
“Failed to create tenant: This Microsoft Entra tenant has already been used in another Identiguard trial, so it cannot be added to a new one. Choose a plan on the Billing page to add it, or contact Identiguard support.” Trial workspace. Another trial already used this directory. Choose a paid plan, or contact Identiguard support.
“Failed to create tenant: The <Plan> plan allows up to N tenants per workspace, and this workspace already has M. Upgrade the plan to add more.” The workspace is at its plan tenant limit Delete a tenant you no longer need, or upgrade the plan. See Plans and billing.
“Forbidden: You do not have permission to create tenants.” Your role changed while the page was open Ask a workspace admin.
“Failed to create tenant: Bad Request” The server rejected the form Check every field again. Escalate if it continues.
“Failed to create tenant: API error” or “An unexpected error occurred: …” An unexpected error Try again, then escalate to the product team.
“Failed to create tenant: Server configuration error…” A platform problem Escalate to a platform operator.
What you see Why What to do
No confirmation after you choose Create Entra ID Tenant The Tenants page does not show a success message Check for the new row in Tenant overview.
No events yet Entra ID is polled, not pushed Wait one poll interval.
A toast “<tenant name> connection unhealthy” with “Microsoft Graph rejected one or more enabled streams while others polled fine. Re-check the app registration permissions/licence for the subscribed event types.” A subscribed stream lacks its permission or licence. Typical causes: sign-ins without P1, workload identity risk without Workload ID Premium, or AuditLog.Read.All not granted. Grant the permission and admin consent, or untick that stream. See Change which events a tenant sends.
A toast “<tenant name> connection unhealthy” with “Microsoft Graph credentials rejected. Re-check the client ID and secret.” Microsoft refused every stream. The secret has expired or was revoked. Rotate credentials.
Not granted on a reporting permission The permission is not added, or admin consent is not granted Add the application permission, choose Grant admin consent, then reload the Edit page.
“Could not load reporting permissions.” The permission check failed to load Reload the page.
“Could not read the app registration permissions. Check the tenant credentials.” Identiguard could not sign in to read the app registration Rotate credentials, then reload the page.