OAuth 2.0

The OAuth 2.0 framework is built around four distinct entities that interact during an authorization flow.

• Resource Owner: The entity (often a user or a service account) capable of granting access to a protected resource.
• Client: The application (e.g., an autonomous agent or a microservice) requesting access to the resource on the owner's behalf.
• Authorization Server: The server that authenticates the resource owner, obtains consent, and issues access tokens to the client. This is the central security authority (e.g., Keycloak, Auth0, Okta).
• Resource Server: The server hosting the protected resources (e.g., an API or a data store), which accepts and validates access tokens to fulfill requests.

This is the most common and secure flow for server-side web applications and native apps. It involves a two-step process to separate the authorization grant from the access token.

• The client redirects the resource owner (user) to the authorization server.
• After authentication and consent, the server redirects back to the client with a short-lived authorization code.
• The client then exchanges this code, along with its client secret, for an access token and often a refresh token via a secure back-channel request.
• This flow keeps the access token hidden from the resource owner's browser, mitigating exposure risks.

This flow is designed for machine-to-machine (M2M) or service-to-service communication where a specific user context does not exist. It is ideal for authorizing autonomous agents or backend services.

• The client (an agent) authenticates directly with the authorization server using its own credentials (client ID and secret).
• The server validates these credentials and returns an access token.
• This token represents the application's own authority, not a delegated user's. It is used for accessing resources under the client's control, such as administrative APIs or shared data lakes.

Access tokens are the bearer credentials used by a client to access protected resources. They are typically short-lived JSON Web Tokens (JWTs) containing claims about the authorization.

• Scopes are a critical security mechanism that limits an access token's power. They are space-separated strings defining the granular permissions granted (e.g., read:data, write:log, agent:execute).
• The resource server must validate the token's signature, expiry, and intended audience (aud claim), and then check that the token's scopes permit the requested action. This enforces the principle of least privilege.

Refresh tokens are long-lived credentials used solely to obtain new access tokens, minimizing the exposure of primary client credentials.

• When a short-lived access token expires, the client can send the refresh token to the authorization server's token endpoint.
• The server issues a new access token (and potentially a new refresh token).
• This allows for continuous operation of long-running agents without requiring re-authentication, while allowing the system to rotate access tokens frequently for security. Refresh tokens must be stored with the highest security, equivalent to the original client secrets.

Applying OAuth 2.0 to multi-agent systems introduces specific considerations beyond standard web apps.

• Agent-as-Client: Each autonomous agent must be registered as a confidential OAuth client with its own credentials, enabling individual audit trails and revocation.
• Dynamic Discovery: Agents may need to discover authorization and resource server endpoints dynamically using standards like OAuth 2.0 Authorization Server Metadata.
• Token Exchange: Complex orchestration may require the RFC 8693 Token Exchange grant type, allowing an agent to exchange a token it holds for a new one suitable for a different service, facilitating secure delegation chains.
• JWT Assertions: Agents can authenticate using signed JWT assertions instead of static secrets, enabling more secure, certificate-based authentication for non-interactive clients.

A JSON Web Token (JWT) is a compact, URL-safe token format defined in RFC 7519, used to securely transmit claims between parties. In OAuth 2.0, JWTs are commonly used as access tokens or ID tokens.

• Structure: A JWT consists of three Base64Url-encoded parts separated by dots: a header (specifying algorithm), a payload (containing claims), and a signature.
• Self-Contained: Unlike opaque reference tokens, JWTs carry verifiable information within themselves, enabling stateless validation by resource servers using a public key.
• Common Use: The id_token in OpenID Connect (an identity layer on top of OAuth 2.0) is a JWT containing user authentication information.

Mutual TLS (mTLS) is an authentication protocol where both the client and the server present and validate each other's X.509 digital certificates, establishing a mutually authenticated and encrypted TLS connection.

• OAuth 2.0 Integration: Used for client authentication (e.g., confidential clients like backend services) and securing communication between authorization servers, resource servers, and clients.
• Enhanced Security: Provides stronger authentication than client secrets, as it's based on cryptographic proof of possession of a private key. It is a recommended method for securing machine-to-machine (M2M) OAuth flows.
• Certificate-Bound Access Tokens: An extension (RFC 8705) binds an access token to a specific client certificate, preventing token replay if the certificate is stolen.

Role-Based Access Control (RBAC) is an authorization model where permissions to perform operations are assigned to roles, and users or system entities (like agents) are assigned to those roles.

• OAuth 2.0 Scope Mapping: OAuth scopes (e.g., read:data, write:data) often map to high-level permissions associated with RBAC roles. An access token's scopes define the what, while RBAC policies on the resource server define the how for a given role.
• Decentralized Enforcement: The authorization server issues tokens with scopes/claims, but the resource server makes final access decisions by evaluating the token's claims against its internal RBAC policy engine.
• Agent Authorization: In multi-agent systems, agents can be assigned roles, and their OAuth tokens carry corresponding role claims for fine-grained API access control.

OpenID Connect (OIDC) is a simple identity layer built on top of the OAuth 2.0 protocol. It allows clients to verify the identity of an end-user based on authentication performed by an authorization server.

• Core Component: The ID Token, a JWT containing claims about the user's authentication event (e.g., subject, issuer, expiration).
• UserInfo Endpoint: A standardized API (/userinfo) that returns additional claims about the authenticated user, accessible with a valid access token.
• Authentication Flows: OIDC defines specific OAuth 2.0 flows (like Authorization Code Flow) optimized for authentication, adding parameters like nonce and prompt to prevent replay attacks and control login behavior.

Proof Key for Code Exchange (PKCE, pronounced "pixy") is an extension to the OAuth 2.0 Authorization Code flow, designed to secure public clients (like mobile and single-page apps) that cannot store a client secret.

• Mechanism: The client creates a cryptographically random code verifier and derives a code challenge from it. The challenge is sent when requesting the authorization code; the verifier is sent when exchanging the code for a token.
• Primary Defense: Mitigates the authorization code interception attack, where a malicious actor intercepts the authorization code from a public client. Without the original code verifier, the attacker cannot exchange the code for a token.
• RFC 7636: PKCE is defined in RFC 7636 and is now considered a security best practice for all OAuth 2.0 authorization code flows, not just public clients.

Token Introspection is an OAuth 2.0 extension (RFC 7662) that defines a standard method for a protected resource (or any authorized service) to query the authorization server about the active state and meta-information of an access token.

• How it Works: The resource server sends a POST request to the authorization server's introspection endpoint with the token. The server responds with a JSON object indicating if the token is active, along with its scopes, client ID, expiration, and other claims.
• Use Case: Essential for validating opaque tokens (random strings) that cannot be self-validated like JWTs. It allows the authorization server to be the single source of truth for token validity, enabling immediate revocation.
• Security: The introspection endpoint itself must be secured, typically using mTLS or a client credential grant between the resource server and authorization server.