Integración · Automatización

Conectar n8n a Igniten

Lee sus flujos de n8n y sus ejecuciones recientes. Igniten le va a pedir confirmación cada vez antes de cambiar algo. La tarjeta muestra el antes y el después. Igniten guarda cómo estaba el flujo antes, durante 7 días, por si quiere volver atrás. Se probó con n8n 2.9.2.

Qué lee Igniten, y qué no

Lee

Nombres y estado de los flujos, y de cada paso: su nombre, su tipo, si está apagado y cómo se conecta con los demás.
Los valores de los pasos Editar campos (Edit Fields), Sin operación (No Operation), Disparador manual (Manual Trigger) y Disparador programado (Schedule Trigger). De los demás pasos sólo se dice que tienen configuración, sin mostrarla.
Estado, inicio y fin de ejecuciones; si falló, un aviso sin el contenido del error.

No lee

Contraseñas y credenciales guardadas en n8n, datos de entrada y salida de ejecuciones.
La configuración de los demás pasos: direcciones web, encabezados, claves escritas a mano, código y webhooks.
Datos fijados de ejemplo ni el contenido de las ejecuciones.

Cómo se conecta

2 pasos · ≈ 3 min

1
Pegar la clave de API

La clave de API es una contraseña larga. Salvo en n8n Enterprise, cualquier clave puede leer, cambiar y borrar todo lo que ve su usuario, aunque Igniten sólo la use para leer. Use un usuario aparte para Igniten, no su cuenta personal.
- Si usa n8n Cloud, Business o Enterprise: en Settings → Users invite a un usuario con rol Member. Cree un proyecto, mueva ahí sólo los flujos que quiere que Igniten vea y sume a ese usuario al proyecto.
- Si usa n8n gratis en su servidor (n8n Community): no hay proyectos ni flujos compartidos. Cada flujo lo ven sólo el dueño y quien lo creó. O los crea el usuario de Igniten, o usa una clave del dueño, sabiendo que esa clave tiene acceso total a toda la instancia.
- Entre a n8n como ese usuario. Abra Settings (Configuración) → n8n API; va a ver las claves de esa cuenta.
- Toque Create an API key (Crear una clave), llámela Igniten lectura y ponga una fecha de vencimiento. Si su edición permite elegir alcances (permisos), marque workflow:list, workflow:read, execution:list y execution:read. Va a ver la clave una sola vez.
- Copie la clave y péguela en Clave de API en Igniten. Copie también la dirección HTTPS de n8n, sin lo que sigue al nombre del servidor. Va a ver ambos campos completos.
- Para editar, cree otra clave llamada Igniten escritura. Si puede elegir permisos, marque sólo workflow:update, workflow:activate y workflow:deactivate. Péguela en Clave de escritura. Igniten le va a pedir confirmación cada vez antes de cambiar algo.
- Si no ve permisos por clave, su versión no los ofrece: las dos claves pueden hacer todo lo que puede ese usuario. Igniten usa la de lectura sólo para consultar, pero póngale vencimiento y guárdela como una contraseña.
Salió bien si La consola del proveedor le muestra la clave una sola vez: si ya la copió, este paso está hecho.
2
Queda guardada y en uso

Desde que la guarda, lo que se le pregunte a n8n sale con esa clave. Acá no se comprueba contra el proveedor: si la clave está equivocada, se ve en la primera consulta.
- No hay botón de probar en este recorrido, y eso es a propósito: lo único que sabríamos contestar es si la fila quedó guardada, no si la clave abre algo.
- Si la clave está equivocada, se ve en la primera consulta y la respuesta lo dice.
- Para cambiarla se carga una nueva: la anterior no se puede volver a ver.
Salió bien si La integración figura conectada y muestra los últimos cuatro caracteres de la clave.

Qué permisos pide

Permiso	Para qué	Cuándo hace falta
`workflow:list`	Para listar los flujos.	Siempre
`workflow:read`	Para ver los pasos de un flujo.	Siempre
`execution:list`	Para listar ejecuciones recientes.	Siempre
`execution:read`	Para ver el estado de una ejecución.	Siempre
`workflow:update`	Para cambiar un valor o agregar un paso permitido, con tarjeta.	Siempre
`workflow:activate`	Para activar un flujo seguro, con tarjeta.	Siempre
`workflow:deactivate`	Para desactivar un flujo, con tarjeta.	Siempre

Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.

Qué puede salir mal

401 o 403

Por qué La clave venció o falta un permiso.

Qué hacer En Settings → n8n API, cree otra clave con los permisos indicados y vuelva a guardarla.

La dirección debe ser HTTPS y pública

Por qué La instancia está en una red privada o no usa HTTPS.

