Migrare a LDAP o SAML

{
  _id:        '123',
  email:      '[e-mail]'
  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:

Alice:
  - uid:  'alicejones'
  - mail: '[e-mail]'
  - 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.

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.

1. 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 [e-mail] a [e-mail].

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

   Se hai molti utenti, puoi usare lo script di migrazione dei nomi utente per cambiare in blocco l’indirizzo email principale degli utenti.

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

   Puoi trovare le informazioni utili per abilitare LDAP qui e SAML 2.0 qui.

3. Ora gli utenti possono accedere tramite LDAP o SAML

   La prossima volta che Alice effettuerà l’accesso, vedrà il nuovo modulo.

   

   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.

   

   Consulta la pagina Variabili d’ambiente 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.

​

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.

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

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

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

   Se non l’hai ancora fatto, consulta la nostra guida per abilitare l’invio delle email.

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