# OAuth

## Qué es

OAuth es un protocolo que permite a una aplicación utilizar los datos de una
persona alojados en otro servicio, con su aprobación y dentro de unos límites
que puede ver, sin que la aplicación llegue a conocer su contraseña. La versión
en uso es OAuth 2.0, publicada por el IETF en octubre de 2012 como RFC 6749, y
se encuentra escrita como OAuth 2.0 y OAuth2 con tanta frecuencia como
simplemente OAuth. Sustituyó a OAuth 1.0, y ambas versiones son incompatibles.

La especificación distingue cuatro roles. El propietario del recurso es quien
puede conceder acceso, normalmente una persona. El servidor de recursos contiene
los datos protegidos y responde a peticiones que incluyen un token. El cliente
es la aplicación que quiere acceder: una aplicación web, una aplicación de
teléfono, un script o un agente de IA. El servidor de autorización inicia la
sesión del propietario, le pide su consentimiento y emite tokens. Un producto
pequeño puede ejecutar el servidor de recursos y el servidor de autorización
como un único sistema; una empresa suele tener un proveedor de identidad delante
de muchas API.

El cliente recibe un token de acceso, una cadena que representa un alcance y una
duración de acceso concretos. Envía el token con cada petición al servidor de
recursos. El RFC describe esa cadena como normalmente opaca para el cliente: el
cliente la transporta, pero no está destinada a que la lea. El servidor de
autorización también puede entregar un token de actualización, que el cliente
canjea por un nuevo token de acceso cuando caduca el anterior, sin volver a
preguntar a la persona.

Un cliente obtiene su primer token mediante una concesión. El RFC 6749 define
cuatro: código de autorización, implícita, credenciales de contraseña del
propietario del recurso y credenciales de cliente. La de credenciales de cliente
sirve para un programa que actúa en su propio nombre, sin una persona
involucrada. La concesión de código de autorización es la relevante para todo lo
demás, porque las recomendaciones de seguridad actuales han retirado las
concesiones implícita y de contraseña. Esas recomendaciones, junto con la prueba
de clave para el intercambio de códigos (Proof Key for Code Exchange, PKCE) y
las reglas de los tokens al portador, se están integrando en un único documento
OAuth 2.1 del IETF. En su decimosexto borrador, fechado el 3 de septiembre de
2026, sigue siendo un Internet-Draft, un trabajo en curso y no un estándar.

OAuth trata de autorización, no de autenticación. Un token indica a la API lo
que puede hacer el cliente; no le dice al cliente de forma fiable quién es la
persona. Iniciar sesiones a partir de OAuth es la función de OpenID Connect, que
añade un token destinado a que lo lea el cliente.

## Por qué importa

El RFC 6749 empieza por el problema que pretendía eliminar. Para permitir que
una aplicación de terceros accediera a sus datos, usted le daba su contraseña.
La aplicación tenía entonces que almacenarla, normalmente en texto claro. Podía
acceder a todo lo que permitiera la contraseña y durante el tiempo que quisiera.
Solo podía cortar el acceso de una aplicación cambiando la contraseña, lo que
también cortaba el de todas las demás. Y cuando alguna sufría una intrusión,
quedaban comprometidos la contraseña y todo lo que protegía. OAuth elimina cada
uno de esos problemas: la aplicación nunca posee la contraseña, el token tiene
un alcance y una caducidad, y puede retirarse el acceso de un cliente sin
afectar a los demás.

Un equipo se encuentra con OAuth desde ambos lados. Cuando usted es responsable
de una API, OAuth permite que socios, integraciones y herramientas de los
propios clientes la llamen en nombre de un usuario sin que nadie almacene la
contraseña de otra persona. Cuando consume una API, OAuth es lo que ofrecen
calendarios, buzones, sistemas contables y almacenes de archivos, de modo que la
parte cliente es código que su equipo escribe y mantiene. Los agentes de IA que
actúan por una persona ocupan el mismo lugar que cualquier otro cliente: deberían
tener un token limitado a lo que esa persona permitió, nunca sus credenciales.

