Ir para o conteúdo
Promovaweb

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 de false na 1.x para true na 2.x. Defina false se 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 de false.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Impede que os Nodes leiam ou gravem nas pastas internas do n8n, como ~/.n8n e ~/.cache/n8n/public. A restrição vale também para as pastas definidas em variáveis como N8N_CUSTOM_EXTENSIONS e N8N_BINARY_DATA_STORAGE_PATH.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_BLOCK_FILE_PATTERNS
    • Fora da documentação

    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.

    Tipo
    String
    Padrão
    ^(?:[^/]*/)*\\.git(?:/.*)?$
    Versões
    1.x aceita2.x aceita3.x aceita
  • Permissões retiradas do espaço pessoal de cada usuário, separadas por vírgula. Aceita só credential:create, dataTable:create e agent:create. A lista só vale com N8N_CANVAS_ONLY ligado. O n8n reaplica a lista a cada inicialização.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    String
    Padrão
    1.x{}2.xscript-src <nonce> 'strict-dynamic' 'unsafe-eval'; object-src 'none'; base-uri 'none'3.xscript-src <nonce> 'strict-dynamic' 'unsafe-eval'; object-src 'none'; base-uri 'none'
    Versões
    1.x aceita2.x aceita3.x aceita
  • Política enviada como Content-Security-Policy-Report-Only, nos mesmos formatos de N8N_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.

    Tipo
    String
    Padrão
    1.xfalse2.xcalculado pelo n8n3.xcalculado pelo n8n
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_CROSS_ORIGIN_OPENER_POLICY
    • Fora da documentação

    Valor do cabeçalho Cross-Origin-Opener-Policy enviado pelo n8n.

    Tipo
    Enum
    Padrão
    same-origin-allow-popups
    Versões
    1.x não aceita2.x aceita3.x aceita
    Valores
    • same-origin
    • same-origin-allow-popups
  • 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 de false na 1.x para true na 2.x.

    Tipo
    Boolean
    Padrão
    1.xfalse2.xtrue3.xtrue
    Versões
    1.x aceita2.x aceita3.x aceita
  • Desliga o suporte a repositórios bare no Git node. O padrão passou de false na 1.x para true na 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.

    Tipo
    Boolean
    Padrão
    1.xfalse2.xtrue3.xtrue
    Versões
    1.x aceita2.x aceita3.x aceita
  • Permite que o Git node altere qualquer chave de configuração do Git.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Permite que o Git node execute hooks do Git, como o pre-commit.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Retira a diretiva sandbox do cabeçalho CSP das respostas de webhook. Para desligar toda a CSP, defina N8N_CONTENT_SECURITY_POLICY como {}.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Exige autenticação em dois fatores de todos os usuários.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_PASSWORD_MIN_LENGTH
    • Fora da documentação

    Tamanho mínimo das senhas de usuário, entre 8 e 64 caracteres.

    Tipo
    Number
    Padrão
    8
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Permite que os usuários publiquem workflows a partir do espaço pessoal.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Permite que os usuários compartilhem recursos do espaço pessoal.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Origens, separadas por vírgula, que podem enviar comandos postMessage ao editor incorporado em iframe. Vazio, o editor aceita mensagens de qualquer origem.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    String
    Padrão
    1.xvazio2.x~/.n8n-files3.x~/.n8n-files
    Versões
    1.x aceita2.x aceita3.x aceita
  • Dias sem execução para a auditoria de segurança considerar um workflow abandonado.

    Tipo
    Number
    Padrão
    90
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Objeto JSON com regras adicionais para identificar campos sensíveis. O código não traz descrição oficial.

    Tipo
    String
    Padrão
    {}
    Versões
    1.x não aceita2.x aceita3.x aceita