Clase 04 · Módulo 14
Seguridad de tu instancia
Seguridad de tu instancia
Qué logras en esta clase
Revisas tu instancia por capas y cierras lo que hoy está abierto.
- Proteges la entrada al editor con doble factor.
- Dejas cada webhook con autenticación.
- Das a cada credencial solo el permiso que usa.
- Entiendes las protecciones de n8n 2 antes de tocarlas.
02
Qué hay dentro de tu n8n
Tu instancia guarda las llaves de todo lo que conectaste: correo, planillas, base de datos, WhatsApp, la API de Claude.
Quien entra a tu n8n entra a todo eso a la vez.
03
Cuatro capas, cuatro preguntas
| Capa | Pregunta |
|---|---|
| Acceso al editor | ¿Quién puede entrar? |
| Webhooks | ¿Quién puede disparar un flujo? |
| Credenciales | ¿Cuánto puede hacer cada llave? |
| Servidor | ¿Qué puede tocar n8n en la máquina? |
Una falla en una capa no debería abrir las otras.
04
Capa 1: la cuenta de propietario
- Contraseña larga y única, guardada en un gestor de contraseñas.
- Correo de la cuenta que controles tú, no uno compartido.
- Una cuenta por persona. Nadie comparte usuario.
n8n trae doble factor: además de la contraseña pide un código que genera una aplicación en tu celular.
05
Activar el doble factor
- Instala una aplicación de códigos en tu celular.
- En n8n, abre los ajustes de tu cuenta personal y busca la opción de doble factor.
- Escanea el código y confirma con el número que aparece.
- Guarda los códigos de recuperación fuera del celular.
El nombre del menú y el orden de los pasos pueden cambiar entre versiones: sigue lo que muestre tu pantalla.
06
Si pierdes el celular
Con acceso al servidor puedes apagar el doble factor de un usuario y volver a configurarlo:
n8n mfa:disable --email=tu@correo.cl07
No publiques el editor sin necesidad
Lo que debe estar en internet son los webhooks. El editor solo lo necesitas tú.
- Si trabajas siempre desde el mismo lugar, limita el acceso por dirección IP en el proxy o en Cloudflare.
- Si no puedes limitarlo, el doble factor deja de ser opcional.
08
Capa 2: un webhook es una puerta
Una Production URL sin autenticación la puede llamar cualquiera que la conozca. Una dirección difícil de adivinar no es una contraseña.
09
Las opciones del nodo Webhook
| Autenticación | Cuándo conviene |
|---|---|
| Header | El servicio externo permite enviar una cabecera secreta |
| Basic | El servicio solo ofrece usuario y contraseña |
| JWT | El emisor firma cada llamada con un token |
| Usuario de n8n | Solo deben llamar personas de tu instancia |
«Ninguna» queda para pruebas locales. El valor secreto se guarda como credencial, nunca escrito en el nodo.
10
Más cierres en el mismo nodo
- Lista de IP permitidas: las demás direcciones reciben un 403. Útil cuando el emisor publica sus direcciones.
- Orígenes CORS: por defecto acepta cualquiera (
*). Si llamas desde tu web, escribe tu dominio. - Tamaño máximo: 16 MB por llamada.
11
Valida lo que llega
Autenticar dice quién llama. No dice que el dato venga bien.
Si falta un campo o trae un formato raro, corta ahí. El nodo Stop and Error lo viste en el módulo 13, clase 2.
12
Capa 3: una credencial por uso
- Una credencial por servicio y por propósito.
- Nombre que diga para qué es:
sheets-solo-lectura-reportes. - Al crearla en el servicio, elige los permisos mínimos que el flujo usa.
13
Permisos mínimos en la práctica
| Flujo | Permiso suficiente |
|---|---|
| Lee una planilla para un reporte | Solo lectura |
| Guarda pedidos en Postgres | Insertar en una tabla |
| Envía avisos por Telegram | Un bot dedicado a eso |
| Agente con herramientas | Las del módulo 11, clase 4 |
Cada servicio define sus permisos a su manera: revisa sus opciones al crear la clave o el acceso.
14
Dónde nunca va una clave
- En un nodo Code o Edit Fields (Set) como texto.
- En el campo de dirección o de cabecera de un HTTP Request.
- En una planilla «de configuración».
- En el nombre o las notas del flujo.
Un flujo exportado lleva todo eso en texto legible. Las credenciales, en cambio, se guardan cifradas con la clave de la instancia.
15
Capa 4: lo que n8n 2 trae cerrado
| Protección por defecto | Qué evita |
|---|---|
| El nodo Code no lee variables de entorno | Que un flujo saque tus secretos del servidor |
| Execute Command desactivado | Que un flujo ejecute comandos en la máquina |
| Local File Trigger desactivado | Que un flujo vigile carpetas del servidor |
Archivos solo en ~/.n8n-files | Que un flujo lea cualquier archivo |
16
Y tres protecciones más
- El retorno de OAuth exige sesión iniciada en n8n.
- El archivo de ajustes exige permisos restringidos (
0600). - El código de los nodos corre en procesos aislados.
También quedan bloqueados los repositorios Git de tipo «bare» en el nodo Git.
En Windows los permisos 0600 no existen: ahí se define N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=false.
17
Cuando un tutorial te pide abrir algo
Los tutoriales de la serie 1.x asumen que todo eso estaba abierto. Antes de desactivar una protección, entiende qué estaba evitando.
18
Alternativas a desactivar
| Lo que quieres | En vez de abrir |
|---|---|
| Un secreto dentro de un nodo Code | Pásalo desde una credencial o un nodo anterior |
| Ejecutar un comando del sistema | Un script con el programador del sistema (módulo 12) |
| Leer un archivo | Déjalo en ~/.n8n-files |
Si aun así necesitas activar algo, hazlo solo en esa instancia, anótalo y revisa quién puede editar flujos.
19
La auditoría que trae n8n
n8n auditRevisa la instancia y lista problemas comunes de seguridad. En Docker se antepone docker exec -u node -it y el nombre del contenedor.
Córrela después de instalar, después de cada cambio grande y una vez al mes. Lee el resultado completo: no arregla nada sola.
20
Rutina mensual de 15 minutos
- Ejecuta
n8n audity resuelve lo que marque. - Revisa la lista de usuarios y elimina los que ya no corresponden.
- Revisa las credenciales: borra las que ningún flujo usa.
- Busca webhooks publicados sin autenticación.
- Confirma que estás en una versión estable reciente (clase 6).
21
Si sospechas que entraron
- Cambia la contraseña de tu cuenta de n8n.
- En cada servicio conectado, anula la clave o el acceso y crea uno nuevo.
- Despublica los flujos que no reconozcas.
- Revisa las ejecuciones recientes buscando corridas que no esperabas.
El orden importa: primero cierras la puerta, después cambias las llaves.
22
Lo que te llevas
- Tu n8n concentra las llaves de todos tus servicios: se protege por capas.
- Doble factor en cada cuenta, y el editor fuera de internet si puedes.
- Ningún webhook de producción sin autenticación.
- Una credencial por uso, con el permiso mínimo.
- Las protecciones de n8n 2 se entienden antes de tocarlas, y
n8n auditse corre cada mes.
23
Hazlo ahora
En 15 minutos:
- Activa el doble factor en tu cuenta y guarda los códigos de recuperación.
- Lista tus flujos publicados que empiezan con Webhook.
- Marca cuáles tienen autenticación «Ninguna».
- Corrige uno: elige Header, crea la credencial y actualiza el servicio que lo llama.
- Ejecuta
n8n audity anota lo que encontró.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026