Tag 6: OpenLDAP
Ziel: Ein eigenes OpenLDAP-Image bauen, das Verzeichnis
dc=notes,dc=labmit Benutzern und Gruppen füllen und verstehen, wie Bind, Suche und Zugriffsrechte funktionieren. · Dauer: ca. 60 min · Voraussetzung: Tag 5
Briefing
- Ein LDAP-Verzeichnis ist ein Baum. Jeder Eintrag
hat einen eindeutigen Namen, den DN
(
uid=carla,ou=people,dc=notes,dc=lab), und Attribute nach Objektklassen. - Bind heißt anmelden: mit DN und Passwort. Danach
sucht man ab einem Ausgangspunkt (Base) mit einem
Filter (
(uid=carla)). - Gruppen sind Einträge
groupOfNamesmitmember-Attributen. Das Overlay memberOf trägt die Gruppen zusätzlich am Benutzer ein. - Keycloak meldet sich als eigener Bind-Benutzer
cn=keycloak,ou=systeman, nie als Admin.
dc=notes,dc=lab
├── ou=people uid=carla, uid=dirk, uid=emil
├── ou=groups cn=notes-schreiber (carla), cn=notes-leser (dirk, emil)
└── ou=system cn=keycloak (Bind-Benutzer)
Drill 1: Das Image
Gepflegte Images für OpenLDAP sind rar geworden. Das Labor baut eins
aus dem Paket slapd von Debian 13:
source ~/kc-lab/setup/env.sh
mkdir -p ~/kc-lab/tag06
cp -R ~/kc-lab/code/ldap ~/kc-lab/ldap && cd ~/kc-lab/ldap
grep -E '^FROM|slapd ldap-utils' Dockerfile
grep -E 'slapadd|exec slapd' entrypoint.sh
docker compose build -q
docker compose up -d
sleep 5
docker compose logs ldap 2>&1 | grep -E 'Erster Start|slapd starting|OpenLDAP' \
| cut -c1-80Erwartet (gekürzt):
FROM debian:13.7-slim
slapd ldap-utils \
slapadd -n 0 -F /etc/ldap/slapd.d -l /tmp/config.ldif
slapadd -n 1 -F /etc/ldap/slapd.d -l /tmp/base.ldif
exec slapd -d "${LDAP_LOG_LEVEL:-256}" -h "ldap:/// ldapi:///" \
Image lab/openldap:2.6.10 Built
Container ldap-ldap-1 Started
ldap-1 | Erster Start: lege dc=notes,dc=lab an
ldap-1 | 6ae7b47a.023c8451 0x71b7e9f9f140 @(#) $OpenLDAP: slapd 2.6.10+dfsg-1 (May 29 2
ldap-1 | Debian OpenLDAP Maintainers <[email protected]>
ldap-1 | 6ae7b47a.03fec1d2 0x71b7e9f9f140 slapd starting
Beim ersten Start schreibt entrypoint.sh die
Konfiguration (cn=config, Datenbank 0) und das Grundgerüst
(Datenbank 1) direkt mit slapadd. Die Passwörter aus
compose.yaml landen dabei nur als Hash im Verzeichnis.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Der Baum
L="-x -H ldap://localhost -D cn=admin,dc=notes,dc=lab -w lab-ldap-pw-123"
ldapsearch $L -b dc=notes,dc=lab -LLL dn
ldapsearch -x -H ldap://localhost -b dc=notes,dc=lab -LLL dnErwartet:
dn: dc=notes,dc=lab
dn: ou=people,dc=notes,dc=lab
dn: ou=groups,dc=notes,dc=lab
dn: ou=system,dc=notes,dc=lab
dn: cn=keycloak,ou=system,dc=notes,dc=lab
No such object (32)
-x ist ein einfacher Bind mit Passwort,
-LLL lässt Kommentare weg. Der Admin sieht alles. Ohne Bind
(anonym) sieht man nichts, nicht einmal, ob es den Baum gibt.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Benutzer anlegen
cd ~/kc-lab/code/ldap/seed
grep -v '^#' benutzer.ldif | sed -n '1,8p'
ldapadd $L -f benutzer.ldif
for u in carla dirk emil; do
ldappasswd $L -s lab-user-pw-123 uid=$u,ou=people,dc=notes,dc=lab && echo "$u ok"
doneErwartet:
dn: uid=carla,ou=people,dc=notes,dc=lab
objectClass: inetOrgPerson
uid: carla
cn: Carla Verzeichnis
givenName: Carla
sn: Verzeichnis
mail: [email protected]
departmentNumber: Vertrieb
adding new entry "uid=carla,ou=people,dc=notes,dc=lab"
adding new entry "uid=dirk,ou=people,dc=notes,dc=lab"
adding new entry "uid=emil,ou=people,dc=notes,dc=lab"
carla ok
dirk ok
emil ok
Die LDIF-Datei enthält kein Passwort. ldappasswd setzt
es über die Erweiterung „Password Modify”, und der Server speichert es
als Hash.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Gruppen und memberOf
ldapadd $L -f gruppen.ldif
ldapsearch $L -b ou=groups,dc=notes,dc=lab -LLL '(objectClass=groupOfNames)' cn member
ldapsearch $L -b ou=people,dc=notes,dc=lab -LLL '(uid=carla)' uid departmentNumber \
memberOfErwartet:
adding new entry "cn=notes-schreiber,ou=groups,dc=notes,dc=lab"
adding new entry "cn=notes-leser,ou=groups,dc=notes,dc=lab"
dn: cn=notes-schreiber,ou=groups,dc=notes,dc=lab
cn: notes-schreiber
member: uid=carla,ou=people,dc=notes,dc=lab
dn: cn=notes-leser,ou=groups,dc=notes,dc=lab
cn: notes-leser
member: uid=dirk,ou=people,dc=notes,dc=lab
member: uid=emil,ou=people,dc=notes,dc=lab
dn: uid=carla,ou=people,dc=notes,dc=lab
uid: carla
departmentNumber: Vertrieb
memberOf: cn=notes-schreiber,ou=groups,dc=notes,dc=lab
memberOf hast du nie geschrieben. Das Overlay pflegt es,
sobald ein Benutzer in einer Gruppe als member steht.
Keycloak kann Gruppen über beide Richtungen lesen (Tag 8).
Fortschritt speichern? Kostenlos registrieren
Drill 5: Anmelden und Rechte
ldapwhoami -x -H ldap://localhost -D uid=carla,ou=people,dc=notes,dc=lab \
-w lab-user-pw-123
ldapwhoami -x -H ldap://localhost -D uid=carla,ou=people,dc=notes,dc=lab -w falsch
ldapsearch $L -b ou=people,dc=notes,dc=lab -LLL '(uid=carla)' userPassword \
| grep userPassword | cut -d' ' -f2 | base64 -d | cut -c1-6; echo
ldapsearch -x -H ldap://localhost -D uid=carla,ou=people,dc=notes,dc=lab \
-w lab-user-pw-123 -b ou=people,dc=notes,dc=lab -LLL '(uid=dirk)' uid userPasswordErwartet:
dn:uid=carla,ou=people,dc=notes,dc=lab
ldap_bind: Invalid credentials (49)
{SSHA}
dn: uid=dirk,ou=people,dc=notes,dc=lab
uid: dirk
carla kann sich anmelden und andere Benutzer lesen, aber nicht deren
Passwort-Hash. Die Regeln (olcAccess) stehen in der
Konfiguration:
docker compose -f ~/kc-lab/ldap/compose.yaml exec ldap ldapsearch -Q -Y EXTERNAL \
-H ldapi:/// -b cn=config -LLL '(olcDatabase={1}mdb)' olcAccessErwartet:
dn: olcDatabase={1}mdb,cn=config
olcAccess: {0}to attrs=userPassword by dn.exact=cn=keycloak,ou=system,dc=notes
,dc=lab write by self write by anonymous auth by * none
olcAccess: {1}to * by dn.exact=cn=keycloak,ou=system,dc=notes,dc=lab write by
users read by * none
Passwörter: Keycloak darf schreiben (für Tag 7), jeder sein eigenes,
anonym nur zum Anmelden prüfen. Alles andere: Keycloak schreibt,
angemeldete Benutzer lesen. -Y EXTERNAL über
ldapi:/// ist der Zugang als root im Container, ohne
Passwort.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
ldapsearch $L -b ou=people,dc=notes,dc=lab -LLL '(objectClass=inetOrgPerson)' uid \
| grep '^uid'Erwartet: drei Benutzer.
uid: carla
uid: dirk
uid: emil
ldapwhoami -x -H ldap://localhost -D cn=keycloak,ou=system,dc=notes,dc=lab \
-w lab-bind-pw-123Erwartet: Der Bind-Benutzer für Keycloak funktioniert.
dn:cn=keycloak,ou=system,dc=notes,dc=lab
ldapsearch -x -H ldap://localhost -D cn=keycloak,ou=system,dc=notes,dc=lab \
-w lab-bind-pw-123 -b dc=notes,dc=lab -LLL \
'(memberOf=cn=notes-leser,ou=groups,dc=notes,dc=lab)' uid | grep '^uid'Erwartet: Mitglieder einer Gruppe über memberOf.
uid: dirk
uid: emil
Challenge
Leg die Benutzerin frida (Abteilung Vertrieb) an, gib
ihr ein Passwort und nimm sie in die Gruppe notes-schreiber
auf, ohne die Gruppe zu löschen und neu anzulegen.
Hinweis: Für die Gruppe brauchst du
ldapmodify mit changetype: modify und
add: member.
Lösung
cd ~/kc-lab/tag06
cat > frida.ldif <<'EOF'
dn: uid=frida,ou=people,dc=notes,dc=lab
objectClass: inetOrgPerson
uid: frida
cn: Frida Verzeichnis
givenName: Frida
sn: Verzeichnis
mail: [email protected]
departmentNumber: Vertrieb
dn: cn=notes-schreiber,ou=groups,dc=notes,dc=lab
changetype: modify
add: member
member: uid=frida,ou=people,dc=notes,dc=lab
EOF
ldapmodify -a $L -f frida.ldif
ldappasswd $L -s lab-user-pw-123 uid=frida,ou=people,dc=notes,dc=lab
ldapsearch $L -b ou=people,dc=notes,dc=lab -LLL '(uid=frida)' memberOfErwartet:
adding new entry "uid=frida,ou=people,dc=notes,dc=lab"
modifying entry "cn=notes-schreiber,ou=groups,dc=notes,dc=lab"
dn: uid=frida,ou=people,dc=notes,dc=lab
memberOf: cn=notes-schreiber,ou=groups,dc=notes,dc=lab
ldapmodify -a legt Einträge ohne changetype
als neu an und wendet die anderen als Änderung an. Eine Datei, zwei
Arten von Änderung.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- LDAPS oder StartTLS: Passwörter gehen beim Bind im Klartext über die Leitung. In Produktion spricht man LDAP nur verschlüsselt (Port 636 oder StartTLS auf 389).
- Bind-Benutzer mit wenig Rechten: Keycloak bekommt nur, was es braucht; Schreibrechte nur, wenn Keycloak Passwörter oder Attribute zurückschreiben soll (Tag 7).
- Hochverfügbarkeit: OpenLDAP repliziert mit syncrepl (auch Multi-Provider). Keycloak kann mehrere LDAP-URLs nacheinander versuchen.
- Active Directory ist auch ein LDAP-Verzeichnis, mit eigenen Attributen und Eigenheiten (Tag 9).