imported>Poodles67: /* growthexperiments-addlink-summary-summary:1|0|0 */

2026-03-15T20:29:50Z

growthexperiments-addlink-summary-summary:1|0|0

Neue Seite

'''LDIF''' (Abkürzung aus dem Englischen für '''''L'''DAP '''D'''ata '''I'''nterchange '''F'''ormat'') ist ein [[American Standard Code for Information Interchange|ASCII]]-basierendes Dateiformat zur Darstellung von Informationen aus einem [[Lightweight Directory Access Protocol|LDAP]]-[[Verzeichnisdienst|Verzeichnis]].

LDAP beschreibt lediglich ein Kommunikationsprotokoll von Verzeichnisdiensten, die interne Darstellung der Daten in einem Verzeichnis ist nicht spezifiziert und somit bei konkreten Implementierungen verschiedener Hersteller unterschiedlich. Um dennoch einen einfachen Austausch von Daten auch zwischen heterogenen Verzeichnissen zu ermöglichen, wurde LDIF als [[Austauschformat]] spezifiziert.

Wie auch bei LDAP wurde bei der Entwicklung von LDIF darauf geachtet, das Format möglichst einfach zu gestalten. Durch die Beschränkung auf eine rein textuelle Darstellung bleibt das Format [[Menschenlesbarkeit|menschenlesbar]] und kann somit einfach interpretiert werden.
Die Dateiinhalte sind dabei in ASCII kodiert. Sobald Sonderzeichen – wie Umlaute – enthalten sind, müssen die Daten [[base64]]-kodiert abgelegt werden (manche Tools und Serverimplementierungen unterstützen auch unkodierte Werte). Die Attributsnamen sind dabei mit einem Doppelpunkt gekennzeichnet (<code>attribut:: base64-Wert</code>).

