Skip to main content
cd ../lexicon
sys/docs/lexicon/openid-connect-operational-definition.md
Lexicon

OpenID Connect: The Operational Definition Engineers Need

3 min read

In plain English

Plain definition

OpenID Connect (OIDC) is an identity layer that allows an application to verify who a user is, built as an extension on top of the OAuth 2.0 authorisation framework.

Technical Definition

OpenID Connect adds a standardised authentication and identity-assertion protocol to OAuth 2.0. Where OAuth 2.0 defines how a client obtains an access token to call a protected resource, OIDC additionally issues an ID Token — a signed JSON Web Token (JWT) — carrying verifiable claims about the authenticated subject, such as issuer, subject identifier, audience and expiry. A conforming OpenID Provider exposes discovery metadata, an authorisation endpoint, a token endpoint, a UserInfo endpoint and a JSON Web Key Set (JWKS) that Relying Parties use to validate token signatures.

Operational Relevance

For engineers operating identity-dependent systems, OIDC underpins single sign-on, workload identity federation and machine-to-machine authentication that replaces long-lived static credentials with short-lived, cryptographically verifiable tokens. Correct operation depends on validating the ID Token’s signature, issuer, audience and expiry on every use, keeping the Relying Party’s clock synchronised with the Provider, and rotating signing keys through the published JWKS rather than pinning a single key.

Architecture Relationship

OIDC sits above OAuth 2.0 in the identity stack. OAuth 2.0 governs delegated authorisation — what a client is permitted to access — while OIDC governs authentication and identity assertion — who has been authenticated. A working deployment involves three cooperating roles: the OpenID Provider (the issuer of tokens), the Relying Party (the client application consuming identity), and the resource server that trusts tokens the Provider has issued. Discovery metadata, typically published at a well-known configuration path, lets a Relying Party locate the Provider’s endpoints and signing keys without hard-coding them, which supports key rotation and provider migration without client redeployment.

Example

A platform team wants to remove long-lived cloud credentials from a CI/CD pipeline. In an isolated, non-production validation environment, they configure the pipeline’s runner to request an OIDC ID Token from its identity provider, then present that token to the target cloud platform’s security token service in exchange for short-lived, scoped credentials. Before promoting the workflow, the team confirms token audience restrictions, expiry handling and key rotation behaviour under test conditions, and verifies that a revoked or expired token is rejected rather than silently accepted.

Misunderstanding

A frequent misunderstanding is treating OIDC as simply ‘OAuth with a login screen’. OAuth 2.0 alone proves that a client holds a valid access grant; it does not define a standard way to assert who the underlying subject is. Two systems that each implement ‘login with OAuth’ independently are not guaranteed to be interoperable or to convey verified identity, because only OIDC’s ID Token, claims and discovery metadata provide the standardised identity assertion that separate OAuth implementations lack.

  • OAuth 2.0
  • JSON Web Token (JWT)
  • Identity Provider
  • Relying Party
  • Single Sign-On (SSO)

Further Reading

Engineers implementing or auditing an OIDC workflow should confirm the current OpenID Connect Core specification and their Identity Provider’s supported profile directly against the OpenID Foundation’s published specifications before relying on version-specific behaviour, since specification detail and errata change over time. The RFC Editor’s series remains a useful reference for the wider Internet standards context in which related protocols such as OAuth 2.0 are defined.