Identity Authentication verified

OpenID Connect

OpenID Connect, usually called OIDC, is the sign-in layer that sits on top of OAuth 2.0. OAuth answers how an app gets access to a resource; OIDC adds a reliable way to prove who the user is. In Azure, developers meet it when configuring Microsoft Entra app registrations, redirect URIs, ID tokens, scopes, and authentication libraries. It is the reason an application can send a user to Microsoft sign-in, receive identity claims, and start a trusted session.

Aliases
OIDC, OpenID Connect protocol, Microsoft identity platform OIDC, Entra ID OpenID Connect, ID token sign-in
Difficulty
fundamentals
CLI mappings
7
Last verified
2026-05-17

Microsoft Learn

OpenID Connect is an authentication protocol layer built on OAuth 2.0. In Microsoft Entra ID, apps use it for single sign-on by requesting ID tokens, discovering provider metadata, validating claims, and securely combining sign-in with access-token acquisition when needed.

Microsoft Learn: OpenID Connect (OIDC) on the Microsoft identity platform2026-05-17

Technical context

In Azure architecture, OpenID Connect belongs to the identity control plane and application authentication boundary. Microsoft Entra ID acts as the identity provider, while the application is the relying party that requests tokens from endpoints discovered through the well-known OpenID configuration document. The term connects app registrations, client IDs, redirect URIs, tenant authorities, scopes, ID tokens, token validation libraries, conditional access, and federation. It usually appears before data-plane access because the app must establish identity before calling APIs or resources.

Why it matters

OpenID Connect matters because sign-in failures are rarely harmless. A wrong authority, redirect URI, token setting, or claim assumption can block users, leak session state, or let an app trust an identity it should not trust. For architects, OIDC is the boundary between authentication and authorization, so it clarifies why an ID token is not the same as an access token. For operators, it gives concrete artifacts to inspect during incidents: client ID, tenant, response type, nonce, state, metadata URL, token issuer, and signing keys. For businesses, good OIDC design improves single sign-on, reduces password handling, supports partner access, and makes identity evidence easier to audit.

Where you see it

Signals, screens, and Azure surfaces where this term usually becomes operational.

Signal 01

In Microsoft Entra app registrations, OIDC appears beside redirect URIs, platform settings, implicit ID token options, client IDs, and endpoint links during readiness checks for applications.

Signal 02

In browser traces and application logs, it shows as authorize requests, response types, nonce, state, ID tokens, token validation errors, and redirect URI failures during support escalations.

Signal 03

In Microsoft Entra sign-in logs, operators see OIDC-related failures through application IDs, user principals, conditional access results, token issuer, and correlation IDs during incident triage.

When this becomes relevant

Specific situations where this term helps solve real Azure design, operations, migration, security, reliability, cost, or governance problems.

  • Enable single sign-on for a web app with Microsoft Entra ID.
  • Troubleshoot ID token, redirect URI, tenant authority, and consent failures.
  • Document authentication boundaries before granting API access to signed-in users.

Real-world case studies

Different enterprise-style examples that show the term being used to hit measurable objectives.

Case study 01

SaaS sign-in modernization for a legal collaboration platform

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

Briefwell Legal ran a document collaboration portal for law firms. Customers wanted single sign-on, but the product still stored local passwords and produced weak audit evidence during client reviews.

Business/Technical Objectives
  • Move customer sign-in to Microsoft Entra ID without changing document permissions.
  • Reduce password reset tickets by at least 50% in two quarters.
  • Capture tenant, client ID, and sign-in evidence for regulated customers.
  • Keep partner access separate from internal administrator access.
Solution Using OpenID Connect

The engineering team registered the portal as a Microsoft Entra application and implemented OpenID Connect through a supported web authentication library. Each customer tenant used a documented authority, approved redirect URI, and verified client ID. ID token validation checked issuer, audience, nonce, lifetime, and signing keys, while API authorization still used application roles inside the product. Operators used Azure CLI and Microsoft Entra sign-in logs to confirm service principal creation, owner assignments, and failed authentication reasons. The security team also removed unused reply URLs, stored certificates in Key Vault, and documented a rollback plan that restored the previous authentication configuration only for emergency use. Customer success received a short checklist so each law firm could validate SSO before its final cutover window.

Results & Business Impact
  • Password reset tickets fell 64% after three months of customer migrations.
  • Enterprise onboarding time dropped from ten business days to four business days.
  • Audit packets included tenant IDs, client IDs, redirect URIs, and sign-in log samples.
  • No customer document authorization rules changed during the authentication migration.
Key Takeaway for Glossary Readers

OpenID Connect lets applications outsource sign-in to Microsoft Entra ID while still requiring careful ownership of token validation and authorization boundaries.

Case study 02

Member access for a museum digital archive

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

