LDAP / Active Directory
Yapmak istediğiniz: kullanıcıların dizin hesaplarıyla giriş yapmasını sağlamak.
LDAP, local hesapların yanında çalışır. Varsayılan olarak bir kişinin giriş yapabilmesi için önce OpenConsole hesabı olması gerekir; bu yüzden kişileri içe aktarırsınız. Ya da OpenConsole'un hesabı ilk girişte oluşturmasına izin verirsiniz.
1. Yapılandırma
Yönetim → LDAP (aşağıdaki değerler örnektir):


| Alan | Anlamı |
|---|---|
| Etkin | LDAP girişini tek hamlede açar ya da kapatır |
| Host + Port ya da URL | dc01.example.corp ve 389, ya da ldaps://dc01.example.corp:636 |
| SSL kullan (ldaps) | baştan TLS (port 636) |
| StartTLS | 389'daki düz bağlantıyı TLS'e yükseltir |
| TLS sertifika doğrulamasını atla | yalnızca test için |
| CA sertifikası (PEM) | dizinin sertifikası genel bir CA'dan değilse kendi CA'nız (aşağıdaki nota bakın) |
| Zaman aşımı | LDAP işlemi başına saniye (varsayılan 10) |
| Bind DN / Bind parolası | dizinde arama yapan servis hesabı, örn. CN=svc-openconsole,OU=ServiceAccounts,DC=example,DC=corp. Parola şifrelenerek saklanır; Bind parolasını güncelle'yi yalnızca parolayı değiştirirken işaretleyin |
| Kullanıcı Base DN (tek) | kişilerin arandığı yer, örn. OU=Users,DC=example,DC=corp |
| Kullanıcı base DN'leri (her satıra bir tane) | aranacak başka yerler, her satıra bir tam DN, örn. iki satırda OU=Users,DC=example,DC=corp ve OU=Contractors,DC=example,DC=corp. 2.23.0'a kadar bu alan virgüllerden bölünüyordu; o zaman kaydedilmiş değer tek bir DN olarak okunur, yükseltmeden sonra alanı kontrol edin |
| Kullanıcı filtresi | %s, kişinin yazdığı değerdir. Active Directory (sAMAccountName=%s), OpenLDAP (uid=%s) |
| Kullanıcı adı attribute'u | OpenConsole kullanıcı adı olacak attribute: sAMAccountName ya da uid |
Örnek bir Active Directory kurulumu (uydurma değerler):
| Alan | Değer |
|---|---|
| Host + Port | 10.10.20.15 ve 389 |
| Bind DN | CN=svc-openconsole,OU=ServiceAccounts,OU=IT,DC=example,DC=corp |
| Kullanıcı Base DN | OU=Engineering,OU=Users,DC=example,DC=corp |
| Kullanıcı filtresi | (sAMAccountName=%s) |
| Kullanıcı adı attribute'u | sAMAccountName |
Önce LDAP ayarlarını kaydet, sonra Bağlantıyı test et: servis hesabıyla bind olur ve her base DN'de arama yapar. Kaydetme başarısız olursa ekran nedenini söyler (örneğin PEM olmayan bir CA sertifikası).
SSL kullan (ldaps) ya da StartTLS ile dizinin sertifikası doğrulanır: Host / URL'deki host adı (ya da IP
adresi) için geçerli olmalı ve OpenConsole'un güvendiği bir CA tarafından imzalanmış olmalıdır: imajdaki genel CA'lar
ya da CA sertifikası (PEM) alanındaki. Kendi CA'nızı oraya yapıştırın (-----BEGIN CERTIFICATE----- …; birden
çok sertifika arka arkaya olabilir). Sertifika içermeyen bir metin kaydederken reddedilir. 2.23.0'a kadar StartTLS
yalnızca TLS sertifika doğrulamasını atla işaretliyken bağlanıyordu ve CA alanı yoktu.
2. Kişileri içe aktarın (ya da ilk girişte oluşturun)
İçe aktarma: Yönetim → Kullanıcılar → Yeni kullanıcı → LDAP'tan içe aktar… (ya da Yönetim → LDAP'ta ayarların
altından). Adın bir kısmını yazıp arayın: kullanıcı filtresi, %s yerine yazdığınız değer konarak çalışır; base DN
başına en fazla 100 sonuç gelir. Önek araması için filtreye (sAMAccountName=%s*) yazın. Kişileri ve katılacakları
grupları seçip içe aktarın. Zaten var olan hesaplar ayrı listelenir ve atlanır. Her içe aktarma audit'e yazılır
(user.import).
İlk girişte (varsayılan olarak kapalı): Kullanıcının ilk girişinde hesabını oluştur seçeneğini işaretleyin, Yeni hesapları şu gruplara ekle alanında grupları seçin ve kaydedin. Bundan sonra:
- kullanıcı filtresinin bulduğu ve geçerli bir dizin parolasıyla giriş yapan herkes anında, bu gruplarda ve dizindeki
adıyla bir hesap alır (
Johnyazan kişijohnolarak girer); - hesabı olmayan ve parolası yanlış olan kişi reddedilir; hiçbir şey oluşturulmaz;
- yeni hesaplar asla yönetici olmaz (
auto_provisioned: trueileuser.create); - birini dışarıda bırakmak için hesabını devre dışı bırakın: silinen hesap, kişinin bir sonraki girişinde yeniden oluşturulur.
3. Kimlerin giriş yapabileceğini sınırlayın
Koşulu kullanıcı filtresine yazın. Örneğin yalnızca bir dizin grubunun üyeleri:
(&(sAMAccountName=%s)(memberOf=CN=OpenConsole Users,OU=Groups,DC=example,DC=corp))
Dizin grupları OpenConsole gruplarıyla eşleştirilmez. OpenConsole grup üyeliğini içe aktarma, ilk giriş grupları ya da bir yönetici belirler.
Giriş
Kişiler normal giriş formuna dizin kullanıcı adlarını ve parolalarını yazar. OpenConsole kullanıcı filtresiyle DN'lerini
bulur ve onların kimliğiyle bind olur; yani parolayı her seferinde dizin kontrol eder. Dizinde devre dışı ya da süresi
dolmuş bir hesap giriş yapamaz. Joker karakterli filtre güvenlidir: girişte OpenConsole ayrıca kullanıcı adı
attribute'unda birebir eşleşme arar, yani jo asla john olarak giriş yapamaz. Etkin kapatıldığında tüm LDAP
girişleri anında durur.
Dizinle yalnızca kaynağı LDAP olan bir hesap (içe aktarılmış ya da ilk girişte oluşturulmuş) giriş yapar. Local
bir hesap, dizinde aynı adla biri olsa bile asla dizinle giriş yapmaz; yani bir dizin kaydı local bir hesabı (yerleşik
admin dahil) ele geçiremez. 2.23.0'a kadar parolası tutmayan local hesap dizine düşüyor ve LDAP'a çevriliyordu. 2.13'ten
önce içe aktarılmış ve Yönetim → Kullanıcılar'da hâlâ kaynağı Local görünen kişileri silip yeniden içe aktarmanız
gerekir.
Çalışmadığında
| Belirti | Genellikle |
|---|---|
| Test: connection refused / timeout | host ya da port yanlış, ya da OpenConsole pod'u ile dizin arasında bir firewall var |
Test: x509: certificate signed by unknown authority | sertifika kendi CA'nızdan: onu CA sertifikası (PEM) alanına yapıştırın |
Test: x509: certificate is valid for …, not … | Host / URL sertifikadaki bir ad değil: sertifikanın verildiği adı kullanın |
Test: Invalid Credentials (49) | bind DN ya da bind parolası yanlış (AD'de bind DN tam CN=… ya da user@domain biçimindedir) |
| Test çalışıyor ama bir kişi giriş yapamıyor | kullanıcı filtresi kişiyi base DN'lerin altında bulamıyor ya da kullanıcı adı attribute'u kişinin yazdığından farklı; ya da (ilk giriş seçeneği kapalıyken) kişi hiç içe aktarılmamış |
| Giriş yaptı ama hiçbir şey görmüyor | rolü olan hiçbir OpenConsole grubunda değil |
Denetim Logları'ndaki başarısız user.login olayında nedeni yazar (login_method: ldap); pod logundaki
ldap sign-in failed satırında dizinin mesajı vardır (Giriş yapılamıyor).