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

LDAP/AD

Pelajari cara mengonfigurasi LibreChat untuk menggunakan LDAP demi autentikasi pengguna.

Anda dapat menggunakan server autentikasi Lightweight Directory Access Protocol (LDAP) untuk mengautentikasi pengguna.

Konfigurasi Server LDAP/AD

Konfigurasi Dasar

  • LDAP_URL dan LDAP_USER_SEARCH_BASE wajib diisi.
  • LDAP_SEARCH_FILTER bersifat opsional; jika tidak ditentukan, atribut mail digunakan secara default. Jika ditentukan, gunakan literal {{username}} untuk menggunakan nama pengguna yang diberikan untuk pencarian.
KeyTypeDescriptionExample
LDAP_URLstringURL server LDAP.LDAP_URL=ldap://localhost:389
LDAP_BIND_DNstringDN PengikatanLDAP_BIND_DN=cn=root
LDAP_BIND_CREDENTIALSstringKata sandi untuk bindDNLDAP_BIND_CREDENTIALS=password
LDAP_USER_SEARCH_BASEstringBasis pencarian pengguna LDAPLDAP_USER_SEARCH_BASE=o=users,o=example.com
LDAP_SEARCH_FILTERstringFilter pencarian LDAPLDAP_SEARCH_FILTER=mail={{username}}

Pemetaan Bidang

Anda dapat menentukan pemetaan antara atribut pengguna LibreChat dan atribut pengguna LDAP. Gunakan pengaturan ini jika pemetaan default tidak berfungsi dengan benar.

KeyTypeDescriptionExample
LDAP_IDstringTentukan ID pengguna yang unik. Secara default, uid atau sAMAccountName, mail yang digunakan.LDAP_ID=uid
LDAP_USERNAMEstringSecara default, ini menggunakan givenName atau mail.LDAP_USERNAME=givenName
LDAP_EMAILstringSecara default, ini menggunakan mail.LDAP_EMAIL=userPrincipalName
LDAP_FULL_NAMEstringSecara default, ini menggunakan kombinasi dari givenName dan surname.LDAP_FULL_NAME=givenName,surname

Nama Pengguna atau Email

Secara default, LibreChat menggunakan alamat email dan kata sandi untuk autentikasi. Hal ini terkadang dapat menyebabkan masalah dengan LDAP dan Anda mungkin ingin menggunakan nama pengguna sebagai gantinya. Atur LDAP_SEARCH_FILTER untuk memfilter berdasarkan nama pengguna (contoh: LDAP_SEARCH_FILTER=uid={{username}}) dan konfigurasikan LibreChat untuk meminta login melalui nama pengguna:

KeyTypeDescriptionExample
LDAP_LOGIN_USES_USERNAMEstringGunakan nama pengguna alih-alih email.LDAP_LOGIN_USES_USERNAME=true

Active Directory melalui SSL

Untuk terhubung melalui SSL (ldaps://), seperti perusahaan yang menggunakan Windows AD, tentukan jalur ke sertifikat CA internal. LDAP_TLS_REJECT_UNAUTHORIZED bersifat opsional; jika tidak ditentukan, LibreChat akan menolak koneksi TLS/SSL jika sertifikat server LDAP tidak dapat diverifikasi. atur LDAP_TLS_REJECT_UNAUTHORIZED ke false (tidak disarankan untuk lingkungan produksi) agar LibreChat dapat menerima koneksi TLS/SSL meskipun sertifikat server LDAP tidak dapat diverifikasi.

KeyTypeDescriptionExample
LDAP_CA_CERT_PATHstringJalur sertifikat CA.LDAP_CA_CERT_PATH=/path/to/root_ca_cert.crt
LDAP_TLS_REJECT_UNAUTHORIZEDstringNonaktifkan verifikasi TLSLDAP_TLS_REJECT_UNAUTHORIZED=true

LDAP StartTLS

Mengaktifkan LDAP StartTLS memungkinkan LibreChat untuk meningkatkan koneksi yang tidak aman menjadi koneksi TLS yang aman. Hal ini berguna jika Anda ingin mengamankan koneksi tanpa beralih ke ldaps://.

KeyTypeDescriptionExample
LDAP_STARTTLSstringAktifkan LDAP StartTLS untuk meningkatkan koneksi ke TLS. Atur ke true untuk mengaktifkan fitur ini.LDAP_STARTTLS=true

Bagaimana panduan ini?