North Pier Museum opened a digital archive for curators, paid members, and academic researchers. The team needed friendly sign-in while preserving strong separation between public membership access and internal collection administration.

Business/Technical Objectives
  • Support single sign-on for employees and invited researchers.
  • Keep archive administration restricted to museum-owned accounts.
  • Reduce failed login investigations during exhibition launches.
  • Document guest access rules for the board security committee.
Solution Using OpenID Connect

The application team used OpenID Connect with Microsoft Entra ID for employee sign-in and configured a separate external identity flow for researchers. App registrations used distinct redirect URIs for public preview, staging, and production so token responses could not land on the wrong host. The archive application validated ID token issuer and audience, then mapped trusted claims to internal membership records. Operators built a CLI review that exported app registration owners, redirect URIs, credentials, and enterprise application assignments before each launch. Sign-in logs were filtered by application ID and correlation ID so support could tell the difference between consent problems, conditional access blocks, and expired invitations. Administrative functions required a separate role check after authentication, not just possession of an ID token.

Results & Business Impact
  • Launch-week login tickets dropped 47% compared with the previous online exhibition.
  • Board review evidence showed separate public, researcher, and staff identity paths.
  • Two stale redirect URIs were removed before production because the CLI review exposed drift.
  • Curator administration remained limited to employee accounts with approved role assignments.
Key Takeaway for Glossary Readers

OpenID Connect is powerful for inclusive sign-in, but operators must still define exactly which tenants, accounts, and roles are trusted.

Case study 03

Driver mobile authentication for a freight logistics network

Scenario, objectives, solution, measured impact, and takeaway.

Scenario

AxleRoute Logistics operated driver apps in North America and Europe. Regional teams had created different app registrations, causing intermittent sign-in failures and inconsistent token claims.

Business/Technical Objectives
  • Standardize mobile application OIDC settings across regions.
  • Reduce failed sign-ins during route dispatch windows.
  • Preserve regional data access controls after authentication.
  • Create repeatable evidence for incident and compliance reviews.
Solution Using OpenID Connect

Identity engineers consolidated the driver apps around a documented OpenID Connect pattern. Each region kept its own application registration, but naming, redirect URI rules, platform configuration, token validation settings, and owner groups followed one template. The mobile backend used a tenant-specific authority, validated ID tokens with a maintained library, and then exchanged authenticated sessions for regional API authorization. Azure CLI checks exported app IDs, platform reply URLs, credential expiration dates, and owner lists into a release record. During rollout, operators monitored sign-in logs, mobile telemetry, and dispatch API errors by region. A rollback plan retained the previous app registration for one release cycle while new token claims were compared against route assignment rules.

Results & Business Impact
  • Morning dispatch sign-in failures dropped from 8.5% to 1.9% within six weeks.
  • Regional support teams used one runbook instead of three conflicting identity procedures.
  • Credential expirations were found thirty days earlier through scheduled CLI evidence exports.
  • No cross-region route data exposure occurred because API authorization stayed separate from OIDC sign-in.
Key Takeaway for Glossary Readers

OpenID Connect improves user experience only when token trust, regional authority choices, and downstream authorization stay deliberately controlled.

Why use Azure CLI for this?

Azure CLI is useful for OpenID Connect because identity configuration must be inspected consistently across tenants, environments, and automation accounts. Portal screens are good for learning, but CLI commands help list app registrations, compare redirect URIs, review service principals, export consent and role assignment evidence, and detect drift before production sign-in changes. CLI output also gives security teams repeatable proof during audits and incident reviews.

CLI use cases

  • Inventory app registrations and service principals that participate in OIDC sign-in for a product or environment.
  • Inspect redirect URIs, client IDs, sign-in audience, certificates, secrets, and identifier URIs before deployment.
  • Review consent grants, app role assignments, and owner lists to confirm who can change authentication behavior.
  • Export identity configuration as JSON so teams can compare staging and production OIDC settings safely.

Before you run CLI

  • Confirm the tenant, subscription context if resources are involved, application object ID, client ID, and required Microsoft Graph permissions.
  • Use least-privilege identity roles because app registration updates can change who signs in and where tokens are returned.
  • Check whether commands are read-only or will update redirect URIs, credentials, audience, owners, or federated identity settings.
  • Prefer JSON output for automation, avoid printing secrets, and record before-and-after evidence for identity change reviews.

What output tells you

  • Application and client IDs identify which registration the application actually uses, avoiding confusion with display-name duplicates.
  • Redirect URI, sign-in audience, and token settings reveal whether the expected platform and tenant authority can complete sign-in.
  • Owner, credential, and service principal fields show who can administer the OIDC trust path and when credentials expire.
  • Role assignment and consent output separates authentication setup from authorization grants that let the signed-in identity call APIs.

