Encrypt Online
Theme

Entra Federated Credential Debugger

Compare OIDC claims with the credential configured for your Azure workload

Comparison stays in your browser. Use claims JSON when possible; a complete OIDC token can grant access. No token is sent to Azure.

Token and credentialFor GitHub Actions, AKS, and other OIDC workloads

Use the OIDC token sent to Entra for the exchange, not the Azure access token returned afterward.

Paste one credential or the list returned by Azure CLI. Credentials inside an ARM properties object also work.

Reference time for assertion expiry

Leave empty to use the current time. Time checks apply when exp, nbf, or iat is supplied.

Issuer, subject, and audience

Entra compares these values exactly. Letter case, trailing slashes, and encoded characters can cause a mismatch.

For AADSTS70021 or AADSTS700213, use the assertion and credential from the failing job.

AADSTS70021 and AADSTS700213

These errors report that Entra could not find a matching federated identity credential. Check the issuer (iss), subject (sub), and audience (aud) against the credential on the application or managed identity used by the job.

A GitHub environment subject differs from a branch subject. An AKS issuer's final slash matters. Use the actual values from the failing run. The Entra federation troubleshooting guide includes read-only commands to retrieve your configuration.

Exact subjects and matching expressions

Standard federated credentials require an exact subject match. For a credential with claimsMatchingExpression, issuer and audience are compared here; review the expression against Microsoft's rules for your issuer.

For general claims, use JWT Decode. For storage links that return 403, use the Azure Storage SAS Debugger. A successful token exchange can still be followed by a separate RBAC or resource access error.

Microsoft's federation considerations

Branch subjects, environments, and issuer slashes

Download examples (JSON)

Reproduce a matching GitHub branch credential, an environment-versus-branch mismatch, and an AKS issuer missing its final slash.

A matching GitHub branch credential

A GitHub main-branch assertion has the issuer, subject, and audience configured on the branch credential.

All three values match this branch credential. If a live exchange fails, check the target application, credential propagation, and assertion signature.

Inputs and expected values
  1. Paste Claims JSON into OIDC token or claims JSON.
  2. Paste Credential JSON into Federated credential JSON.
  3. Select Compare credentials and read the issuer, subject, and audience results.
Claims JSON
{
  "iss": "https://token.actions.githubusercontent.com",
  "sub": "repo:example/project:ref:refs/heads/main",
  "aud": "api://AzureADTokenExchange"
}
Credential JSON
{
  "name": "github-main",
  "issuer": "https://token.actions.githubusercontent.com",
  "subject": "repo:example/project:ref:refs/heads/main",
  "audiences": ["api://AzureADTokenExchange"]
}
Issuer matches
true
Subject matches
true
Audience matches
true

An environment subject differs from a branch

A GitHub Production environment assertion is compared with a main-branch credential.

The environment subject differs from the branch subject. Select or configure the credential for the intended workflow environment.

Inputs and expected values
  1. Paste Claims JSON into OIDC token or claims JSON.
  2. Paste Credential JSON into Federated credential JSON.
  3. Select Compare credentials and read the issuer, subject, and audience results.
Claims JSON
{
  "iss": "https://token.actions.githubusercontent.com",
  "sub": "repo:example/project:environment:Production",
  "aud": "api://AzureADTokenExchange"
}
Credential JSON
{
  "name": "github-main",
  "issuer": "https://token.actions.githubusercontent.com",
  "subject": "repo:example/project:ref:refs/heads/main",
  "audiences": ["api://AzureADTokenExchange"]
}
Issuer matches
true
Subject matches
false
Audience matches
true

An AKS issuer needs its final slash

An AKS assertion issuer ends with a slash, but the credential issuer omits it.

Copy the exact cluster issuer into the credential, including its final slash. The Kubernetes subject and audience already match in this example.

Inputs and expected values
  1. Paste Claims JSON into OIDC token or claims JSON.
  2. Paste Credential JSON into Federated credential JSON.
  3. Select Compare credentials and read the issuer, subject, and audience results.
Claims JSON
{
  "iss": "https://eastus.oic.prod-aks.azure.com/example-tenant/example-cluster/",
  "sub": "system:serviceaccount:payments:invoice-api",
  "aud": "api://AzureADTokenExchange"
}
Credential JSON
{
  "name": "aks-invoice-api",
  "issuer": "https://eastus.oic.prod-aks.azure.com/example-tenant/example-cluster",
  "subject": "system:serviceaccount:payments:invoice-api",
  "audiences": ["api://AzureADTokenExchange"]
}
Issuer matches
false
Subject matches
true
Audience matches
true

These synthetic claims compare standard credentials by exact issuer, subject, and audience values. They contain no signed OIDC token. For a live exchange, Entra also checks the token signature and the configuration on the target application or managed identity.

Checked 2026-10-20. From the site's webapp3 directory, run npm run check:citation-evidence to compare the tool results with the saved expectations. The JSON includes every input, expected output, and source hash.

Inputs are not saved. The site may load analytics and advertising. Privacy details.