Ana içeriğe geç

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):

Yönetim → LDAP: host dc01.example.corp, port 389, bind DN, kullanıcı base DN, kullanıcı filtresi (sAMAccountName=%s), kullanıcı adı attribute'u, ilk giriş seçeneği, LDAP ayarlarını kaydet ve Bağlantıyı test et, altta içe aktarma aramasıYönetim → LDAP: host dc01.example.corp, port 389, bind DN, kullanıcı base DN, kullanıcı filtresi (sAMAccountName=%s), kullanıcı adı attribute'u, ilk giriş seçeneği, LDAP ayarlarını kaydet ve Bağlantıyı test et, altta içe aktarma araması
AlanAnlamı
EtkinLDAP girişini tek hamlede açar ya da kapatır
Host + Port ya da URLdc01.example.corp ve 389, ya da ldaps://dc01.example.corp:636
SSL kullan (ldaps)baştan TLS (port 636)
StartTLS389'daki düz bağlantıyı TLS'e yükseltir
TLS sertifika doğrulamasını atlayalnı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'uOpenConsole kullanıcı adı olacak attribute: sAMAccountName ya da uid

Örnek bir Active Directory kurulumu (uydurma değerler):

AlanDeğer
Host + Port10.10.20.15 ve 389
Bind DNCN=svc-openconsole,OU=ServiceAccounts,OU=IT,DC=example,DC=corp
Kullanıcı Base DNOU=Engineering,OU=Users,DC=example,DC=corp
Kullanıcı filtresi(sAMAccountName=%s)
Kullanıcı adı attribute'usAMAccountName

Ö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ı).

TLS

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 (John yazan kişi john olarak girer);
  • hesabı olmayan ve parolası yanlış olan kişi reddedilir; hiçbir şey oluşturulmaz;
  • yeni hesaplar asla yönetici olmaz (auto_provisioned: true ile user.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​

BelirtiGenellikle
Test: connection refused / timeouthost ya da port yanlış, ya da OpenConsole pod'u ile dizin arasında bir firewall var
Test: x509: certificate signed by unknown authoritysertifika 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ıyorkullanı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üyorrolü 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).