Qué hacer Pídale al administrador la dirección pública segura. Para una red privada necesita el conector local; este recorrido todavía no la conecta.

Falta la clave de escritura

Por qué Sólo conectó lectura.

Qué hacer Cree otra clave para escritura y péguela en el campo opcional de escritura; cada cambio sigue pidiendo tarjeta.

El flujo cambió desde la tarjeta

Por qué Alguien lo editó mientras revisaba.

Qué hacer Pida otra tarjeta y revise el nuevo antes y después.

El respaldo seguro no está disponible

Por qué Todavía falta habilitar el almacén cifrado de respaldos.

Qué hacer Avísenos. No se cambió el flujo; la lectura sigue disponible.

Los límites, dichos

Muestra hasta 50 flujos o ejecuciones por pregunta.
Sólo HTTPS en puerto 443; no hay conexión directa a redes privadas.
Igniten nunca pide a n8n sus contraseñas guardadas.
Si alguien edita el mismo flujo en n8n al mismo tiempo, el último que guarda gana: evite editarlo en los dos lados a la vez.

Preguntas frecuentes

¿Dónde encuentro la clave?

En n8n, abra Settings (Configuración) → n8n API → Create an API key (Crear una clave). Es una contraseña larga; péguela solamente en el campo de clave del panel de Igniten, nunca en el chat.

¿Cuánto tarda?

Tarda aproximadamente 3 minutos si ya tiene el usuario de Igniten en n8n. Su administrador puede ayudarle a crearlo.

¿Quién ve qué?

Cada persona con permiso para ver n8n en Igniten ve solamente los flujos de ese permiso y del proyecto del usuario de Igniten en n8n. Sin ese permiso no se consulta n8n. La clave de la organización nunca amplía esos permisos.

¿Puede borrar cosas?

No puede borrar flujos. No puede agregar Code, Execute Command, SSH ni pasos que ejecuten código. Sólo agrega Editar campos (Edit Fields), Sin operación (No Operation), Disparador manual (Manual Trigger) y Disparador programado (Schedule Trigger), este último con un horario diario. Quedan desconectados.

¿Puede editar cualquier flujo?

Puede cambiar valores fijos del paso Editar campos (Edit Fields), sin expresiones ni código. Sólo edita o activa flujos formados por los cuatro tipos permitidos. Un flujo con otros tipos se edita en n8n.

¿Puede apagar un flujo que tiene otros pasos?

Sí, puede desactivarlo con tarjeta. Pero ese cambio no se puede deshacer desde Igniten: para volver a activarlo, entre a n8n. La tarjeta se lo avisa antes de confirmar.

¿Cómo lo desconecto?

En el panel de Igniten, abra Conexiones → n8n y revoque la clave. En n8n, elimine las dos claves desde Settings → n8n API. Las tarjetas anteriores dejan de servir.

¿Y si mi edición no sirve?

Pida «deshacer el último cambio de este flujo». Igniten busca su último cambio de los últimos 7 días y le muestra otra tarjeta. Si alguien cambió el flujo después, se rechaza para no pisar su trabajo. Si pide deshacer dos veces seguidas, la segunda vez vuelve a dejar el cambio: la tarjeta muestra el antes y el después antes de confirmar.

¿No tengo los permisos de la lista?

Elegir permisos para cada clave sólo existe en n8n Enterprise. En las demás versiones, CUALQUIER clave puede hacer todo lo que puede su usuario: leer, editar, borrar y crear flujos, incluso con código que corre en su servidor. Eso vale también para la clave que carga como «de lectura». Igniten sólo hace consultas con esa clave y nunca la usa para cambiar nada, pero si alguien la roba puede hacer todo eso. Tener dos claves del mismo usuario no limita lo que cada una puede hacer. Por eso conviene que el usuario de Igniten vea la menor cantidad de flujos posible, y que ponga vencimiento a las claves. La API no está disponible durante la prueba gratuita de Cloud.

¿Cómo creo el usuario para Igniten?

Si usa n8n Cloud, Business o Enterprise: en Settings → Users invite a un usuario nuevo con rol Member. Cree un proyecto, mueva ahí sólo los flujos que quiere que Igniten vea (menú del flujo → Move) y sume a ese usuario al proyecto. Después entre a n8n como ese usuario y cree las claves. En Enterprise dele el rol Viewer si sólo va a leer. Si usa n8n gratis en su servidor (n8n Community): no hay proyectos ni flujos compartidos. Cada flujo lo ven sólo el dueño de la instancia y quien lo creó. O los crea el usuario de Igniten, o usa una clave del dueño, sabiendo que esa clave tiene acceso total a toda la instancia.