-
Register an application.
In the Microsoft Entra admin center, create an app registration in the
customer tenant and record its Application (client) ID and
Directory (tenant) ID.
-
Add the Graph application permission.
Open API permissions → Add a permission → Microsoft Graph →
Application permissions, then add
ExchangeMessageTrace.Read.All.
-
Grant admin consent.
A tenant administrator must select Grant admin consent. Delegated
permission is not used by this tool.
-
Create a credential.
Under Certificates & secrets, upload a certificate
(recommended) or create a short-lived client secret. Copy the
secret value immediately—not its secret ID—because Entra shows
the value only once.
-
Provision the Microsoft Message Trace service principal.
Run the following once as an administrator, then allow several hours
for provisioning:
Connect-MgGraph -Scopes "Application.ReadWrite.All"
New-MgServicePrincipal -AppId "8bd644d1-64a1-4d4b-ae52-2e0cbf64e373"
Credential handling: Enter the client secret value or
upload the PFX below. Credentials are held only in this browser session;
they are not saved by the application. Prefer a certificate for anything
beyond a short demonstration.
Open Microsoft's Message Trace onboarding guide ↗