Tech Article8 min readSeptember 12, 2026

How to have a cohesive Identity Solution

OpenID Connect gives applications one verifiable identity vocabulary across sign-in, federation, sessions, and service access. The value comes from enforcing the claims and boundaries consistently.

OIDCIdentityFederationAuthorization

Identity is the foundation, and will either accelerate you or slow you to a crawl.

In all my experience, the number on aspect of any system is user, and user is identity. Being able to create great product experiences starts with the boring layer of identity. Thankfully the industry has adopted a standard that lets you have a solid foundation, but I've seen people make the huge mistake of not embracing it.

OpenID Connect gives those surfaces a common identity protocol on top of OAuth 2.0. Applications can validate one issuer, identify the subject, confirm the intended audience, and request defined claims. That shared contract makes federation and session policy easier to reason about across the product portfolio.

Issuer and subject form the durable identity key

Treat the combination of issuer and subject as the external identity key. Email addresses and display names can change, and the same email string can appear under different authorities. Preserve provider identity separately from the product's internal person, organization, membership, and entitlement records.

Validate signature, issuer, audience, expiry, nonce, and the authorization flow expected by the client. Reject tokens issued for another application even when the signature is valid. A token proves claims from an authority; the receiving product still decides what those claims permit.

Separate sign-in, session, and API authorization

An ID token communicates authentication claims to the client. An access token authorizes a request to a resource server. A browser session manages the application's continuing relationship with the user. Keeping these artifacts distinct prevents an ID token from drifting into a general API credential.

Map verified identity into an internal authorization model with organizations, roles, resource ownership, and policy decisions. Keep those decisions close to the protected operation. A global role string inside a token rarely captures the object and relationship context required by a mature product.

Federation needs lifecycle policy

Enterprise federation begins with discovery and login, but customers judge the full lifecycle. Define how domains are claimed, how accounts link, what happens when an upstream identity disappears, and how administrators recover access. Provisioning and deprovisioning need evidence independent of an interactive login.

Log identity events with the issuer, subject, client, organization, decision, and correlation identifier. Avoid copying token contents into logs. Operators need enough evidence to reconstruct an access decision without turning sensitive claims into a second identity database.

Make the identity boundary boring

Centralize protocol handling in a tested identity adapter and expose narrow product-facing contracts for sign-in, membership, and authorization. Rotate signing keys, cache discovery documents safely, constrain redirect URIs, and test failure paths such as expired tokens and unavailable providers.

OIDC becomes a backbone when every application follows the same verification and lifecycle rules. Consistency reduces integration effort, shortens enterprise onboarding, and gives security teams one control surface they can inspect.

Continue exploring

Browse the complete Agenty library for practical product, platform, engineering, and AI field notes.

Back to all articles
Top