Ein LDAP-Objekt wird durch mehrere LDIF-Zeilen beschrieben. Am Anfang steht immer der ''distinguished name'' dn, der die absolute Position im LDAP-Baum angibt. Es folgen ein oder mehrere Objektklassen, die definieren, welche Attribute zulässig oder vorgeschrieben sind. Dann folgen die Attribut/Wert-Paare, die den eigentlichen Inhalt darstellen. Multi-Value-Attribute werden mehrfach angegeben, dabei erfolgt ein Wert pro Zeile. Die Objekt-Definition wird durch eine Leerzeile abgeschlossen.
Eine Zeile, die mit einem Hash-Zeichen (#) beginnt, stellt einen Kommentar dar und wird durch Tools ignoriert.
Lange Zeilen können umbrochen werden, indem ein Zeilenumbruch gefolgt von einem Leerzeichen angegeben wird.

== LDIF-Formate ==
Es gibt zwei grundlegende LDIF-Formate, die innerhalb einer Datei nicht gemischt werden dürfen:
* LDIF Content: Beschreibt Einträge als solche mit Attributen
* LDIF Change: Beschreibt Änderungen an Einträgen und deren Attributen. Pro Eintrag können mehrere verschiedene Anweisungen angegeben werden.

== Beispiele ==

Beispiel: LDIF-Content-Datei firmenstruktur.ldif mit fünf [[Lightweight Directory Access Protocol|LDAP]]-Objekten:
<syntaxhighlight lang="text">
dn: dc=structure-net, dc=de
objectclass: organization
objectclass: top
o: Structure Net
l: Hamburg
postalcode: 21033
streetaddress: Billwiese 22

dn: ou=Sales, dc=structure-net, dc=de
objectclass: organizationalunit
ou: Sales
description: Verkauf
telephonenumber: 040-7654321
facsimiletelephonenumber: 040-7654321

dn: ou=Development, dc=structure-net, dc=de
objectclass: organizationalunit
ou: Development
description: Entwicklung
telephonenumber: 040-7654321
facsimiletelephonenumber: 040-7654321

dn: ou=Support, dc=structure-net, dc=de
objectclass: organizationalunit
ou: Support
description: Support
telephonenumber: 040-7654321
facsimiletelephonenumber: 040-7654321

dn: uid=admin, dc=structure-net, dc=de
objectclass: person
objectclass: organizationalperson
objectclass: inetorgperson
cn: admin
cn: Systemverwalter
cn: Thomas Bendler
sn: Bendler
uid: admin
mail: tbendler@structure-net.de
l: Hamburg
postalcode: 21033
streetaddress: billwiese 22
telephonenumber: 040-7654321
facsimiletelephonenumber: 040-7654321
</syntaxhighlight>

<small>aus: Thomas Bendler: ''Linux LDAP-HOWTO''.</small>

Beispiel: LDIF-Content-Datei mit Zeilenumbruch:
<syntaxhighlight lang="text">
dn: ou=VeryLong,o=TestOrg,dc=de
objectclass: organizationalunit
ou: veryLong
l:: w5xiZXJsaW5nZW4=
description: Dies ist eine sehr lange Beschreibung. Sie ist so lang, dass sie hier->
<- umbrochen wird.
Das laesst sich beliebig oft wiederholen. Dabei ist egal,
ob nur die Daten getrennt werden oder auch Attributsnamen.
Trennen ist ueberall im LDIF-Text moeglich.
attr
ibut: Beispiel fuer ein umbrochenes Attribut.
</syntaxhighlight>

Beispiel: LDIF-Change-Datei mit Kommentar:

<syntaxhighlight lang="text">
# Vorhandene Beispielabteilung modifizieren: Beschreibung (attribut description) hinzufügen
dn: ou=Example,o=TestOrg,dc=de
changeType: modify
add: description
description: Dies ist der Beschreibungstext

# Eintrag mit mehreren Changeanweisungen
# 1. Beschreibung hinzufügen
# 2. Postleitzahl ersetzen
# 3. Telefonnummer durch mehrere neue ersetzen
# 4. Straße löschen
# 5. bestimmte Faxnummer löschen (andere Faxnummern bleiben bestehen)
dn: ou=AmpleEx,o=TestOrg,dc=de
changeType: modify
add: description
description: Test1234
-
replace: postalCode
postalCode: 12345
-
replace: telephoneNumber
telephoneNumber: 01234 56789
telephoneNumber: 98765 4321-0
-
delete: street
-
delete: facsimileTelephoneNumber
facsimileTelephoneNumber: deleteJustThisValue
</syntaxhighlight>

<syntaxhighlight lang="text">
# Neuen LDAP-Eintrag anlegen
dn: cn=FooBar,ou=Example,o=TestOrg,dc=de
changeType: add
objectClass: person
objectClass: organizationalPerson
objectClass: inetOrgPerson
cn: FooBar
sn: Bar
givenName: Foo
mail: foobar@testorg.de
telephonenumber: 1234 567890
</syntaxhighlight>

Adaptiert aus <nowiki>RFC 2849</nowiki><ref>{{RFC-Internet |Autor=G. Good |RFC=2849 |Titel=The LDAP Data Interchange Format (LDIF) – Technical Specification |Datum=2000-06}}</ref> (dort gibt es noch viele weitere gute Beispiele):
<syntaxhighlight lang="text">
# Eintrag umbenennen (alter Name wird entfernt)
# (Wird "deleteoldrdn: 1" auf 0 gesetzt (oder komplett weggelassen), bleibt der alte Name als Alias erhalten.)
dn: cn=FooBar,ou=Example,o=TestOrg,dc=de
changetype: modrdn
newrdn: cn=BarFoo
deleteoldrdn: 1

# Eintrag (und alle Kindelemente) im Baum umziehen (nur LDAPv3 Server)
dn: cn=FooBar,ou=Example,o=TestOrg,dc=de
changetype: modrdn
newrdn: ou=BarFoo
newsuperior: ou=elpmaxE,o=TestOrg,dc=de
</syntaxhighlight>

== Siehe auch ==
* [[vCard]]

== Weblinks ==
* {{RFC-Internet |Autor=G. Good |RFC=2849 |Titel=The LDAP Data Interchange Format (LDIF) – Technical Specification |Datum=2000-06}}
* Thomas Bendler: [http://www.linuxhaven.de/dlhp/HOWTO/DE-LDAP-HOWTO.html Linux LDAP Howto.] linuxhaven.de

== Einzelnachweise ==
<references />

[[Kategorie:Datenformat]]

LDAP Data Interchange Format - Versionsgeschichte

imported>Poodles67: /* growthexperiments-addlink-summary-summary:1|0|0 */