Variáveis de ambiente: Segurança
24 variáveis das versões 1.123.92, 2.45.7 e 3.0.1
Acesso dos Nodes a arquivos e variáveis, cabeçalhos de segurança, cookies, senha mínima e sandbox de formulários e webhooks. A lista sai do código de cada versão e das páginas de variáveis da documentação oficial, conferidos em 3 de novembro de 2026. Toda variável aceita o sufixo _FILE para ler o valor de um arquivo, útil para senhas e chaves em secrets do Docker.
Impede que expressões e o Code node leiam as variáveis de ambiente com
$env. O padrão passou defalsena 1.x paratruena 2.x. Definafalsese os seus workflows dependem de$env.Na 1.x, o n8n avisava que o padrão mudaria para
true. Workflows que leem variáveis de ambiente precisam defalse.Impede que os Nodes leiam ou gravem nas pastas internas do n8n, como
~/.n8ne~/.cache/n8n/public. A restrição vale também para as pastas definidas em variáveis comoN8N_CUSTOM_EXTENSIONSeN8N_BINARY_DATA_STORAGE_PATH.Expressões regulares de arquivos e pastas que os Nodes de leitura e gravação de arquivos não podem acessar, separadas por ponto e vírgula. O padrão nega o acesso à pasta
.git. Vazio, a restrição por padrão de nome fica desligada.Permissões retiradas do espaço pessoal de cada usuário, separadas por vírgula. Aceita só
credential:create,dataTable:createeagent:create. A lista só vale comN8N_CANVAS_ONLYligado. O n8n reaplica a lista a cada inicialização.Política Content-Security-Policy enviada nas respostas do n8n, exceto webhooks, formulários e endpoints MCP. Aceita um objeto de diretivas do helmet.js, como
{ "frame-ancestors": ["http://localhost:3000"] }, ou a política em texto. Na 2.x, o n8n passou a aplicar uma política própria com nonce quando a variável fica vazia.Política enviada como
Content-Security-Policy-Report-Only, nos mesmos formatos deN8N_CONTENT_SECURITY_POLICY. O cabeçalho só relata violações, sem impedir nada, por isso serve para testar uma política antes de aplicá-la.Valor do cabeçalho
Cross-Origin-Opener-Policyenviado pelo n8n.Faz o n8n conferir as permissões do arquivo de configuração, que guarda a chave de criptografia. Quando estão abertas demais, o n8n reduz as permissões para
0600. O padrão passou defalsena 1.x paratruena 2.x.Desliga o suporte a repositórios bare no Git node. O padrão passou de
falsena 1.x paratruena 2.x.Na 1.x, o n8n avisava que o suporte a repositórios bare sairia por questão de segurança. Sem repositórios bare em uso, o valor indicado é
true.Permite que o Git node altere qualquer chave de configuração do Git.
Permite que o Git node execute hooks do Git, como o
pre-commit.Desliga o sandbox de CSP das páginas de formulário, do Form Trigger e do Send and Wait. Sem a proteção, um usuário mal-intencionado pode montar um workflow que faz requisições com as credenciais de outros usuários. A saída indicada pelo n8n é servir os formulários em outro domínio ou subdomínio.
Retira a diretiva
sandboxdo cabeçalho CSP das respostas de webhook. Para desligar toda a CSP, definaN8N_CONTENT_SECURITY_POLICYcomo{}.Exige autenticação em dois fatores de todos os usuários.
Tamanho mínimo das senhas de usuário, entre 8 e 64 caracteres.
Permite que os usuários publiquem workflows a partir do espaço pessoal.
Permite que os usuários compartilhem recursos do espaço pessoal.
Origens, separadas por vírgula, que podem enviar comandos
postMessageao editor incorporado em iframe. Vazio, o editor aceita mensagens de qualquer origem.Pastas que os Nodes de leitura e gravação de arquivos podem acessar, separadas por ponto e vírgula. Na 1.x, o padrão vazio não restringia nada. Na 2.x e na 3.x, o padrão é
~/.n8n-files. Vazio, a restrição fica desligada, o que o n8n desaconselha em produção.Valor do atributo
SameSitedo cookie de autenticação:strict,laxounone.Marca o cookie de autenticação como
Secure, enviado só por HTTPS. Em testes locais sem HTTPS, definafalsepara conseguir entrar no editor.Dias sem execução para a auditoria de segurança considerar um workflow abandonado.
Faz as variáveis de ambiente controlarem a política de segurança. A cada inicialização, os valores das variáveis substituem os do editor. Com
false, as variáveis de política de segurança são ignoradas.Objeto JSON com regras adicionais para identificar campos sensíveis. O código não traz descrição oficial.