> ## 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.

# Migrare a LDAP o SAML

```text theme={null}
{
  _id:        '123',
  email:      'alice@example.com'
  first_name: 'Alice',
  last_name:  'Jones'
}
```

Ora vuoi integrarti con il sistema LDAP/Active Directory della tua azienda. In quel sistema, i dati di Alice sono:

```text theme={null}
Alice:
  - uid:  'alicejones'
  - mail: 'alicejones@tech.example.com'
  - givenName:   'Alice'
  - sn: 'Jones'
```

Il tuo obiettivo è far sì che Alice acceda con il suo nome utente LDAP (`alicejones`) e la sua password anziché con le vecchie credenziali di Overleaf, senza perdere nulla del suo lavoro. Ecco come fare.

<Warning>
  Questo processo richiede di ricreare il container **sharelatex**, il che comporterà un periodo di inattività. Ti consigliamo vivamente di prendere familiarità con questo processo eseguendolo prima in un ambiente di test/staging.
</Warning>

<Steps>
  <Step title="Chiedi agli utenti di aggiornare i propri indirizzi email">
    Gli account Overleaf sono legati agli indirizzi email, quindi il primo passo è allineare le email Overleaf degli utenti con le loro email LDAP o SAML.

    Nel nostro esempio, chiederesti ad Alice di accedere al suo account Overleaf e di cambiare la sua email da `alice@example.com` a `alicejones@tech.example.com`.

    <Warning>
      Non dimenticarti di te stesso! Se sei un amministratore, dovrai aggiornare anche il tuo indirizzo email.
    </Warning>

    <Check>
      Se hai molti utenti, puoi usare lo script di [migrazione dei nomi utente](/it/on-premises/user-and-project-management/user-management/username-migration) per cambiare in blocco l'indirizzo email principale degli utenti.
    </Check>
  </Step>

  <Step title="Abilita il modulo LDAP o SAML">
    Una volta aggiornati gli indirizzi email di tutti, è il momento di attivare l'interruttore! Dovrai impostare le variabili d'ambiente corrette per il nuovo metodo di autenticazione e poi ricreare il container **sharelatex** con il comando `bin/up -d`.

    In questo modo il modulo di accesso standard di Overleaf viene sostituito da quello LDAP o SAML.

    <Info>
      Puoi trovare le informazioni utili per abilitare LDAP [qui](/it/on-premises/configuration/overleaf-toolkit/authentication/ldap-authentication) e SAML 2.0 [qui](/it/on-premises/configuration/overleaf-toolkit/authentication/saml-authentication).
    </Info>
  </Step>

  <Step title="Ora gli utenti possono accedere tramite LDAP o SAML">
    La prossima volta che Alice effettuerà l'accesso, vedrà il nuovo modulo.

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-4.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=d1ff36e97d059a8833611541dfcdc317" alt="Pagina di accesso LDAP/Active Directory" width="348" height="261" data-path="images/on-premises/image-4.jpg" />

    Potrà inserire il suo nome utente LDAP (`alicejones`) e la sua password e, poiché il suo indirizzo email ora corrisponde a quello in LDAP, accederà direttamente al suo account Overleaf esistente. Tutti i suoi progetti saranno esattamente dove li aveva lasciati.

    Se hai abilitato SAML 2.0, gli utenti vedranno un pulsante che, una volta cliccato, li reindirizzerà al tuo IdP per inserire le credenziali. Se l'autenticazione riesce, verranno reindirizzati alla tua istanza Overleaf e avranno accesso al proprio account.

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-5.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=5a3486d88ffd5fe90549a596c05d7aa9" alt="Pagina di accesso SAML" width="353" height="198" data-path="images/on-premises/image-5.jpg" />

    <Info>
      Consulta la pagina [Variabili d'ambiente](/it/on-premises/configuration/overleaf-toolkit/environment-variables) per informazioni su come personalizzare la pagina di accesso.

      Se in futuro dovessi tornare indietro, basta commentare la configurazione LDAP/SAML e ricreare il container **sharelatex** con il comando `bin/up -d`. Gli utenti potranno quindi accedere con il loro indirizzo email attuale e la password specifica di Overleaf.
    </Info>
  </Step>
</Steps>

## Il percorso inverso: tornare da LDAP/SAML all'autenticazione nativa

E se usi LDAP o SAML da un po' di tempo e vuoi passare al sistema di accesso integrato di Overleaf (magari perché hai dismesso LDAP)? Nessun problema! Ecco come effettuare il passaggio.

<Steps>
  <Step title="Verifica che l'email di tutti sia corretta">
    Gli account dei tuoi utenti sono già collegati ai loro indirizzi email LDAP o SAML. Questa è l'email che useranno per accedere d'ora in poi, quindi assicurati che tutto sia corretto.
  </Step>

  <Step title="Disabilita il modulo LDAP o SAML">
    Rimuovi o annulla semplicemente le impostazioni di configurazione LDAP/SAML e ricrea il container **sharelatex** con il comando `bin/up -d`. In questo modo tornerà il modulo di accesso nativo di Overleaf con email e password.

    <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-6.jpg?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=6ab39d406809e864fc337f47bbd3b03b" alt="Pagina di accesso con autenticazione nativa" width="407" height="279" data-path="images/on-premises/image-6.jpg" />
  </Step>

  <Step title="Chiedi agli utenti di reimpostare le password">
    Ora, quando gli utenti visiteranno la pagina di accesso, vedranno il modulo di accesso di Overleaf anziché quello LDAP/SAML.

    Poiché potrebbero non aver mai avuto una password nativa di Overleaf, dovranno crearne una. Ogni utente dovrà:

    * Fare clic sul link "Forgot your password?".
    * Inserire l'indirizzo email associato al proprio account (quello di LDAP/SAML).
    * Seguire il link nell'email di reimpostazione della password per impostarne una nuova.

    <Info>
      Se non l'hai ancora fatto, consulta la nostra guida per abilitare l'[invio delle email](/it/on-premises/configuration/overleaf-toolkit/email-delivery).
    </Info>

    Fatto ciò, potranno accedere con la loro email e la nuova password specifica di Overleaf per accedere a tutti i loro progetti.
  </Step>
</Steps>


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