LDAP

Importazione di utenti e gruppi

1. Accedi al tuo ONLYOFFICE DocSpace.
2. Utilizza il menu nell'angolo in basso a sinistra e seleziona l'opzione Impostazioni.
3. Apri la pagina Impostazioni LDAP nella sezione Integrazione nella barra laterale sinistra.
4. Fai clic sull'interruttore Autenticazione LDAP (usa il link Mostra accanto al titolo Impostazioni LDAP per visualizzare il modulo dei parametri se non è la prima volta che modifichi le impostazioni).
5. Seleziona la casella Abilita StartTLS se desideri proteggere le tue connessioni utilizzando la tecnologia StartTLS (in questo caso, viene utilizzata la porta predefinita 389). Seleziona la casella Abilita SSL se desideri utilizzare il protocollo SSL (in questo caso, viene utilizzata la porta 636).
6. Compila i campi necessari per l'importazione degli utenti (i campi obbligatori sono contrassegnati con un asterisco):
   
   Attenzione Si prega di notare che nel caso in cui tu abbia già importato alcuni utenti e modificato alcune delle impostazioni (ad esempio, Server, Filtro Utenti, User DN, Filtro Gruppo, Group DN), gli utenti esistenti e tutti i loro dati, inclusi documenti, email, ecc. che non corrispondono a queste nuove impostazioni verranno DISABILITATI. Raccomandiamo vivamente di creare un backup prima di modificare qualsiasi impostazione.
   • nel campo Server, inserisci l'indirizzo URL del server LDAP nella forma protocol://host, ad esempio LDAP://example.com per una connessione LDAP regolare o LDAPS://example.com per una connessione LDAP sicura tramite SSL. Puoi anche specificare l'indirizzo IP del server invece del suo nome DNS: LDAP://192.168.3.202;
   • specifica un Numero di Porta utilizzato per accedere al server LDAP. La porta predefinita per le connessioni LDAP regolari è 389. Se hai abilitato l'opzione StartTLS, viene utilizzata anche la porta predefinita 389. Se l'opzione SSL è abilitata, viene utilizzata la porta 636;
   • nel campo User DN (User Distinguished Name), specifica il percorso assoluto alla directory di livello superiore contenente gli utenti che desideri importare. Questo parametro definisce il nodo da cui inizia la ricerca. Puoi specificare la directory radice, ad esempio dc=example,dc=com, per cercare gli utenti all'interno dell'intera directory, o specificare un'area di ricerca certa, ad esempio ou=groupname,dc=example,dc=com, per cercare gli utenti all'interno del gruppo specificato;
   • specifica il valore dell'Attributo di Login (un attributo in un record utente che corrisponde al login che gli utenti del server LDAP utilizzeranno per accedere a ONLYOFFICE);

     Per OpenLDAP Server, usa le seguenti impostazioni:

     • Filtro Utenti - (uid=*)
     • Attributo di Login - uid

     Per Active Directory, usa le seguenti impostazioni:

     • Filtro Utenti - (userPrincipalName=*)
     • Attributo di Login - sAMAccountName
   • compila il campo Filtro Utenti se hai bisogno di importare gli utenti che corrispondono ai criteri di ricerca specificati. Il valore del filtro predefinito (uid=*) o (userPrincipalName=*) consente di importare tutti gli utenti;
     Puoi trovare esempi di sintassi del filtro di ricerca qui.
