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

LDAP/AD

LibreChat'i kullanıcı kimlik doğrulaması için LDAP kullanacak şekilde nasıl yapılandıracağınızı öğrenin.

Kullanıcıların kimliğini doğrulamak için bir Lightweight Directory Access Protocol (LDAP) kimlik doğrulama sunucusu kullanabilirsiniz.

LDAP/AD Sunucu Yapılandırması

Temel Yapılandırma

  • LDAP_URL ve LDAP_USER_SEARCH_BASE gereklidir.
  • LDAP_SEARCH_FILTER isteğe bağlıdır; belirtilmediği takdirde varsayılan olarak mail özniteliği kullanılır. Belirtildiği durumlarda, arama için girilen kullanıcı adını kullanmak üzere değişmez {{username}} ifadesini kullanın.
KeyTypeDescriptionExample
LDAP_URLstringLDAP sunucu URL'si.LDAP_URL=ldap://localhost:389
LDAP_BIND_DNstringBağlama DNLDAP_BIND_DN=cn=root
LDAP_BIND_CREDENTIALSstringbindDN için parolaLDAP_BIND_CREDENTIALS=password
LDAP_USER_SEARCH_BASEstringLDAP kullanıcı arama tabanıLDAP_USER_SEARCH_BASE=o=users,o=example.com
LDAP_SEARCH_FILTERstringLDAP arama filtresiLDAP_SEARCH_FILTER=mail={{username}}

Alan Eşlemeleri

LibreChat kullanıcılarının öznitelikleri ile LDAP kullanıcılarının öznitelikleri arasında bir eşleme belirleyebilirsiniz. Varsayılan eşlemeler düzgün çalışmıyorsa bu ayarları kullanın.

KeyTypeDescriptionExample
LDAP_IDstringBenzersiz bir kullanıcı kimliği (UID) belirtin. Varsayılan olarak uid veya sAMAccountName, mail kullanılır.LDAP_ID=uid
LDAP_USERNAMEstringVarsayılan olarak givenName veya mail kullanır.LDAP_USERNAME=givenName
LDAP_EMAILstringVarsayılan olarak mail kullanır.LDAP_EMAIL=userPrincipalName
LDAP_FULL_NAMEstringVarsayılan olarak, givenName ve surname kombinasyonunu kullanır.LDAP_FULL_NAME=givenName,surname

Kullanıcı Adı veya E-posta

Varsayılan olarak LibreChat, kimlik doğrulama için bir e-posta adresi ve parola kullanır. Bu durum bazen LDAP ile sorunlara yol açabilir ve bunun yerine bir kullanıcı adı kullanmak isteyebilirsiniz. Bunun yerine kullanıcı adını filtrelemek için LDAP_SEARCH_FILTER değerini ayarlayın (örneğin LDAP_SEARCH_FILTER=uid={{username}}) ve LibreChat'i kullanıcı adı ile giriş isteyecek şekilde yapılandırın:

KeyTypeDescriptionExample
LDAP_LOGIN_USES_USERNAMEstringE-posta yerine kullanıcı adı kullanın.LDAP_LOGIN_USES_USERNAME=true

SSL üzerinden Active Directory

Windows AD kullanan bir şirket gibi SSL (ldaps://) üzerinden bağlanmak için, dahili CA sertifikasının yolunu belirtin. LDAP_TLS_REJECT_UNAUTHORIZED isteğe bağlıdır; belirtilmediği takdirde LibreChat, LDAP sunucusunun sertifikası doğrulanamazsa TLS/SSL bağlantılarını reddedecektir. LibreChat'in, LDAP sunucusunun sertifikası doğrulanamasa bile TLS/SSL bağlantılarını kabul etmesine izin vermek için LDAP_TLS_REJECT_UNAUTHORIZED değerini false olarak ayarlayın (üretim ortamları için önerilmez).

KeyTypeDescriptionExample
LDAP_CA_CERT_PATHstringCA sertifika yolu.LDAP_CA_CERT_PATH=/path/to/root_ca_cert.crt
LDAP_TLS_REJECT_UNAUTHORIZEDstringTLS doğrulamasını devre dışı bırakLDAP_TLS_REJECT_UNAUTHORIZED=true

LDAP StartTLS

LDAP StartTLS özelliğini etkinleştirmek, LibreChat'in güvensiz bir bağlantıyı güvenli bir TLS bağlantısına yükseltmesine olanak tanır. Bu, ldaps:// protokolüne geçiş yapmadan bağlantıyı güvenli hale getirmek istediğiniz durumlarda kullanışlıdır.

KeyTypeDescriptionExample
LDAP_STARTTLSstringBağlantıyı TLS'ye yükseltmek için LDAP StartTLS'yi etkinleştirin. Bu özelliği etkinleştirmek için true olarak ayarlayın.LDAP_STARTTLS=true

Bu rehber nasıl?