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.
Before you start
Section titled “Before you start”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. Register an application in Entra ID
Section titled “1. Register an application in Entra ID”- In the Entra admin centre, go to App registrations → New registration.
- Give it a name, such as
Identiguard, and register it. - Copy the Directory (tenant) ID and the Application (client) ID.
- Under Certificates & secrets, create a client secret and copy its Value. Do not copy the Secret ID.
2. Grant permissions
Section titled “2. Grant permissions”Under API permissions, add these as Microsoft Graph application permissions, then choose Grant admin consent.
For monitoring
Section titled “For monitoring”| 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 |
For reports (optional)
Section titled “For reports (optional)”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.
3. Create the tenant in Identiguard
Section titled “3. Create the tenant in Identiguard”- Open the workspace and go to Tenants.
- Under Create a tenant, find the Entra ID card (caption Microsoft ecosystem) and choose Connect. The page Add New Entra ID Tenant opens.
- Fill in the form. Every field is described in the table below.
- Under Event Subscriptions, tick the streams to collect. Nothing is ticked when the page opens, and you must tick at least one.
- Choose Create Entra ID Tenant. The button reads Creating… while Identiguard works.
The fields
Section titled “The fields”| 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 streams
Section titled “The streams”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 |
What happens when you create the tenant
Section titled “What happens when you create the tenant”- Identiguard asks Microsoft for a token with the tenant ID, client ID and secret. Nothing is saved unless Microsoft accepts them.
- On a trial workspace, this check also claims the directory for the trial. One Entra directory can be used in one trial only.
- You return to the Tenants page.
- The first events arrive after the first poll.
Check which permissions are granted
Section titled “Check which permissions are granted”- Open Tenants.
- In Tenant overview, choose the pencil icon (Edit) on the Entra ID tenant.
- Read Reporting permissions (optional). Each row shows Granted or Not granted.
- If a row shows Not granted, add that permission in the Entra admin centre under API permissions and choose Grant admin consent.
- Reload the Edit page. Identiguard reads the permissions from Microsoft each time the page loads. There is no refresh button.
Good to know
Section titled “Good to know”- 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.
Troubleshooting
Section titled “Troubleshooting”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.
Form validation
Section titled “Form validation”| 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. |
Creation errors
Section titled “Creation errors”| 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. |
After creation
Section titled “After creation”| 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. |