> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticação

<Info>
  Este recurso foi desenvolvido por [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep).
</Info>

São suportados 3 métodos de autenticação. Após a configuração, você poderá fazer login com as seguintes opções, como mostra a imagem abaixo.

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-33.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=fd0bdcc31b169d87dea8fc5fa612da9c" alt="" width="2526" height="1721" data-path="images/on-premises/image-33.png" />
</Frame>

Recomendamos fortemente o uso de OIDC, pois é o método mais genérico.

<Columns cols={2}>
  <Column>
    <Card title="Autenticação OIDC" icon="file-lines" href="/pt/on-premises/configuration/overleaf-toolkit/authentication/oidc-authentication" horizontal />

    <Card title="Autenticação LDAP" icon="file-lines" href="/pt/on-premises/configuration/overleaf-toolkit/authentication/ldap-authentication" horizontal />
  </Column>

  <Column>
    <Card title="Autenticação SAML" icon="file-lines" href="/pt/on-premises/configuration/overleaf-toolkit/authentication/saml-authentication" horizontal />
  </Column>
</Columns>

### Configuração global

A variável de ambiente `EXTERNAL_AUTH` é obrigatória para habilitar o módulo de autenticação específico. Essa variável de ambiente especifica quais métodos de autenticação externa são ativados. As opções disponíveis são (em letras minúsculas):

* saml
* ldap
* oidc

### Sugestões para SSO

Testei saml, ldap e oauth no Overleaf. Tanto saml quanto oauth funcionam bem no Overleaf, mas o ldap depende. Ele não funciona bem com [https://docs.goauthentik.io/](https://docs.goauthentik.io/), mas funciona bem com o openLDAP ([https://github.com/rroemhild/docker-test-openldap](https://github.com/rroemhild/docker-test-openldap)).

<Info>
  Precisamos atualizar o passport-ldapauth: recentemente tentei testar o LDAP do Overleaf com [https://goauthentik.io/](https://goauthentik.io/) e falhou. Depois de atualizar o "passport-ldapauth" para 3.0.0, tudo funcionou bem.

  ```text theme={null}
  "passport-ldapauth": "^3.0.0",
  ```

  A versão original era 2.x.x, de 6 anos atrás.
</Info>

Não tenho certeza do motivo, porque todos dependemos de um pacote externo para fazer a autenticação LDAP (e também saml e oauth). Se não funcionar, a situação pode ser a mesma no Overleaf Server Pro, pois apenas repassamos todas as variáveis de ambiente para o pacote interno; se houver bugs, no momento não temos como saber.

**Por isso, recomendo fortemente que nossos usuários configurem um ambiente de desenvolvimento para testar o SSO com todo o código-fonte**, disponível em [Setup Develop Environment (Local)](/pt/dev/environment/setup-develop-environment-local "mention"). No ambiente de desenvolvimento, você pode ver todos os logs no terminal, o que facilita a depuração.

\\

<br />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.