Mapped Azure CLI commands

OpenID Connect operator commands

operator-workflow
az ad app list --display-name <app-display-name> --output table
az ad appdiscoverIdentity
az ad app show --id <app-id-or-object-id> --output json
az ad appdiscoverIdentity
az ad app update --id <app-id-or-object-id> --web-redirect-uris <redirect-uri-1> <redirect-uri-2>
az ad appsecureIdentity
az ad app owner list --id <app-id-or-object-id> --output table
az ad app ownerdiscoverIdentity
az ad app permission list --id <app-id-or-object-id> --output json
az ad app permissiondiscoverIdentity
az ad app federated-credential list --id <app-id-or-object-id> --output table
az ad app federated-credentialdiscoverIdentity
az ad sp show --id <app-id> --output json
az ad spdiscoverIdentity

Architecture context

In Azure architecture, OpenID Connect belongs to the identity control plane and application authentication boundary. Microsoft Entra ID acts as the identity provider, while the application is the relying party that requests tokens from endpoints discovered through the well-known OpenID configuration document. The term connects app registrations, client IDs, redirect URIs, tenant authorities, scopes, ID tokens, token validation libraries, conditional access, and federation. It usually appears before data-plane access because the app must establish identity before calling APIs or resources.

Security

Security impact is direct because OpenID Connect controls how an application trusts a signed-in user. Teams must validate ID token issuer, audience, signature, lifetime, nonce, and relevant claims instead of simply accepting a token string. Redirect URIs must match registered values, state should defend against cross-site request forgery, and nonce should reduce replay risk. Secrets, certificates, and federated credentials need least-privilege storage and rotation. Conditional Access, multifactor authentication, tenant restrictions, and consent policies shape who can sign in. Misusing ID tokens for API authorization, accepting tokens from the wrong tenant, or logging tokens in diagnostics can create serious exposure. Treat tokens as sensitive evidence.

Cost

OpenID Connect has no separate Azure billing meter, but it still affects cost through engineering time, support load, security tooling, and dependent service choices. Poorly configured sign-in can generate incident response hours, failed releases, abandoned user journeys, and extra help desk tickets. Some scenarios require Microsoft Entra ID premium features, stronger conditional access controls, external identity planning, or managed certificates. Logging sign-in events into Sentinel or Log Analytics also creates retention and ingestion cost. FinOps ownership should include identity platform costs, token-related monitoring, testing environments, and the operational expense of maintaining many app registrations across tenants. These costs deserve ownership reviews.

Reliability

Reliability impact is direct because authentication is often the first dependency every user touches. If OIDC metadata cannot be reached, signing keys rotate without client refresh, redirects are misconfigured, or cookies conflict across environments, the app can appear completely unavailable even when compute and databases are healthy. Reliable teams use supported authentication libraries, monitor sign-in errors, test token renewal, and avoid hard-coding discovery endpoints or signing keys. They verify tenant-specific authorities for guest scenarios and rehearse certificate or secret rotation. Rollback should include previous app registration settings, redirect URIs, and deployment configuration so identity changes can be reversed quickly. Test recovery regularly.

Performance

Runtime performance impact is usually indirect but visible to users during sign-in and token renewal. OIDC adds redirects, metadata discovery, token validation, cookie issuance, and sometimes calls to user information or authorization endpoints. Slow identity provider reachability, oversized tokens, excessive claims, repeated consent prompts, or broken silent renewal can increase page-load time and frustrate users. Application teams should cache provider metadata safely, use mature libraries, keep claim sets lean, and avoid synchronous calls that duplicate token validation work. Diagnostic performance also matters because clear logs, correlation IDs, and sign-in event filtering shorten incident investigation. Efficient filtering improves support speed. Good traces matter during troubleshooting.

Operations

Operators handle OpenID Connect by inspecting app registrations, enterprise applications, authentication settings, redirect URIs, token configuration, consent grants, sign-in logs, and application code settings. Routine work includes confirming the tenant authority, client ID, response type, scopes, token lifetime expectations, and whether ID tokens are enabled for the intended platform. Troubleshooting usually compares browser redirect traces, Microsoft Entra sign-in log errors, application logs, and token validation failures. Governance teams document ownership, approved redirect URI patterns, secret rotation schedules, conditional access impact, and emergency contacts because identity outages often cross application, security, and platform teams. Evidence should include app owners and recent configuration changes.

Common mistakes

  • Treating an ID token as proof that the user may call every downstream API without checking authorization separately.
  • Using common or multi-tenant authorities when the application should accept sign-ins only from a specific tenant.
  • Leaving old redirect URIs, secrets, or test reply URLs that broaden the authentication attack surface.
  • Manually parsing tokens in application code instead of using supported token validation libraries and metadata refresh behavior.