Skip to main content
LibreChat is joining ClickHouse to power the open-source Agentic Data Stack 🎉 Learn more
LibreChat

LDAP/AD

Scopri come configurare LibreChat per utilizzare LDAP per l'autenticazione degli utenti.

È possibile utilizzare un server di autenticazione Lightweight Directory Access Protocol (LDAP) per autenticare gli utenti.

Configurazione del server LDAP/AD

Configurazione di base

  • LDAP_URL e LDAP_USER_SEARCH_BASE sono obbligatori.
  • LDAP_SEARCH_FILTER è facoltativo; se non specificato, viene utilizzato per impostazione predefinita l'attributo mail. Se specificato, utilizza il valore letterale {{username}} per impiegare il nome utente fornito per la ricerca.
KeyTypeDescriptionExample
LDAP_URLstringURL del server LDAP.LDAP_URL=ldap://localhost:389
LDAP_BIND_DNstringDN di associazioneLDAP_BIND_DN=cn=root
LDAP_BIND_CREDENTIALSstringPassword per bindDNLDAP_BIND_CREDENTIALS=password
LDAP_USER_SEARCH_BASEstringBase di ricerca utenti LDAPLDAP_USER_SEARCH_BASE=o=users,o=example.com
LDAP_SEARCH_FILTERstringFiltro di ricerca LDAPLDAP_SEARCH_FILTER=mail={{username}}

Mappature dei campi

È possibile specificare una mappatura tra gli attributi degli utenti LibreChat e quelli degli utenti LDAP. Utilizzare queste impostazioni se le mappature predefinite non funzionano correttamente.

KeyTypeDescriptionExample
LDAP_IDstringSpecifica un ID utente univoco. Per impostazione predefinita, vengono utilizzati uid o sAMAccountName, mail.LDAP_ID=uid
LDAP_USERNAMEstringPer impostazione predefinita, utilizza givenName o mail.LDAP_USERNAME=givenName
LDAP_EMAILstringPer impostazione predefinita, utilizza mail.LDAP_EMAIL=userPrincipalName
LDAP_FULL_NAMEstringPer impostazione predefinita, utilizza una combinazione di givenName e surname.LDAP_FULL_NAME=givenName,surname

Nome utente o Email

Per impostazione predefinita, LibreChat utilizza un indirizzo email e una password per l'autenticazione. Ciò può talvolta causare problemi con LDAP e potresti voler utilizzare invece un nome utente. Imposta LDAP_SEARCH_FILTER per filtrare in base al nome utente (ad esempio LDAP_SEARCH_FILTER=uid={{username}}) e configura LibreChat per richiedere l'accesso tramite nome utente:

KeyTypeDescriptionExample
LDAP_LOGIN_USES_USERNAMEstringUsa il nome utente invece dell'email.LDAP_LOGIN_USES_USERNAME=true

Active Directory su SSL

Per connettersi tramite SSL (ldaps://), come nel caso di un'azienda che utilizza Windows AD, specificare il percorso del certificato CA interno. LDAP_TLS_REJECT_UNAUTHORIZED è facoltativo; se non specificato, LibreChat rifiuterà le connessioni TLS/SSL se il certificato del server LDAP non può essere verificato. Impostare LDAP_TLS_REJECT_UNAUTHORIZED su false (non consigliato per ambienti di produzione) per consentire a LibreChat di accettare connessioni TLS/SSL anche se il certificato del server LDAP non può essere verificato.

KeyTypeDescriptionExample
LDAP_CA_CERT_PATHstringPercorso del certificato CA.LDAP_CA_CERT_PATH=/path/to/root_ca_cert.crt
LDAP_TLS_REJECT_UNAUTHORIZEDstringDisabilita la verifica TLSLDAP_TLS_REJECT_UNAUTHORIZED=true

LDAP StartTLS

L'abilitazione di LDAP StartTLS consente a LibreChat di aggiornare una connessione non sicura a una connessione TLS sicura. Questo è utile se si desidera proteggere la connessione senza passare a ldaps://.

KeyTypeDescriptionExample
LDAP_STARTTLSstringAbilita LDAP StartTLS per aggiornare la connessione a TLS. Impostare su true per abilitare questa funzionalità.LDAP_STARTTLS=true

Com’è questa guida?