Versionamento com Git e segurança de credenciais no n8n

Versionar fluxos com Git e proteger credenciais adequadamente são os dois cuidados que separam uma operação de n8n amadora de uma pronta para produção — o primeiro evita perder trabalho ou trabalhar sobre a versão errada; o segundo evita vazamento de dado sensível.

Por que versionar fluxos com Git

• Histórico de mudanças — saber exatamente o que mudou, quando e por quê.

• Reverter com segurança — voltar a uma versão anterior que funcionava, se uma mudança quebrar algo.

• Trabalho em equipe — mais de uma pessoa mexendo em fluxos sem sobrescrever o trabalho uma da outra.

• Separação de ambientes — testar mudanças num ambiente de desenvolvimento antes de aplicar em produção.

Como funciona na prática

O n8n permite exportar fluxos como arquivos JSON, que podem ser versionados num repositório Git normalmente — como qualquer outro código. Instâncias com o recurso de controle de código-fonte integrado (disponível em planos específicos) automatizam esse processo, sincronizando mudanças diretamente com um repositório configurado.

Mesmo sem o recurso integrado, o hábito manual de exportar fluxos importantes periodicamente e commitar num repositório já entrega boa parte do benefício — histórico e possibilidade de reverter, mesmo que o processo não seja totalmente automático.

Segurança de credenciais

Nunca deixe credencial em texto puro — direto num node HTTP Request, hardcoded num código dentro de um node Code, ou commitada junto com o fluxo exportado num repositório Git. Use sempre o sistema de credenciais nativo do n8n, que armazena esses dados criptografados, separados do fluxo em si.

Boas práticas de credencial

1. Uma credencial por serviço, reutilizada entre fluxos que precisam dela — não copiada em cada fluxo separadamente.

2. Revisar acessos periodicamente — remover credenciais de serviços que não são mais usados.

3. Cofre de segredos externo, quando disponível — para operações maiores, mover chaves sensíveis para um cofre dedicado, em vez de confiar só na criptografia interna do n8n.

4. Nunca compartilhar a chave de criptografia (N8N_ENCRYPTION_KEY) fora do necessário — quem tem essa chave e acesso ao banco consegue decifrar todas as credenciais salvas.

Juntando os dois cuidados

Ao exportar fluxos para Git, as credenciais não vêm junto — elas ficam de fora do JSON exportado, referenciadas só pelo nome. Isso é intencional: o repositório guarda a lógica do fluxo, nunca o segredo que ele usa para se conectar a outros serviços.

Git para versionar a lógica dos fluxos, sistema de credenciais nativo (ou cofre externo) para os segredos — os dois nunca devem se misturar no mesmo lugar.

Perguntas frequentes