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

LDAP/AD

Aprenda a configurar LibreChat para usar LDAP para la autenticación de usuarios.

Puede utilizar un servidor de autenticación Lightweight Directory Access Protocol (LDAP) para autenticar a los usuarios.

Configuración del servidor LDAP/AD

Configuración básica

  • LDAP_URL y LDAP_USER_SEARCH_BASE son obligatorios.
  • LDAP_SEARCH_FILTER es opcional; si no se especifica, se utiliza el atributo mail de forma predeterminada. Si se especifica, utilice el literal {{username}} para usar el nombre de usuario proporcionado para la búsqueda.
KeyTypeDescriptionExample
LDAP_URLstringURL del servidor LDAP.LDAP_URL=ldap://localhost:389
LDAP_BIND_DNstringDN de enlaceLDAP_BIND_DN=cn=root
LDAP_BIND_CREDENTIALSstringContraseña para bindDNLDAP_BIND_CREDENTIALS=password
LDAP_USER_SEARCH_BASEstringBase de búsqueda de usuarios LDAPLDAP_USER_SEARCH_BASE=o=users,o=example.com
LDAP_SEARCH_FILTERstringFiltro de búsqueda LDAPLDAP_SEARCH_FILTER=mail={{username}}

Asignaciones de campos

Puede especificar una asignación entre los atributos de los usuarios de LibreChat y los de los usuarios de LDAP. Utilice estos ajustes si las asignaciones predeterminadas no funcionan correctamente.

KeyTypeDescriptionExample
LDAP_IDstringEspecifique un ID de usuario único. De forma predeterminada, se utiliza uid o sAMAccountName, mail.LDAP_ID=uid
LDAP_USERNAMEstringDe forma predeterminada, utiliza givenName o mail.LDAP_USERNAME=givenName
LDAP_EMAILstringDe forma predeterminada, utiliza mail.LDAP_EMAIL=userPrincipalName
LDAP_FULL_NAMEstringDe forma predeterminada, utiliza una combinación de givenName y surname.LDAP_FULL_NAME=givenName,surname

Nombre de usuario o correo electrónico

De forma predeterminada, LibreChat utiliza una dirección de correo electrónico y una contraseña para la autenticación. Esto a veces puede causar problemas con LDAP y es posible que desee utilizar un nombre de usuario en su lugar. Configure LDAP_SEARCH_FILTER para filtrar por el nombre de usuario (por ejemplo, LDAP_SEARCH_FILTER=uid={{username}}) y configure LibreChat para solicitar el inicio de sesión mediante nombre de usuario:

KeyTypeDescriptionExample
LDAP_LOGIN_USES_USERNAMEstringUsar nombre de usuario en lugar de correo electrónico.LDAP_LOGIN_USES_USERNAME=true

Active Directory sobre SSL

Para conectarse a través de SSL (ldaps://), como en el caso de una empresa que utiliza Windows AD, especifique la ruta al certificado de la CA interna. LDAP_TLS_REJECT_UNAUTHORIZED es opcional; si no se especifica, LibreChat rechazará las conexiones TLS/SSL si el certificado del servidor LDAP no puede ser verificado. establezca LDAP_TLS_REJECT_UNAUTHORIZED en false (no recomendado para entornos de producción) para permitir que LibreChat acepte conexiones TLS/SSL incluso si el certificado del servidor LDAP no puede ser verificado.

KeyTypeDescriptionExample
LDAP_CA_CERT_PATHstringRuta del certificado CA.LDAP_CA_CERT_PATH=/path/to/root_ca_cert.crt
LDAP_TLS_REJECT_UNAUTHORIZEDstringDeshabilitar la verificación TLSLDAP_TLS_REJECT_UNAUTHORIZED=true

LDAP StartTLS

Habilitar LDAP StartTLS permite a LibreChat actualizar una conexión insegura a una conexión TLS segura. Esto es útil si desea asegurar la conexión sin cambiar a ldaps://.

KeyTypeDescriptionExample
LDAP_STARTTLSstringHabilite LDAP StartTLS para actualizar la conexión a TLS. Establézcalo en true para habilitar esta función.LDAP_STARTTLS=true

¿Qué te parece esta guía?