Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 6: OpenLDAP

Ziel: Ein eigenes OpenLDAP-Image bauen, das Verzeichnis dc=notes,dc=lab mit 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 groupOfNames mit member-Attributen. Das Overlay memberOf trägt die Gruppen zusätzlich am Benutzer ein.
  • Keycloak meldet sich als eigener Bind-Benutzer cn=keycloak,ou=system an, 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-80

Erwartet (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 dn

Erwartet:

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"
done

Erwartet:

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 \
  memberOf

Erwartet:

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 userPassword

Erwartet:

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)' olcAccess

Erwartet:

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-123

Erwartet: 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)' memberOf

Erwartet:

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