7. La sezione Mapping degli Attributi ti consente di impostare una corrispondenza tra i campi dati utente su DocSpace e gli attributi nel record utente del server LDAP. Fai clic sul pulsante Aggiungi Attributo, scegli il campo dati necessario dall'elenco e specifica l'attributo utente utilizzato nel tuo server LDAP. I seguenti parametri sono impostati per impostazione predefinita, ma puoi cambiarli se necessario:
   
   • Nome (un attributo in un record utente che corrisponde al nome dell'utente)
   • Cognome (un attributo in un record utente che corrisponde al cognome dell'utente)
   • Email (un attributo in un record utente che corrisponde all'indirizzo email dell'utente)
   • Foto del profilo (un attributo in un record utente che corrisponde alla foto dell'utente)

   Puoi anche aggiungere i seguenti attributi:

   • Quota Utente - per impostare una quota di archiviazione per questo utente, inserisci un valore intero per questo attributo nella directory LDAP. Verrà visualizzato il valore della quota in byte. Questo attributo verrà applicato solo durante la prima configurazione e può essere modificato manualmente nella sezione Account.
   • Tipo Utente - tutti gli utenti verranno aggiunti a DocSpace con il tipo selezionato (utente, amministratore della stanza, amministratore di DocSpace). Il tipo Utente è selezionato per impostazione predefinita. Gli utenti possono accedere solo alle stanze a cui sono invitati dagli amministratori e non possono creare stanze, cartelle o file propri. Seleziona un altro tipo per fornire più permessi. In alternativa, puoi cambiare il tipo manualmente nella sezione Contatti.
8. Fai clic sull'interruttore Appartenenza al Gruppo se desideri aggiungere gruppi dal server LDAP al tuo DocSpace e compila i campi necessari:
   Si prega di notare che se decidi di aggiungere gruppi, verranno aggiunti solo gli utenti che appartengono ad almeno un gruppo.
   
   Attenzione Si prega di notare che nel caso in cui tu abbia già importato alcuni utenti e modificato alcune delle impostazioni (ad esempio, Server, Filtro Utenti, User DN, Filtro Gruppo, Group DN), gli utenti esistenti e tutti i loro dati, inclusi documenti, email, ecc. che non corrispondono a queste nuove impostazioni verranno DISABILITATI. Raccomandiamo vivamente di creare un backup prima di modificare qualsiasi impostazione.
   • nel campo Group DN (Group Distinguished Name), specifica il percorso assoluto alla directory di livello superiore contenente i gruppi che desideri importare, ad esempio ou=Groups,dc=example,dc=com.
   • compila il campo Filtro Gruppo se hai bisogno di importare i gruppi che corrispondono ai criteri di ricerca specificati. Il valore del filtro predefinito (objectClass=posixGroup) o (objectClass=group) consente di importare tutti i gruppi.
   • i seguenti parametri sono impostati per impostazione predefinita, ma puoi cambiarli se necessario:
     • Attributo Utente (un attributo che determina se questo utente è membro dei gruppi)
     • Attributo Nome Gruppo (un attributo che corrisponde al nome del gruppo in cui l'utente è incluso)
     • Attributo Gruppo (un attributo che specifica gli utenti che il gruppo include)

     Per OpenLDAP Server, usa le seguenti impostazioni:

     • Filtro Gruppo - (objectClass=posixGroup)
     • Attributo Utente - uid
     • Attributo Gruppo - memberUid

     Per Active Directory, usa le seguenti impostazioni:

     • Filtro Gruppo - (objectClass=group)
     • Attributo Utente - distinguishedName
     • Attributo Gruppo - member
9. Attiva l'interruttore Autenticazione se l'utente Windows corrente non ha i diritti per leggere dal server LDAP/Active Directory. Nei campi Login e Password, inserisci le credenziali dell'utente che ha i diritti per leggere i dati dal server LDAP (impostato di default sul login e password della sessione Windows corrente).
10. Seleziona la casella Invia lettera di benvenuto nella sezione Impostazioni avanzate se desideri inviare inviti via email a tutti i nuovi utenti. Il messaggio di benvenuto contiene un pulsante che consente agli utenti di andare alla pagina di login di DocSpace e attivare l'email. Questa opzione è disponibile solo se il mapping dell'attributo email è configurato.
11. Seleziona la casella Disabilita verifica email nella sezione Impostazioni avanzate se desideri disabilitare l'attivazione email per gli utenti LDAP. Se questa casella è selezionata, gli utenti LDAP non dovranno verificare la loro email dopo la prima autorizzazione in DocSpace.
12. Fai clic sul pulsante Salva.
13. Nella finestra 'Conferma importazione' che appare, fai clic sul pulsante OK per avviare l'importazione degli utenti.

Il processo di importazione richiederà del tempo a seconda del numero di utenti, gruppi, specifiche del computer, ecc.

Ci sono alcune caratteristiche speciali:

• il proprietario di DocSpace non è influenzato dalla modifica dei diritti di accesso tramite LDAP;
• se il proprietario di DocSpace è stato escluso dal filtro utente/gruppo, cessa di essere un utente LDAP ma rimane sempre attivo;
• quando si disabilita LDAP, tutti i diritti di accesso forniti agli utenti tramite LDAP vengono revocati;
  • se l'utente che ha disabilitato LDAP dovrebbe perdere i diritti di amministratore, i suoi diritti di amministratore non sono influenzati e l'utente riceve una notifica;
• se un utente è stato escluso dal filtro utente/gruppo, rimane attivo e riceve una notifica che la password LDAP non è più attiva e deve essere cambiata nella pagina delle impostazioni del profilo;
• se un utente tenta di revocare i diritti di amministratore da se stesso (sia tramite le impostazioni dei diritti di accesso che escludendosi dal filtro utente/gruppo), i suoi diritti di amministratore non sono influenzati e l'utente riceve una notifica.

Autenticazione degli utenti LDAP

Ogni utente importato sarà in grado di accedere a DocSpace utilizzando il login che è formato secondo i seguenti schemi:

• Attributo Login, ad es. Andrew.Stone
• Attributo Login + @ + Dominio LDAP, ad es. Andrew.Stone@example.com
• Dominio LDAP + \ + Attributo Login (sono supportati nomi di dominio incompleti), ad es. example\Andrew.Stone

Sulla pagina di autorizzazione, è disponibile l'opzione Accedi al dominio che consente di trasferire una password in forma esplicita. Gli utenti del portale al di fuori del dominio possono deselezionare questa impostazione. In tal caso, una password sarà trasferita in forma crittografata.

I profili utente importati nella sezione Account saranno contrassegnati con l'icona per l'amministratore di DocSpace. I campi del profilo utente che sono stati importati utilizzando LDAP sono bloccati per la modifica, eccetto il Tipo di Utente, la Quota Utente specificata come iniziale.

Sincronizzazione dei dati LDAP

Se modifichi i dati nel tuo server LDAP (ad es. aggiungi nuovi utenti/gruppi, rinomini gruppi esistenti o modifichi alcune informazioni in un record utente), puoi facilmente sincronizzare i dati di DocSpace con le nuove informazioni dal tuo server LDAP.

Per regolare le opzioni di sincronizzazione, attiva l'interruttore Sincronizzazione automatica e imposta l'orario necessario per eseguire la sincronizzazione automatica: puoi sincronizzare i dati ogni ora a minuti specificati, o ogni giorno a un'ora specificata, così come ogni settimana o mese in un giorno e orario specificati. Fai clic su Salva per applicare le impostazioni. È anche possibile sincronizzare i dati manualmente facendo clic sul pulsante Sincronizza utenti in fondo alla pagina LDAP. In alternativa, puoi usare il pulsante Salva sotto la sezione Impostazioni LDAP.

Le informazioni su un singolo utente saranno anche sincronizzate dopo che questo utente ha effettuato l'accesso a DocSpace.