Clase 06 · Módulo 02
Credenciales, clave de cifrado y variables de entorno
Credenciales, clave de cifrado y variables de entorno
Qué logras en esta clase
Guardas accesos a otros servicios de forma segura y dejas tu instalación bien configurada.
- Creas credenciales en vez de pegar claves en los nodos.
- Ubicas y resguardas la clave de cifrado.
- Fijas las variables de entorno básicas.
02
Qué es una credencial
Una credencial es el acceso guardado a un servicio: una clave, un token o un permiso que le deja a n8n actuar en tu nombre.
03
Por qué no pegar la clave en el nodo
Muchos nodos dejan escribir una clave directamente en un campo. Funciona, y es mala idea:
- Queda visible para cualquiera que abra el flujo.
- Viaja dentro del archivo si exportas o compartes el flujo.
- Si la clave cambia, tienes que editar cada nodo que la usa.
Con una credencial la escribes una vez y los nodos solo la referencian.
04
Crear una credencial
- En el menú, selecciona Create y luego Credential.
- Elige el servicio que quieres conectar.
- Completa los datos que pide ese servicio.
- Guarda. n8n prueba la credencial y te dice si funciona.
En la edición comunitaria las credenciales quedan en tu espacio personal. Qué dato pide cada servicio está en la biblioteca de credenciales de la documentación.
05
Dos caminos, mismo resultado
| Desde dónde | Cuándo conviene |
|---|---|
| Menú Create > Credential | Preparas los accesos antes de construir |
| Selector de credencial dentro del nodo | Estás armando el flujo y la necesitas ahora |
Una misma credencial sirve para todos los flujos que usen ese servicio. No crees una por flujo.
06
Ponles un nombre útil
Se renombra haciendo clic sobre el nombre, arriba de la credencial.
07
Limitar dónde se usa una credencial
Cada credencial tiene un campo Allowed HTTP Request Domains. Controla en qué direcciones puede usarla el nodo HTTP Request, el que llama a cualquier servicio (módulo 5).
| Opción | Efecto |
|---|---|
| All | Cualquier dirección |
| Specific Domains | Solo las que listes |
| None | Ninguna |
Limitarla evita que una clave termine enviada a un sitio equivocado.
08
Guardadas, pero cifradas
n8n no guarda tus credenciales como texto legible. Las cifra con una clave antes de escribirlas en su base de datos.
09
Cómo funciona el cifrado
La base de datos sola no basta para leer una credencial. Hace falta la clave, que se guarda en otro lugar.
10
Dónde está la clave
En el primer arranque, n8n genera una clave al azar y la guarda en su archivo de ajustes, dentro de la carpeta .n8n.
| Instalación | Ubicación |
|---|---|
| npm | Carpeta .n8n de tu usuario |
| Docker | El volumen montado en /home/node/.n8n |
El archivo se llama config. En Docker Desktop, la sección de volúmenes deja ver los archivos de n8n_data.
Tú no la elegiste ni la viste: mucha gente descubre que existe el día que la necesita.
11
Qué pasa si la pierdes
Las credenciales se cifraron con esa clave. Sin ella no hay forma de descifrarlas: los flujos siguen ahí, pero ningún nodo logra conectarse.
Te tocaría crear cada credencial de nuevo y reconectar cada servicio.
12
Cuándo se pierde, en la práctica
- Mueves n8n a otro equipo y llevas la base, pero no la carpeta completa.
- Recreas el contenedor de Docker sin el volumen.
- Restauras un respaldo de la base en una instalación nueva, que ya generó otra clave.
En los tres casos los datos están intactos y la clave no calza.
13
Fijar tu propia clave
La variable de entorno N8N_ENCRYPTION_KEY permite definir la clave en vez de dejarla al azar. Usa una cadena larga y aleatoria, generada con tu gestor de contraseñas.
Si el archivo de ajustes todavía no tiene clave, n8n toma la de la variable. Por eso se define antes del primer arranque.
14
No cambies la clave de una instalación en uso
Si tu instalación ya arrancó, la clave correcta es la que está en su archivo de ajustes. Cópiala de ahí y usa esa misma en la variable.
15
La clave va aparte del respaldo
Guarda la clave en tu gestor de contraseñas, separada de la copia de la base de datos. Quien tenga ambas tiene todos tus accesos.
16
Qué es una variable de entorno
Es un ajuste que se le entrega a un programa al arrancar, desde fuera. n8n lee decenas; no se cambian en el editor.
| Instalación | Dónde se definen |
|---|---|
| npm | En la terminal, antes de n8n start |
docker run | Con -e NOMBRE=valor |
| Compose | En la sección environment |
Para que el cambio tome efecto hay que reiniciar n8n.
17
Las que conviene fijar desde hoy
| Variable | Para qué |
|---|---|
GENERIC_TIMEZONE | Zona horaria de los nodos de horario |
TZ | Zona horaria del sistema (Docker) |
N8N_ENCRYPTION_KEY | Tu clave de cifrado |
N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS | Exigir permisos restringidos al archivo de ajustes |
Las dos primeras con America/Santiago. La última va en true, salvo en Windows con npm, donde va en false.
18
Las que ya vienen bien
| Variable | Valor por defecto |
|---|---|
N8N_HOST | localhost |
N8N_PORT | 5678 |
N8N_PROTOCOL | http |
En tu computador no las toques. Cambian cuando n8n pasa a un servidor con dominio propio (módulo 14).
19
El archivo .env
Con Compose, los valores suelen ir en un archivo llamado .env, junto al compose.yaml: una línea por variable, con la forma NOMBRE=valor. El archivo Compose los referencia en vez de tenerlos escritos.
Reglas de n8n 2 para estos archivos:
- Una línea que empieza con
#es un comentario. - Se admiten valores de varias líneas.
- Un valor con comillas invertidas va entre comillas.
20
El .env no se comparte
Lo mismo vale para una exportación de credenciales con la opción --decrypted: deja todos tus accesos legibles. Se verá en el módulo 14; por ahora, no la uses.
21
El código no lee tus variables
Desde la 2.0, el nodo Code (para escribir código dentro de un flujo, módulo 3) no puede leer variables de entorno.
Es una protección: un flujo importado de internet no puede sacar tu clave de cifrado desde ahí. Si un tutorial pide desactivarla para leer una clave, la respuesta correcta es guardar esa clave como credencial.
22
Telemetría y avisos
| Variable | Por defecto | Qué hace |
|---|---|---|
N8N_DIAGNOSTICS_ENABLED | true | Envía datos de uso anónimos a n8n |
N8N_VERSION_NOTIFICATIONS_ENABLED | true | Avisa de versiones nuevas y parches de seguridad |
Puedes apagar la primera con false; a cambio pierdes la ayuda de IA dentro del nodo Code. La segunda conviene dejarla encendida.
23
Lo que te llevas
- Las claves de servicios van en credenciales, nunca escritas en un nodo.
- n8n cifra las credenciales con una clave guardada en la carpeta
.n8n. - Sin esa clave, las credenciales no se pueden leer.
N8N_ENCRYPTION_KEYse fija antes del primer arranque y se guarda aparte del respaldo.- El
.envcontiene secretos: no se sube ni se comparte.
24
Hazlo ahora
En 15 minutos:
- Detén n8n y ubica el archivo de ajustes dentro de
.n8n(o del volumen). - Copia la clave de cifrado a tu gestor de contraseñas.
- Agrega
N8N_ENCRYPTION_KEYcon esa misma clave a tu configuración. - Arranca n8n y confirma que abre sin errores.
- Abre Create > Credential y recorre la lista de servicios sin guardar nada.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- n8n Docs — Crear y editar credencialesdocs.n8n.io ↗
- n8n Docs — Clave de cifrado propiadocs.n8n.io ↗
- n8n Docs — Variables de entorno de desplieguedocs.n8n.io ↗
- n8n Docs — Cambios incompatibles de la versión 2.0docs.n8n.io ↗
- n8n Docs — Instalación con Dockerdocs.n8n.io ↗
- n8n Docs — Comandos de línea (exportar credenciales)docs.n8n.io ↗