Clase 03 · Módulo 05
Autenticación: claves, tokens y OAuth
Autenticación: claves, tokens y OAuth
Qué logras en esta clase
Conectas un servicio que pide identificarse y dejas la clave guardada donde corresponde.
- Reconoces en una documentación qué tipo de autenticación usa.
- Creas la credencial correcta en n8n para cada tipo.
- Entiendes qué hace OAuth y por qué a veces «se desconecta».
02
Quien tiene tu clave eres tú
Para el servicio, la clave es la persona. No pide segundo factor ni pregunta quién la está usando.
03
Identidad y permiso son cosas distintas
- Autenticar: comprobar quién llama.
- Autorizar: decidir qué puede hacer ese que llama.
Por eso hay dos códigos de error. Un 401 suele significar que la clave falta, está mal escrita o venció. Un 403, que la clave es válida pero no tiene permiso para esa operación.
04
Las formas más comunes
| Forma | Cómo funciona |
|---|---|
| Clave de API | Un texto largo y fijo que generas en el panel del servicio |
| Token Bearer | Igual, enviado en la cabecera Authorization con la palabra Bearer |
| Basic | Usuario y contraseña en cada llamada |
| OAuth 2.0 | Autorizas con tu cuenta y n8n recibe un token temporal |
Las tres primeras son un secreto fijo. OAuth es un proceso: lo verás más abajo.
05
Dónde viaja la clave
La documentación del servicio lo indica, casi siempre en una sección llamada «Authentication». Hay tres lugares posibles:
- En una cabecera, lo más habitual:
Authorization: Bearer ...o una propia comoX-API-Key. - En un parámetro de consulta, como
?apikey=.... - En el cuerpo, poco frecuente.
06
Dos caminos en el campo Authentication
En el nodo HTTP Request, el campo Authentication ofrece:
| Opción | Cuándo |
|---|---|
| Predefined Credential Type | n8n ya conoce el servicio |
| Generic Credential Type | Cualquier otra API |
La primera es la recomendada cuando existe: n8n sabe dónde poner la clave y, si es OAuth, cómo renovarla.
07
Reusar la credencial de un servicio conocido
Sirve cuando el nodo del servicio existe pero le falta la operación que necesitas.
- En Authentication elige Predefined Credential Type.
- En Credential Type busca el servicio.
- Selecciona la credencial que ya tenías, o crea una.
- Arma el resto de la petición según la documentación de la API.
No copias ni vuelves a ver la clave: el nodo la toma de la credencial.
08
Tipos genéricos y qué piden
| Tipo | Campos |
|---|---|
| Header Auth | Name y Value de la cabecera |
| Bearer Auth | Bearer Token |
| Basic Auth | Username y Password |
| Query Auth | Name y Value del parámetro |
| Custom Auth | Un JSON con cabeceras, parámetros o cuerpo |
Existen además Digest Auth, OAuth1 y OAuth2. Custom Auth sirve cuando el servicio pide dos datos a la vez, por ejemplo una clave y un identificador de cuenta.
09
Un token Bearer, de dos maneras
Si la documentación pide Authorization: Bearer TU_TOKEN:
- Con Bearer Auth, pegas solo el token. n8n arma la cabecera.
- Con Header Auth, pones
Authorizationen Name yBearer TU_TOKENen Value, con un espacio entre la palabra y el token.
Si no ves Bearer Auth en tu versión, la segunda forma siempre está.
10
La clave vive en la credencial
Nunca en Send Headers, nunca en la URL, nunca en un nodo Code. Un solo lugar, cifrado, y los nodos solo la referencian.
11
Por qué tanta insistencia
Lo viste en el módulo 2, clase 6. Aplicado a HTTP Request:
- Un flujo exportado o compartido lleva todo lo escrito en sus nodos, claves incluidas.
- Una captura de pantalla del nodo muestra la cabecera completa.
- Si la clave cambia, la actualizas en un lugar y no en veinte nodos.
12
OAuth: permiso sin entregar tu contraseña
OAuth 2.0 es un estándar para que una aplicación actúe en tu nombre sin conocer tu contraseña. Tú apruebas permisos concretos y puedes retirarlos después desde tu cuenta, sin cambiar la contraseña.
13
Dos tokens con vidas distintas
| Token | Para qué | Duración |
|---|---|---|
| De acceso | Va en cada llamada | Corta |
| De actualización | Pedir un token de acceso nuevo | Larga |
n8n renueva el de acceso por su cuenta. Cuando una credencial OAuth «se desconecta», casi siempre es porque el token de actualización venció o fue revocado, y hay que volver a autorizar. El caso de Google se ve en el módulo 6.
14
Las variantes de OAuth2 en n8n
Al crear una credencial OAuth2, eliges el Grant Type:
| Grant Type | Cuándo |
|---|---|
| Authorization Code | Actúas en nombre de una persona que inicia sesión |
| Client Credentials | Dos sistemas se hablan, sin persona de por medio |
| PKCE | Como el primero, cuando el servicio lo exige |
La documentación del servicio dice cuál usar. No se elige por gusto.
15
Armar una credencial OAuth2 genérica
- En el servicio, registra una aplicación. Te pedirá una dirección de retorno: copia el OAuth Redirect URL que muestra n8n en la credencial.
- El servicio te entrega Client ID y Client Secret.
- En n8n completa esos dos datos, Authorization URL y Access Token URL.
- Si corresponde, escribe los permisos en Scope.
- Conecta y aprueba en la ventana del servicio.
Las dos direcciones del paso 3 salen de la documentación del servicio.
16
En n8n 2, autoriza con la sesión abierta
Desde la versión 2.0, n8n exige que el retorno de OAuth llegue a un navegador con sesión iniciada en n8n.
Si un tutorial antiguo propone apagar esa comprobación con una variable, no lo sigas: es una protección.
17
Pide el permiso más chico que sirva
Casi todos los servicios dejan limitar una clave: solo lectura, solo un recurso, solo un proyecto. En OAuth, eso son los scopes.
Una credencial por servicio y por uso, con nombre claro, como aprendiste en el módulo 2.
18
Cuándo cambiar una clave
- Cuando la pegaste en un chat, un correo o una captura.
- Cuando deja el equipo alguien que la conocía.
- Cuando el servicio avisa de un acceso extraño.
Cambiarla es: generar una nueva, actualizar la credencial en n8n, probar y recién entonces revocar la antigua.
19
Cómo elegir
| La documentación dice | En n8n |
|---|---|
| El servicio tiene nodo en n8n | Predefined Credential Type |
| «API key» en una cabecera | Header Auth |
| «Bearer token» | Bearer Auth o Header Auth |
| «API key» en la dirección | Query Auth |
| «Basic authentication» | Basic Auth |
| «OAuth 2.0» | OAuth2 con su Grant Type |
20
Errores comunes
- Dejar la clave en las cabeceras del nodo «por mientras».
- Usar la clave de administrador para una tarea de solo lectura.
- Compartir una misma clave entre pruebas y operación real.
- Guardar claves en una planilla o en las notas del flujo.
- Revocar la clave antigua antes de probar la nueva.
21
Lo que te llevas
- 401 habla de la clave; 403, de sus permisos.
- La documentación dice qué tipo de autenticación usa y dónde viaja.
- Predefined Credential Type si n8n conoce el servicio; Generic para el resto.
- OAuth entrega tokens temporales que n8n renueva, y en n8n 2 se autoriza con la sesión abierta.
- La clave va en una credencial, con el permiso mínimo.
22
Hazlo ahora
En 15 minutos, si tienes cuenta de GitHub:
- Crea un token personal siguiendo la guía de autenticación de GitHub, sin permisos adicionales.
- En n8n, crea una credencial genérica de tipo Bearer Auth (o Header Auth) con ese token.
- Úsala en la llamada de la clase 2, con Include Response Headers and Status activado.
- Compara la cabecera
x-ratelimit-limit: 60 sin credencial, 5.000 con ella. - Revoca el token en GitHub y mira qué código recibes.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- HTTP Request credentials (documentación de n8n)docs.n8n.io ↗
- HTTP Request (documentación de n8n)docs.n8n.io ↗
- n8n v2.0 breaking changes (documentación de n8n)docs.n8n.io ↗
- The OAuth 2.0 Authorization Framework (RFC 6749)datatracker.ietf.org ↗
- Authenticating to the REST API (GitHub, usada como ejemplo)docs.github.com ↗
- Rate limits for the REST API (GitHub)docs.github.com ↗