Ir para o conteúdo
Promovaweb

Variáveis de ambiente: SSO, LDAP e SCIM

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

Login por SAML, OIDC e LDAP, provisionamento de usuários e o limite de requisições do SCIM. 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.

  • N8N_SCIM_RATE_LIMIT
    • Fora da documentação

    Máximo de requisições por IP a cada 5 minutos aos endpoints SCIM (/scim/v2/*). O padrão comporta a primeira sincronização completa do provedor de identidade. Com 0, o limite por IP fica desligado.

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

    Cria o usuário automaticamente no primeiro login por SSO.

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

    Liga o login por LDAP.

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

    Texto do botão de login por LDAP.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Faz as variáveis de ambiente definirem a conexão de SSO a cada inicialização. A tela de configuração de SSO fica somente leitura.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Valores ACR enviados na autorização OIDC, separados por vírgula.

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

    Escopos extras, separados por espaço, acrescentados ao pedido de autorização OIDC.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Client ID emitido pelo provedor de identidade OIDC.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Client secret emitido pelo provedor de identidade OIDC.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • URL de descoberta OIDC do provedor de identidade, a que termina em .well-known/openid-configuration.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Liga o login por OIDC.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Valor do parâmetro prompt enviado ao provedor OIDC, como select_account para pedir a escolha do usuário.

    Tipo
    String
    Padrão
    select_account
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Encerra também a sessão no provedor OIDC quando o usuário sai do n8n.

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

    Leva a tela de login direto para o SSO, sem mostrar email e senha.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Liga o login por SAML.

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

    Texto do botão de login por SAML.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • XML de metadados do provedor de identidade SAML.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • URL de onde o n8n busca os metadados SAML. Use esta ou N8N_SSO_SAML_METADATA, não as duas.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Nome da claim do SSO com o papel do usuário na instância.

    Tipo
    String
    Padrão
    n8n_instance_role
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_SSO_SCOPES_NAME
    • Fora da documentação

    Nome do escopo pedido ao provedor para trazer os papéis do usuário.

    Tipo
    String
    Padrão
    n8n
    Versões
    1.x aceita2.x aceita3.x aceita
  • Nome da claim do SSO com os papéis do usuário em cada projeto.

    Tipo
    String
    Padrão
    n8n_projects
    Versões
    1.x aceita2.x aceita3.x aceita
  • Define o papel do usuário na instância a partir da claim do SSO no login.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Define os papéis do usuário nos projetos a partir da claim do SSO no login.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Usa regras de mapeamento por expressão para definir os papéis, no lugar das claims diretas do SSO. As duas formas não funcionam juntas.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Papéis definidos pelas claims diretas do SSO: disabled, instance_role ou instance_and_project_roles. É ignorada quando o mapeamento por expressão está ligado.

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