> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/on-premises/it/configurazione/overleaf-toolkit/authentication.md).

# Autenticazione

Questa funzionalità è sviluppata da [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep). Sono supportati 3 metodi di autenticazione. Dopo la configurazione, puoi accedere con le seguenti opzioni, come mostra l'immagine qui sotto.

<figure><img src="/files/f6a50b9525b14e8e84d52f825bca5221dc8ecea4" alt=""><figcaption></figcaption></figure>

Ti consigliamo vivamente di usare OIDC, poiché è il metodo più generale.

{% columns %}
{% column width="50%" %}
{% content-ref url="/spaces/SjaUk5aLrCK3iKWt3sy9/pages/3d1fd0ff1af8a18cc45263e6471c8302c6a68e76" %}
[Autenticazione OIDC](/on-premises/it/configurazione/overleaf-toolkit/authentication/oidc-authentication.md)
{% endcontent-ref %}

{% content-ref url="/spaces/SjaUk5aLrCK3iKWt3sy9/pages/5bd45825d7dbab6de579559a19f2ec7e5b89c1d7" %}
[Autenticazione LDAP](/on-premises/it/configurazione/overleaf-toolkit/authentication/ldap-authentication.md)
{% endcontent-ref %}
{% endcolumn %}

{% column width="50%" %}
{% content-ref url="/spaces/SjaUk5aLrCK3iKWt3sy9/pages/f9523005975ec04699fb575a88f55d25e7196646" %}
[Autenticazione SAML](/on-premises/it/configurazione/overleaf-toolkit/authentication/saml-authentication.md)
{% endcontent-ref %}

{% endcolumn %}
{% endcolumns %}

### Configurazione globale

La variabile d'ambiente `EXTERNAL_AUTH` è necessario per abilitare il modulo di autenticazione specifico. Questa variabile d'ambiente specifica quali metodi di autenticazione esterni sono attivati. Le opzioni disponibili sono (in minuscolo):

* saml
* ldap
* oidc

### Suggerimenti per SSO

Ho testato saml, ldap, oauth per Overleaf. Sia saml che oauth funzionano bene in Overleaf, ma ldap dipende. Non può funzionare bene per <https://docs.goauthentik.io/>, ma funziona bene in OpenLDAP (<https://github.com/rroemhild/docker-test-openldap>).

{% hint style="info" %}
Dobbiamo aggiornare passport-ldapauth; recentemente sto cercando di testare l'LDAP di Overleaf con <https://goauthentik.io/> , è fallito. Dopo aver aggiornato "passport-ldapauth" alla 3.0.0, tutto funziona bene.

```
"passport-ldapauth": "^3.0.0",
```

L'originale è la 2.x.x, che risale a 6 anni fa.
{% endhint %}

Non sono sicuro del motivo, perché dipendiamo tutti da un pacchetto esterno per l'autenticazione LDAP (anche saml, oauth). Se non funziona, la situazione può essere la stessa per Overleaf Server Pro, perché passiamo semplicemente tutte le variabili d'ambiente al pacchetto interno; se ci sono bug, al momento non ne abbiamo idea.

**Quindi consiglio vivamente ai nostri utenti di configurare un ambiente di sviluppo per testare l'SSO con tutto il codice sorgente**, che è disponibile all'indirizzo [Setup Develop Environment (Local)](/dev/environment/setup-develop-environment-local.md). Nell'ambiente di sviluppo, puoi vedere tutti i log nel terminale, il che rende comodo per il debug.

\ <br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/on-premises/it/configurazione/overleaf-toolkit/authentication.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.