Recursos · 43
OAuth y OpenID Connect: verificar una integración extremo a extremo
Separe los permisos de inicio de sesión, delegación y datos, luego pruebe las redirecciones, los tokens, las sesiones y la revocación.
Actualizado · 9 min
Lo que esta guía ayuda a lograr
- Separar identidad de autorización
- Rechazar tokens y redirecciones no deseadas
- Pruebe los rechazos con tanto cuidado como los aciertos
- Verificar eliminación de acceso tras salida o incidencia
Comprobación rápida
- ¿Qué proveedor y emisor se espera?
- ¿Está registrada la URI de redireccionamiento de forma precisa?
- ¿Se está utilizando incorrectamente un token ID como token de acceso?
- ¿Cada recurso verifica la propiedad?
- ¿Qué acceso sobrevive a la revocación?
Método paso a paso
- 1
Dibujar el flujo desplegado
Identificar cliente, navegador, servidor de autorización, API y proveedor de OIDC públicos o confidenciales. Registre dónde viajan los códigos y tokens, quién los almacena y qué roles se otorgan. Un diagrama de ventas no establece el despliegue real.
Entregable: flujo, límites de confianza y propietarios de componentes.
- 2
Verificar la transacción de inicio de sesión
Utilizar el flujo de código con PKCE adecuado al cliente. Verifique S256, vinculación de transacciones, redirecciones registradas y protección contra solicitudes falsificadas. Pruebe un URI inesperado, un verificador incorrecto, un código reproducido y un emisor inesperado. RFC 9700 separa los requisitos y recomendaciones por tipo de cliente.
Entregable: resultados de pruebas permitidos y denegados.
- 3
Validar el token correcto
La API valida su token de acceso según formato y reglas del proveedor: firma o introspección, emisor, audiencia, caducidad y permisos. El cliente OIDC valida por separado el token de identidad. Una firma válida no establece que el token pertenezca a esta API.
Entregable: contrato de validación y pruebas de audiencia y caducidad.
- 4
Comprobar permisos empresariales
Probar un objeto propiedad de otra cuenta, un rol inferior, campo privado y operación administrativa. Un alcance o una puerta de enlace autenticada no reemplaza las comprobaciones del lado del servidor en el recurso solicitado. Utilice cuentas y datos de prueba autorizados.
Entregable: rol, objeto, operación y matriz de denegación esperada.
- 5
Caducidad y revocación del ejercicio
Separación de sesión local, sesión de proveedor, token de acceso y token de actualización. Salida de prueba, pérdida de dispositivo, cambio de rol, rotación de clave de firma e interrupción del proveedor. Documente el tiempo de acceso residual en lugar de asumir que el cierre de sesión revoca todo inmediatamente.
Entregable: cronograma de eliminación de acceso y excepciones.
- 6
Observar sin exponer secretos
Referencia de transacciones de registro, decisión de validación, categoría de error y versión de configuración. Excluye códigos, tokens y secretos. Preparar el diagnóstico, el cierre de la integración y la reversión a una configuración validada; repetir las pruebas después de cambiar de proveedor.
Entregable: procedimiento operativo y comprobaciones de regresión.
Ejemplo trabajado ficticio
Situación ilustrativa
Situación ilustrativa: dos clientes utilizan un proveedor de identidad. Un token válido para el primero se presenta a la API del segundo cliente.
Decisión y pruebas esperadas
La API rechaza la audiencia incorrecta, registra un seguimiento sin token y no devuelve datos. La negación se convierte en una prueba de regresión.
Distinguir los mecanismos
| Mecanismo | Propósito | Verificación o limitación |
|---|---|---|
| OAuth 2.0 | Delegar acceso a recursos | Permisos de objetos del lado del servidor |
| Conexión OpenID | Establecer identidad mediante un token ID validado | Validación de emisor, audiencia y transacciones |
| Sesión de aplicación | Mantener el inicio de sesión de la aplicación | Caducidad, invalidación y protección de sesión |
Indicadores de gestión
| Indicador | Qué mide | Primera acción |
|---|---|---|
| Corregir denegaciones | Casos prohibidos realmente bloqueados | Arreglar cada aceptación inesperada |
| Retraso de revocación | Tiempo hasta que desaparece el acceso relevante | Consultar sesiones y tokens por separado |
| Fallos de validación | Rechazos por causa y versión | Separar ataques de errores de configuración |
Errores comunes
- Confundir autenticación con autorización
- Aceptar cualquier audiencia tras comprobar la firma
- Registro de URI de redireccionamiento amplio
- Registro de tokens para una depuración más sencilla
Preguntas frecuentes
¿PKCE reemplaza todos los controles?
No. Protege el intercambio de código en el flujo previsto; La validación del token, las redirecciones, la autorización comercial y las sesiones aún deben verificarse.
¿Un JWT es un permiso?
JWT es un formato. Los reclamos se vuelven utilizables solo después de la validación y aplicación de sus reglas API.
¿Se debe construir la validación desde cero?
Prefiere una biblioteca mantenida y documentación del proveedor, luego prueba tu configuración. Una biblioteca correcta aún puede configurarse incorrectamente.
¿Qué pruebas conservar para una verificación útil?
Conserve contexto de cuenta, roles, recurso y respuestas API. Un inicio de sesión correcto no demuestra permisos correctos; no guarde secretos de sesión.
OAuth/OIDC: audiencia y acceso
Las notas detalladas de esta edición están disponibles en inglés.
Which token belongs to which recipient? A testable validation contract
A secure OAuth/OIDC integration connects each token to its purpose, issuer and intended recipient. An ID token tells the OIDC client about authentication; an access token is presented to a protected resource. Successful sign-in alone does not authorise a read, a change or an AI agent’s tool call.
This reference covers a specific profile: an API consuming JWT access tokens under RFC 9068. OAuth 2.0 does not require every access token to use JWT. Clients must treat their access tokens as opaque; the resource server owns the validation contract. The examples below are fictional, with no secret or usable signature.
Four objects with distinct purposes
| Object | Recipient and purpose | Boundary to retain |
|---|---|---|
| Authorisation code | Authorisation server token endpoint: redeem the code within the intended transaction. | The code is not an API permission; check binding to the client, redirect and PKCE. |
| ID token | OIDC client: validate identity and transaction; aud contains its client_id. | Do not reuse it as an API access credential; apply the OIDC rules for the relevant flow. |
| Access token | Resource server: access within the grant; its audience identifies the intended resource. | Validate the token, then operation and object permissions. The client must not depend on its internal content. |
| Refresh token | Authorisation server token endpoint: obtain new access tokens. | Do not send it to the resource server; its lifecycle differs from the local session. |
Eight controls for the validation contract
| Control | Rule and scope | Evidence without tokens |
|---|---|---|
| Profile and typ | For RFC 9068, check typ = at+jwt or application/at+jwt. Other profiles need their own rules; “any signed JWT” is too broad a contract. | Configured profile and a rejected ID/access token confusion case. |
| Algorithm and keys | Verify the signature with the expected issuer’s keys and algorithms allowed by configuration. RFC 9068 excludes alg = none; a received value does not set policy by itself. | Cryptographic policy version and result, with no secret material. |
| Issuer iss | Compare exactly with the expected issuer. A similar host, path or suffix does not establish trust. | Configuration reference and issuer_mismatch reason. |
| Audience aud | The expected recipient must appear in aud. An audience array is possible; finding the recipient does not replace other checks. | Expected resource and a test using a token intended for another API. |
| Expiry exp | Current time must precede exp; any small clock leeway is an explicit policy. The teaching fixture uses zero seconds of leeway. | Test clock, configured leeway and an exercised expiry boundary. |
| Scopes and object | Bind each scope to the resource and operation. Then check ownership, tenant and business policy on the server. RFC 9068 does not define all this authorisation. | Action, test object, applied rule and a cross-tenant denial. |
| OIDC transaction and PKCE | If nonce was sent, verify its presence and equality in the ID token. RFC 9700 requires PKCE for public clients and recommends it for confidential clients; bind the challenge to the transaction, with S256 recommended. | Wrong nonce, replayed code and wrong code_verifier tests in the authorised flow. |
| Access lifetime and removal | Separate access-token expiry, renewal and application session. RFC 9700 requires sender constraint or rotation to detect refresh-token replay for public clients. | Residual access timeline, user departure and an exercised revocation procedure. |
Read fictional claims without treating them as proof
Teaching clock: 2026-10-22 at 10:00:00 UTC. The JSON contains a readable header and claims only; no signed JWT serialization is supplied. exp is 10:05:00 UTC and iat is 09:59:00 UTC. The .example domains and identifiers belong solely to this scenario.
{
"header": {
"typ": "at+jwt",
"alg": "RS256",
"kid": "training-key-01"
},
"claims": {
"iss": "https://identity.example/",
"sub": "training-subject-17",
"aud": "https://api.example/evidence",
"exp": 1792663500,
"iat": 1792663140,
"jti": "training-event-001",
"client_id": "training-console",
"scope": "evidence:read"
}
}Decoding JSON does not validate a signature or establish trust in keys. Where stated, cryptography is an exercise assumption, never a check performed by this page. The profile also has required claims including sub, client_id, iat and jti: the eight-control table is not a complete validator. A subject does not necessarily identify a person; jti alone does not implement replay protection.
Ten review cases: decision, limit and expected evidence
01 · Token intended for the API: continue to business checks
Situation: iss, aud, typ and exp match the fictional contract; evidence:read is present. Signature verification is assumed solely for the exercise.
Decision: continue to operation and object checks, without automatically declaring “access allowed”. Expected evidence: business rule and test object reviewed separately.
02 · Assumed correct signature, wrong audience
Change: aud targets https://api.example/billing rather than the evidence resource. Other assumptions remain the same.
Decision: reject this token for this API. A correct signature does not change its recipient. Expected evidence: no resource content returned and a token-free audience failure record.
03 · Different issuer with plausible claims
Change: iss is https://other-identity.example/. An HTTPS URL does not make it equivalent to the configured issuer.
Decision: reject the issuer match. Expected evidence: exact comparison with https://identity.example/ and a regression test.
04 · Expiry reached at the exact second
Change: exp equals the test clock, 10:00:00 UTC, with zero seconds of leeway in this fixture.
Decision: reject as expired. “Now is before exp” is false at equality; this example does not establish a universal clock policy. Expected evidence: tests before, at and after the boundary under the real policy.
05 · ID token presented as an access token
Change: a fictional ID token has typ = JWT and aud = training-console. It targets the OIDC client.
Decision: reject it as an RFC 9068 JWT access token. Validating it at the OIDC client does not turn it into an access token. Expected evidence: separate validation rules for each token type.
06 · Write scope presented for a read operation
Change: scope is evidence:write while the call requires evidence:read.
Decision: deny the read under the exercise policy, which defines no write → read implication. Scope names and relationships belong to the contract. Expected evidence: an explicit operation/scope matrix, without inferring permissions from names.
07 · Readable JSON, unverified cryptography
Situation: the JSON is readable and values appear to match, but cryptographic validation and trusted keys are not established.
Decision: stop acceptance; the state is unverified. Expected evidence: configured library output and trust-contract checks. Reading claims alone must not release protected data.
08 · Correct token, another tenant’s object
Situation: test token checks are assumed to pass. The requested object belongs to another tenant and business policy denies this read.
Decision: deny the object. evidence:read does not grant access to every account’s evidence. Expected evidence: server-side cross-tenant test and no leakage through content or returned fields.
09 · Audience array containing the expected resource
Change: aud contains https://api.example/evidence and https://api.example/archive. The expected resource is listed.
Decision: this audience check can pass; continue all other checks. An array is not a wildcard. Expected evidence: scopes remain meaningful for the resource, with no ambiguous grant.
10 · ID token nonce differs from the transaction
Separate OIDC transaction, outside the API cases: sent nonce = training-transaction-A; received nonce = training-transaction-B.
Decision: reject the ID token for this transaction under OIDC Core §3.1.3.7. This does not replace PKCE or API rules. Expected evidence: compare with the original transaction and test missing nonce when one was sent.
Six useful acceptance-review records
- Map clients, issuers, APIs and expected audiences, with an owner for each boundary.
- Versioned validation contract: format, libraries, trusted keys, algorithms and clock leeway.
- Action, scope, tenant and object matrix; state denials and the permission implications actually defined.
- Synthetic fixtures, a fixed clock, negative variants and observed results in the authorised environment.
- Separate session, access-token and refresh-token timelines during departure, revocation and provider outage.
- Redacted log: internal transaction reference, policy version, decision reason and date; exclude tokens, codes and secrets.
Primary sources and reading scope
- IETF · RFC 9700 · OAuth 2.0 Security BCP · BCP 240 · January 2025
§2.1.1 PKCE · §2.2 replay · §2.3 privilege restriction · §4.14 refresh tokens - IETF · RFC 9068 · JWT access token profile · Standards Track · October 2021
§2.1 typ · §2.2 claims · §4 validation · §6 client treats access tokens as opaque - OpenID Foundation · OpenID Connect Core 1.0 · Final · incorporating errata set 2 · 2023-12-15
§2 ID Token · §3.1.3.7 issuer, audience, expiry and nonce - IETF · RFC 8725 · JWT Best Current Practices · BCP 225 · February 2020
§3.1 algorithms · §3.8–3.9 issuer and audience · §3.11–3.12 token type separation - IETF · RFC 6749 · OAuth 2.0 framework · Standards Track · October 2012 · read with RFC 9700
§1.3.1 authorization code · §1.4 access token · §1.5 refresh token · §3.3 scope
Sources reviewed on
Referencias oficiales
Las referencias respaldan el método. Adapte los controles a su contexto; no constituyen certificación. Los títulos de referencia originales y los documentos fuente pueden estar en otro idioma.
Referencias consultadas el .
