Ir para o conteúdo
Promovaweb

Variáveis de ambiente: Credenciais e OAuth

35 variáveis das versões 1.123.92, 2.45.7 e 3.0.1

Credenciais preenchidas por variável ou endpoint, credenciais dinâmicas, acesso às credenciais de sistema da AWS e limites do servidor OAuth do n8n. 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.

  • Nome sugerido ao criar uma credencial nova.

    Tipo
    String
    Padrão
    My credentials
    Versões
    1.x aceita2.x aceita3.x aceita
  • CREDENTIALS_OVERWRITE_DATA
    • Fora da documentação

    Objeto JSON com valores preenchidos de antemão nas credenciais, no formato { "NOME_DA_CREDENCIAL": { "PARAMETRO": "VALOR" } }. Os usuários não veem nem editam esses valores. Útil para fornecer o client ID e o secret de um app OAuth da empresa.

    Tipo
    String
    Padrão
    {}
    Versões
    1.x aceita2.x aceita3.x aceita
  • Endpoint de uma API interna que devolve as substituições de credenciais. Com o valor definido, o n8n carrega as substituições desse endpoint.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Token de autenticação das chamadas ao endpoint de substituição de credenciais.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Grava as substituições de credenciais no banco para que continuem valendo depois de reiniciar.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Permite que credenciais AWS, como a awsAssumeRole, usem as credenciais do próprio sistema: variáveis de ambiente, perfil da instância ou identidade do pod.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Fontes de credenciais de sistema da AWS resolvidas pelo SDK oficial, no lugar do resolvedor antigo. Os valores aceitos são all, none ou uma lista com as fontes environment, roleForServiceAccount, podIdentity, containerMetadata e instanceMetadata. Variável de transição, prevista para sair depois da migração para o SDK.

    Tipo
    String
    Padrão
    all
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Permite que credenciais Azure Storage com Shared Key usem um endpoint personalizado, como um endpoint privado ou domínio próprio. As nuvens soberanas do Azure funcionam sem esta opção.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de requisições por IP por minuto ao endpoint POST /credentials/:id/authorize das credenciais dinâmicas.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Aceita cookies e cabeçalhos de autorização nas requisições CORS das credenciais dinâmicas. Precisa ficar false quando N8N_DYNAMIC_CREDENTIALS_CORS_ORIGIN usa *.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Origens aceitas no CORS dos endpoints de credenciais dinâmicas, separadas por vírgula. Vazio, o CORS fica desligado.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Token de autenticação dos endpoints de credenciais dinâmicas.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de requisições por IP por minuto aos endpoints de credenciais dinâmicas que não exigem autenticação.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_EMBED_LOGIN_ENABLED
    • Fora da documentação

    Liga o endpoint de login incorporado (/auth/embed), usado por parceiros que embutem o n8n em outro produto.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Liga a decifragem de tokens JWE nas credenciais OAuth 2.0, em todas as instâncias. A documentação trata o recurso como prévia. O nome não aparece no código das três linhas.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • Liga a troca de tokens para parceiros que incorporam o n8n em outro produto. Recurso em prévia.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Tipos de credencial OAuth gerenciada, separados por vírgula, cujos escopos continuam editáveis pelo usuário, como googleOAuth2Api.

    Tipo
    Lista
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_OAUTH_BROWSER_BINDING
    • Fora da documentação

    Vincula o retorno do OAuth das credenciais ao navegador que iniciou a autorização, com um cookie de sessão conferido no retorno. Impede o golpe de injetar uma URL de autorização no navegador de outra pessoa para capturar o token.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de requisições por IP por minuto ao endpoint JWKS. Precisa ser positivo, porque com 0 o n8n recusa todas as requisições.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de requisições de autorização por IP a cada 5 minutos no servidor OAuth do n8n.

    Tipo
    Number
    Padrão
    50
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de registros de cliente por IP a cada 5 minutos no servidor OAuth do n8n.

    Tipo
    Number
    Padrão
    10
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de requisições de revogação por IP a cada 5 minutos no servidor OAuth do n8n.

    Tipo
    Number
    Padrão
    30
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de requisições de token por IP a cada 5 minutos no servidor OAuth do n8n.

    Tipo
    Number
    Padrão
    20
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de requisições por IP a cada 5 minutos aos endpoints de descoberta OAuth (.well-known/*).

    Tipo
    Number
    Padrão
    100
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_QUICK_CONNECT_OPTIONS
    • Fora da documentação

    Opções de conexão rápida destacadas na criação de credenciais.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_SKIP_CREDENTIAL_OVERWRITE
    • Fora da documentação

    Tipos de credencial, separados por vírgula, cujas substituições são ignoradas quando o usuário já personalizou algum campo, como zohoOAuth2Api.

    Tipo
    Lista
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de logins incorporados por IP por minuto.

    Tipo
    Number
    Padrão
    20
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_TOKEN_EXCHANGE_ENABLED
    • Fora da documentação

    Liga o endpoint de troca de tokens (POST /auth/oauth/token), usado por parceiros que incorporam o n8n.

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

    Impede que a troca de tokens gere acesso para o usuário owner da instância.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Quantidade máxima de identificadores de token expirados apagados em cada limpeza.

    Tipo
    Number
    Padrão
    1000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Intervalo em segundos entre as limpezas de identificadores de token expirados.

    Tipo
    Number
    Padrão
    60
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Intervalo em segundos entre as atualizações das chaves confiáveis, feitas só pela instância líder.

    Tipo
    Number
    Padrão
    300
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_TOKEN_EXCHANGE_MAX_TOKEN_TTL
    • Fora da documentação

    Validade máxima em segundos de um token emitido pela troca de tokens.

    Tipo
    Number
    Padrão
    900
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Máximo de trocas de token por IP por minuto.

    Tipo
    Number
    Padrão
    20
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_TOKEN_EXCHANGE_TRUSTED_KEYS
    • Fora da documentação

    Lista JSON das fontes de chaves confiáveis usadas para verificar os JWT recebidos. Também pode vir de arquivo com N8N_TOKEN_EXCHANGE_TRUSTED_KEYS_FILE.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita