LDIF Import & Export¶
LDIF (LDAP Data Interchange Format) ist das Standardformat für den Datenaustausch mit LDAP-Verzeichnissen.
LDIF-Format verstehen¶
Grundstruktur¶
# Kommentar
dn: cn=Max Mustermann,ou=Benutzer,dc=example,dc=com
objectClass: top
objectClass: person
objectClass: inetOrgPerson
cn: Max Mustermann
sn: Mustermann
mail: max@example.com
Wichtige Elemente¶
| Element | Beschreibung |
|---|---|
dn: | Distinguished Name (Pflicht) |
objectClass: | Objektklassen (Pflicht) |
attribut: wert | Attribut mit Wert |
attribut:: base64 | Base64-kodierter Wert |
| Leerzeile | Trennt Einträge |
Export¶
Einzelnen Eintrag exportieren¶
- Rechtsklick auf den Eintrag
- Wählen Sie Als LDIF exportieren
- Wählen Sie den Speicherort
- Klicken Sie auf Speichern
Teilbaum exportieren¶
- Rechtsklick auf den Container
- Wählen Sie Teilbaum als LDIF exportieren
- Konfigurieren Sie die Optionen
- Klicken Sie auf Exportieren
Exportoptionen¶
| Option | Beschreibung |
|---|---|
| Untereinträge einschließen | Rekursiver Export |
| Betriebsattribute | z.B. createTimestamp |
| Binärdaten | Als Base64 einbetten |
| Passwörter | Mit/ohne Passwörter |
Suchergebnisse exportieren¶
- Führen Sie eine Suche durch
- Klicken Sie auf Ergebnisse exportieren
- Wählen Sie LDIF-Format
- Speichern Sie die Datei
Import¶
LDIF-Datei importieren¶
- Datei → LDIF importieren
- Oder:
Strg+I - Wählen Sie die LDIF-Datei
- Prüfen Sie die Vorschau
- Klicken Sie auf Importieren
Importmodi¶
| Modus | Beschreibung |
|---|---|
| Hinzufügen | Neue Einträge erstellen |
| Ersetzen | Bestehende überschreiben |
| Modifizieren | Änderungen anwenden |
| Löschen | Einträge entfernen |
Vorschau und Validierung¶
Vor dem Import zeigt LDAP Explorer:
- Anzahl der Einträge
- Erkannte Operationen
- Potenzielle Konflikte
- Schema-Fehler
Testlauf
Aktivieren Sie Testlauf, um Änderungen zu simulieren ohne sie anzuwenden.
LDIF-Modifikationen¶
Änderungsformat¶
dn: cn=Max Mustermann,ou=Benutzer,dc=example,dc=com
changetype: modify
replace: mail
mail: neuemail@example.com
-
add: telephoneNumber
telephoneNumber: +49 123 456
-
delete: description
Operationen¶
| Changetype | Beschreibung |
|---|---|
add | Neuen Eintrag hinzufügen |
delete | Eintrag löschen |
modify | Attribute ändern |
modrdn | DN umbenennen |
Modifikationstypen¶
| Operation | Beschreibung |
|---|---|
add: | Attributwert hinzufügen |
delete: | Attributwert entfernen |
replace: | Attributwert ersetzen |
Binärdaten¶
Base64-Kodierung¶
Binärdaten werden Base64-kodiert mit :::
Externe Dateien¶
Alternativ können Dateien referenziert werden:
Sonderzeichen¶
Umlaute und Unicode¶
UTF-8 wird unterstützt, aber bei Sonderzeichen am Zeilenanfang Base64 nutzen:
# Direkt (wenn nicht am Zeilenanfang)
description: Büroraum in Köln
# Base64 für spezielle Fälle
description:: QsO8cm9yYXVtIGluIEvDtmxu
Zeilenumbruch¶
Lange Zeilen mit Leerzeichen am Zeilenanfang fortsetzen:
Beispiele¶
Benutzer erstellen¶
dn: cn=Anna Schmidt,ou=Benutzer,dc=example,dc=com
objectClass: top
objectClass: person
objectClass: organizationalPerson
objectClass: inetOrgPerson
cn: Anna Schmidt
sn: Schmidt
givenName: Anna
mail: anna.schmidt@example.com
userPassword: {SSHA}geheimer-hash
Gruppe erstellen¶
dn: cn=Entwickler,ou=Gruppen,dc=example,dc=com
objectClass: top
objectClass: groupOfNames
cn: Entwickler
member: cn=Max Mustermann,ou=Benutzer,dc=example,dc=com
member: cn=Anna Schmidt,ou=Benutzer,dc=example,dc=com
Benutzer modifizieren¶
dn: cn=Max Mustermann,ou=Benutzer,dc=example,dc=com
changetype: modify
replace: telephoneNumber
telephoneNumber: +49 999 123456
-
add: mobile
mobile: +49 170 1234567
Eintrag löschen¶
Fehlerbehandlung¶
Häufige Fehler¶
| Fehler | Ursache | Lösung |
|---|---|---|
| Object class violation | Fehlendes Pflichtattribut | Attribut hinzufügen |
| Invalid DN syntax | Fehlerhafter DN | DN korrigieren |
| Already exists | Eintrag existiert bereits | Löschen oder Modus ändern |
| No such object | Übergeordneter Eintrag fehlt | Reihenfolge prüfen |
Import-Protokoll¶
Nach dem Import zeigt LDAP Explorer:
- ✅ Erfolgreich importierte Einträge
- ❌ Fehlgeschlagene Einträge mit Fehlerdetails
- 📊 Zusammenfassung
Fehler beheben¶
- Exportieren Sie das Protokoll
- Korrigieren Sie die LDIF-Datei
- Importieren Sie nur die fehlerhaften Einträge erneut
Best Practices¶
Backup erstellen¶
Vor größeren Importen:
Reihenfolge beachten¶
Einträge müssen in der richtigen Reihenfolge sein:
- Übergeordnete Container zuerst
- Dann untergeordnete Einträge
Testumgebung nutzen¶
- Testen Sie LDIF-Dateien zuerst in einer Testumgebung
- Aktivieren Sie den Testlauf
- Prüfen Sie das Protokoll
Automatisierung¶
Kommandozeilenimport¶
Geplante Importe¶
Für regelmäßige Importe siehe Server-Tools.