Los alcances convierten el mínimo privilegio en algo que un servidor puede hacer
cumplir. Un token que permita a un servicio de impresión leer fotos no debería
permitirle borrarlas, y otro emitido para una API debería ser rechazado por
otra. Las recomendaciones de seguridad del IETF de 2025, el RFC 9700, piden
precisamente eso: limitar los privilegios de un token de acceso al mínimo
necesario para el caso de uso y restringir los tokens al servidor de recursos
para el que se emitieron.

## Cómo se aplica en la práctica

El propio RFC ilustra el caso de un servicio de impresión que quiere obtener
fotos de un sitio donde se comparten imágenes. Este es el intercambio mediante
la concesión de código de autorización con PKCE, la forma que las
recomendaciones actuales piden utilizar a todos los clientes. Antes de nada, el
cliente genera un verificador de código aleatorio de entre 43 y 128 caracteres y
lo guarda para sí. Calcula su hash con SHA-256 y redirige el navegador de la persona al servidor
de autorización con el resultado codificado en base64url, el desafío de código:

```http
GET /authorize?response_type=code&client_id=s6BhdRkqt3&state=xyz
    &redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb
    &code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
    &code_challenge_method=S256 HTTP/1.1
Host: server.example.com
```

El servidor de autorización inicia la sesión de la persona, muestra lo que
solicita el servicio de impresión y, cuando esta lo aprueba, redirige el
navegador de vuelta con un código de autorización de corta duración. El cliente
comprueba que `state` tenga el valor que envió:

```http
HTTP/1.1 302 Found
Location: https://client.example.com/cb?code=SplxlOBeZQQYbYS6WxSbIA
          &state=xyz
```

El código no vale nada por sí solo. El cliente lo canjea mediante una petición
HTTPS al endpoint de tokens del servidor de autorización y esta vez envía el
propio verificador:

```http
POST /token HTTP/1.1
Host: server.example.com
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&code=SplxlOBeZQQYbYS6WxSbIA
&redirect_uri=https%3A%2F%2Fclient%2Eexample%2Ecom%2Fcb
&client_id=s6BhdRkqt3
&code_verifier=dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk
```

El servidor calcula el hash del verificador, lo compara con el desafío que
guardó junto al código y solo si coinciden devuelve los tokens, marcados para
que ninguna caché los almacene:

```http
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Cache-Control: no-store
Pragma: no-cache

{
  "access_token":"2YotnFZFEjr1zCsicMWpAA",
  "token_type":"Bearer",
  "expires_in":3600,
  "refresh_token":"tGzv3JOkF0XG5Qx2TlKWIA"
}
```

A partir de ahí, el cliente envía `Authorization: Bearer 2YotnFZFEjr1zCsicMWpAA` en cada llamada a la API de fotos. Una
hora después, el token ha caducado, la API responde con `401 Unauthorized` y `error="invalid_token"` en su cabecera
`WWW-Authenticate`, y el cliente canjea el token de actualización por uno nuevo. Pedir algo
fuera del alcance concedido recibe, en cambio, `403 Forbidden` e `insufficient_scope`. El verificador protege
contra el uso de un código interceptado: un código copiado del dispositivo durante
su transmisión, el ataque contra el que se diseñó inicialmente PKCE, no puede
canjearlo nadie que carezca del verificador, y el propio verificador no se envió
en la petición de autorización ni en la redirección del navegador.

Esa misma delegación permite que el software participe en flujos de trabajo con
agentes. En la página de este sitio sobre [convertir software empresarial existente en herramientas que puedan invocar agentes de IA](/es/ai-tools/), OAuth proporciona el acceso
delegado: un agente actúa en nombre de un usuario sin intercambiar una
contraseña y solo dentro de los permisos de ese usuario.

## Dónde surgen los problemas

**Una comprobación de redirección permisiva envía el código a otra persona.** Un
servidor de autorización que acepte cualquier URI de redirección que empiece por
un prefijo registrado, o que coincida con un comodín, puede ser inducido a
entregar un código a una página controlada por un atacante. El RFC 9700 exige
que los servidores de autorización comparen las URI de redirección mediante
coincidencia exacta de cadenas con las registradas, con una excepción para los
números de puerto en localhost de aplicaciones nativas, y prohíbe tanto a
clientes como a servidores utilizar redireccionadores abiertos que envíen el
navegador a cualquier URL encontrada en un parámetro de consulta.

