Clonar um workflow n8n cria um problema que ninguém avisa
O clone sai perfeito. O problema começa quando alguém esquece de trocar uma credencial.
resumo
Clonar um workflow n8n e trocar a credencial só do clone significa atualizar manualmente cada node que usava a credencial antiga. É fácil esquecer um, e o resultado é o pior tipo de bug: o clone roda sem erro nenhum e fica silenciosamente escrevendo no ambiente errado. O Credential Align escaneia o workflow, lista as credenciais em uso e troca todas as referências de uma vez, direto no navegador.
Clonei um workflow n8n pela enésima vez essa semana. Mesmo fluxo, credencial diferente: outro ambiente, outro cliente, outro Postgres. O clone sai perfeito. O problema começa depois: toda credencial antiga continua lá, espalhada em cada node que a usava, e agora preciso trocar uma por uma.
Num workflow pequeno isso é chato. Num workflow com Postgres, Redis, Slack e três nodes de HTTP Request apontando pra API errada, é fácil esquecer um. E o que acontece quando você esquece um node é o pior tipo de bug: o clone roda, não dá erro nenhum, e fica silenciosamente escrevendo no banco de produção errado até alguém notar.
Não é falha de atenção. É o processo que está errado. Trocar credencial em N nodes manualmente é exatamente o tipo de tarefa mecânica que não deveria depender de eu lembrar de cada um.
O que a ferramenta faz
Construí o Credential Align pra resolver isso direto no navegador, sem precisar abrir o editor do n8n node por node.
- 1.Cola o JSON exportado do workflow.
- 2.A ferramenta escaneia todos os nodes e lista as credenciais em uso: nome, tipo, e quantos nodes dependem de cada uma.
- 3.Escolhe qual credencial é a “antiga”.
- 4.Informa a credencial nova: digita ID e nome, ou cola o JSON de um node que já está configurado com ela. Nesse segundo caso a ferramenta casa pelo tipo automaticamente. Se o tipo não bater, avisa em vez de adivinhar.
- 5.Aplica. Mostra a lista de nodes que mudaram (nome, tipo,
credencial antiga → nova) e o JSON final pronto pra copiar de volta pro n8n.
Nada disso sai do navegador. O parse, o scan e a reescrita rodam no cliente; o JSON colado nunca é enviado pra nenhum servidor.
Por que colar um node em vez de só digitar
Na prática, eu já tenho esse node em algum lugar: no workflow de origem, ou num node que acabei de configurar manualmente no n8n pra testar a credencial nova antes de aplicar em massa. Copiar esse node e colar aqui é mais rápido e menos sujeito a erro de digitação do que ler o ID de credencial em outra aba e transcrever.
O que fica
Clonar um fluxo continua sendo uma tarefa de um clique. Alinhar as credenciais do clone deveria ser também.
Perguntas
Por que trocar credencial manualmente num workflow n8n clonado é arriscado?
Porque é fácil esquecer um node, principalmente em workflows com várias credenciais (Postgres, Redis, Slack, HTTP Request). Quando isso acontece, o clone roda sem erro nenhum e fica silenciosamente usando a credencial errada, escrevendo no ambiente errado até alguém notar.
Como o Credential Align identifica quais nodes usam qual credencial?
A ferramenta escaneia o JSON do workflow e lista todas as credenciais em uso, com nome, tipo e quantos nodes dependem de cada uma. A partir dessa lista, você escolhe qual credencial precisa ser trocada.
Dá pra informar a credencial nova sem digitar o ID manualmente?
Sim. Além de digitar ID e nome, dá pra colar o JSON de um node já configurado com a credencial nova. A ferramenta extrai automaticamente casando pelo tipo: se o node colado não tiver uma credencial do mesmo tipo da antiga, ela avisa em vez de aplicar algo errado.
O JSON do workflow sai do navegador em algum momento?
Não. O parse, o scan e a reescrita das credenciais rodam inteiramente no cliente. Nada do que é colado ou solto na ferramenta é enviado a um servidor.