Skip to main content

Microsoft (admin consent)

Connect Entra ID, Intune and Defender in one step by having a Microsoft administrator approve Navigator’s app. There is no app registration to create and no client secret to store or rotate.

Beta. This way of connecting is new. It is built to Microsoft’s documentation and works as described below; tell us at [email protected] if anything behaves differently in your tenant.

At a glance

Data providedDevices, Users, Vulnerabilities, Software (from Entra ID, Intune and Defender, whichever you choose)
AuthenticationAdmin consent to Navigator’s Microsoft app. No client secret.
Where to configureConnectors → Add a Connector → Microsoft
Who can connectA Navigator administrator or credential manager (signed in with multi-factor authentication), working with a Microsoft Global Administrator or Privileged Role Administrator

Before you start

You need two things:

  • In Navigator: an account with the administrator or credential manager role, signed in with multi-factor authentication.
  • In Microsoft: a Global Administrator or Privileged Role Administrator of your Microsoft tenant to approve the app. Microsoft only lets those two roles approve Microsoft Graph application permissions. Cloud Application Administrator and Application Administrator cannot.

The Microsoft administrator is the person who clicks Connect and signs in, so if you are not one yourself, ask them to do the steps below.

If you manage a customer’s tenant as a partner (for example through delegated admin access), your technician’s role does not count here. Use the Entra ID, Intune or Defender connector with an app registration instead.

Permissions requested

All of these are application permissions that only read data. Navigator cannot change anything in your Microsoft tenant. The same list is shown to the administrator in Navigator before they connect.

APIPermissionUsed for
Microsoft GraphUser.Read.AllRead users
Microsoft GraphDevice.Read.AllRead Entra devices
Microsoft GraphDeviceManagementManagedDevices.Read.AllRead Intune devices
Microsoft GraphDeviceManagementConfiguration.Read.AllRead Intune configuration and policies
Microsoft GraphDirectory.Read.AllRead directory data
Microsoft GraphGroupMember.Read.AllRead group memberships
Microsoft GraphPolicy.Read.AllRead Conditional Access and other policies
Microsoft GraphRoleManagement.Read.DirectoryRead directory role assignments
Microsoft GraphAuditLog.Read.AllRead sign-in activity and audit logs
Defender for EndpointMachine.Read.AllRead machines
Defender for EndpointSoftware.Read.AllRead software inventory
Defender for EndpointUser.Read.AllRead machine users
Defender for EndpointVulnerability.Read.AllRead vulnerability data

Microsoft approves the whole list at once. The services you tick in Navigator decide which ones sync, not which permissions are approved. The Defender permissions need Microsoft Defender for Endpoint in your tenant.

Setup

  1. In Navigator, go to Connectors → Add a Connector and choose Microsoft, then Connect.
  2. Review the permissions listed on the page.
  3. Enter a Connection Name. The default is microsoft. If an Entra, Intune or Defender connection already has that name, Navigator does not replace it; choose another name, or delete the old connection first.
  4. Tick the services to sync: Entra, Intune, Defender. Leave Defender unticked if your organization does not use Microsoft Defender for Endpoint.
  5. Click Connect with Microsoft.
  6. Sign in with your Microsoft administrator account. Use the same account for the whole process.
  7. On Microsoft’s approval page, review the permissions and approve them.
  8. You return to Navigator. The connection shows as waiting while Navigator confirms with Microsoft that approval exists and that the person who approved it holds one of the two required roles. This is usually quick.
  9. Once verified, the first sync starts. Nothing syncs before verification passes.

If the connection does not verify

The connection card and its View details page say what state it is in.

StateWhat it meansWhat to do
Waiting or verifyingNavigator is still checking with Microsoft.Click Check again after a minute.
Approval missing or incompleteConsent was not granted, or some permissions are missing.Click Connect again and approve every permission.
Not an administratorThe person who approved is not a Global Administrator or Privileged Role Administrator.Have one of those administrators connect again.
Tenant already connectedThis Microsoft tenant is already connected to another Navigator organization.Contact [email protected] if that is unexpected.

If a permission is added to Navigator’s app later, every connected tenant is asked to approve again, and a sync that is missing a permission reports that you need to reconnect.

After connecting

  • One connection, three services. Entra ID, Intune and Defender each get their own card, sync history and details page once the connection is verified. The cards carry an Admin consent tag. Connections made with an app registration carry a Client secret tag.
  • Sync options. On the connection’s details page, choose which Entra device trust types to import, whether to include registered users, and which Defender onboarding statuses to include. These are the same options the secret-based connectors have. Nothing is filtered until you untick a box.
  • Deactivate and reactivate. Deactivating pauses the whole connection. It stops syncing and stops counting toward coverage, and imported records are kept. Reactivating starts a sync right away.
  • Exposure categories. Assign these on the Entra ID, Intune and Defender cards, as with any connector.

Removing the connection

Delete on the connection’s details page stops syncing for good and removes the saved settings, including the Microsoft tenant it was connected to. A deleted connection cannot be resumed, and its name cannot be reused. Imported records are kept and age out.

Deleting in Navigator does not remove Microsoft’s approval. To revoke it, a Microsoft administrator removes the Navigator application under Enterprise applications in Microsoft Entra. Do this as well if you are offboarding.

An existing Entra, Intune or Defender connection that uses a client secret keeps working, and it takes priority over consent for the same connection name. Moving is not automatic:

  1. Connect with admin consent under a new connection name.
  2. Check that it verifies and the first sync completes.
  3. Delete the old secret-based connections.

The records are filed under the connector and connection name, so a new name means a fresh set of records for the new connection.

Choosing between the two ways to connect

Admin consentApp registration (client secret)
SetupOne approval by a Microsoft administratorCreate an app, add permissions, create a secret, copy IDs
Secret to rotateNoneYes, for each connector
Who can set it upGlobal Administrator or Privileged Role AdministratorAnyone who can create app registrations and grant consent
Azure connectorNot includedNot applicable; Azure always uses its own app registration

The Azure connector is not part of admin consent, because it needs an Azure role assignment on your subscriptions.

Vendor documentation

Microsoft’s own pages: Grant tenant-wide admin consent to an application and the Microsoft Graph permissions reference.

Entra ID, Intune and Defender are the services this connection feeds. See the Connectors overview for how the Microsoft connectors fit together.