**El callback acepta una respuesta que nadie solicitó.** Si el cliente acepta
cualquier código que llegue a su URI de redirección, un atacante puede
introducir su propio código a través del navegador de una víctima y hacer que
esta acabe trabajando en la cuenta del atacante. Es una falsificación de
petición entre sitios dirigida a la redirección. Un cliente puede confiar en
PKCE como protección una vez que haya confirmado que el servidor lo admite; de
lo contrario, envía un valor `state` de un solo uso vinculado a la sesión del
navegador de la persona y rechaza cualquier respuesta que no lo devuelva.

**Los tokens viajan en las URL.** La concesión implícita coloca el token de
acceso directamente en la redirección, donde el historial del navegador y las
cabeceras `Referer` pueden llevarlo a lugares a los que nunca debía llegar, y nada lo
vincula al cliente que lo solicitó. El RFC 9700 dice que los clientes no
deberían usarla, y el borrador OAuth 2.1 la omite. Lo mismo ocurre con una API
que acepte un token como parámetro de consulta: el RFC 6750 dice que las URL de
las páginas nunca deberían contener tokens al portador. Utilice la concesión de
código y envíe los tokens en la cabecera `Authorization`.

**La aplicación pide la contraseña de todos modos.** La concesión de
credenciales de contraseña del propietario del recurso permite que un cliente
recopile el nombre de usuario y la contraseña de una persona y los cambie por un
token, lo que anula la razón de ser de OAuth. El RFC 9700 establece que no debe
usarse: expone las credenciales al cliente, acostumbra a las personas a escribir
su contraseña en lugares distintos del servidor de autorización y nunca se
diseñó para funcionar con autenticación de dos factores ni con inicios de sesión
de varios pasos. Envíe a las personas al servidor de autorización con la
concesión de código y utilice credenciales de cliente cuando no intervenga
ninguna persona.

**Un token robado funciona para cualquiera que lo posea.** El RFC 6750 define un
token al portador como aquel que puede utilizar cualquier parte que lo posea:
tenerlo es toda la prueba. Utilice tokens de acceso de corta duración,
restrinja cada uno a la API para la que se emitió y, cuando lo que está en juego
lo justifique, vincule los tokens al cliente mediante TLS mutuo (RFC 8705) o
DPoP (RFC 9449). Los tokens de actualización de clientes públicos, como las
aplicaciones de teléfono y de navegador, deben estar vinculados al cliente o
rotarse: cada actualización devuelve un token nuevo e invalida el antiguo. Si
también se utiliza una copia robada, una de las partes acaba presentando un
token invalidado, el servidor revoca el activo y el ataque se detiene a costa de
que el cliente legítimo deba volver a pedir a la persona una nueva concesión.

## Lecturas adicionales

- [RFC 6749: marco de autorización OAuth 2.0](https://www.rfc-editor.org/rfc/rfc6749)
  — los cuatro roles, los cuatro tipos de concesión y los endpoints, tal como se
  publicaron en octubre de 2012.
- [RFC 7636: prueba de clave para el intercambio de códigos en clientes públicos de OAuth](https://www.rfc-editor.org/rfc/rfc7636)
  — verificador y desafío de código, con el ejemplo S256 utilizado arriba.
- [RFC 9700: mejores prácticas actuales de seguridad de OAuth 2.0](https://www.rfc-editor.org/rfc/rfc9700)
  — recomendaciones de enero de 2025: coincidencia exacta de redirecciones, PKCE
  para todos los clientes y eliminación de las concesiones implícita y de
  contraseña.
- [RFC 6750: uso de tokens al portador](https://www.rfc-editor.org/rfc/rfc6750)
  — cómo presenta un cliente un token de acceso y cómo indica una API que falta,
  ha caducado o tiene un alcance demasiado limitado.
- [Marco de autorización OAuth 2.1](https://datatracker.ietf.org/doc/draft-ietf-oauth-v2-1/)
  — borrador del grupo de trabajo que integra estos documentos en uno y que en
  octubre de 2026 sigue siendo un Internet-Draft.

<https://engineer.company/es/glossary/oauth/>
