====== Adressen LDAP ======
[[wpde>LDAP|LDAP]] ist ein standardisiertes Protokoll zum Zugriff auf (u.a.) Adressdaten. 

Dieser Zugriff kann  über Programme wie MS Outlook, Apple Adressbuch, Lightning für Mozilla Thunderbird als auch über Smartphones erfolgen.

Sollten Sie auf die in untermStrich gespeicherten Adressdaten von einem anderen System aus zugreifen wollen, fragen Sie den Anbieter des Programms ob es LDAP für den Zugriff auf Adressdaten unterstützt.

===== Getestete Server =====
Die folgenden Server wurden mit untermStrich getestet:
  * [[http://www.openldap.org/|OpenLDAP (Informationen vom Hersteller und Source Code)]]
    * [[:#installationsbeispiel_und_konfiguration_der_server|Für Windows siehe Installationsbeispiel]]
  * [[http://directory.apache.org/|Apache Directory]]

<wrap center round important>
Diese müssen getrennt von untermStrich installiert und konfiguriert werden. Diese Serverprogramme stehen nicht unter der Kontrolle der untermStrich Software GmbH. Die untermStrich Software GmbH kann daher auch __keine Gewähr__ und __keinen Support__ dazu anbieten.
</wrap>

===== Installationsbeispiel und Konfiguration der Server =====

Diese Anleitung beschreibt die grundlegende Installation des [[http://directory.apache.org/|Apache Directory]] bzw [[http://www.openldap.org/|OpenLDAP]] und Konfiguration für untermStrich.

Weitere Details zur Nutzung finden Sie im [[http://directory.apache.org/apacheds/basic-user-guide.html|ApacheDS User Guide]] als auch in der Anleitung zu Ihrer Software, Ihrer Telefonanlage bzw. ihrem Drucker die/den Sie mit LDAP nutzen möchten.

  * :html: [[https://www.maxcrc.de/openldap-for-windows/|OpenLDAP für Windows]]
    * Alle Fragen können mit "Weiter" beantwortet werden, außer den Datenbanktyp.
    * Den Datenbanktyp setzen Sie bitte auf **BDB**.
    * Der Server hat dann die folgenden Daten:
      * DN: ''dc=maxcrc,dc=com''
      * Root-Benutzer nach der Installation:
        * Login (Bind) DN: ''cn=Manager,dc=maxcrc,dc=com''
        * Passwort: ''secret''
  * Ubuntu
    * :html: [[https://ubuntu.com/server/docs/service-ldap|OpenLDAP Server - Manual by Ubuntu]]
    * [[de:setup:setup:sideboard:system:ldap_ubuntu|Ubuntu 16.04 Anleitung]]

===== Abgleich (untermStrich -> Server) =====
Um alle Adressen aus untermStrich X mit dem LDAP Server abzugleichen, müssen Sie LDAP in Konfigura­tion - Adressen LDAP konfigurieren. Wenn Sie erweiterte Schemas nutzen möchten, siehe [[#schemas|Schemas]].

Danach können Sie 
  * Unter Windows: ''C:\Apache24\htdocs\ldap.bat'' starten.
  * Unter Linux/Mac: auf der Kommandozeile / in der Konsole / im Terminal im ''ustrich'' Verzeichnis ((Dieses finden Sie unter "Basepath" im Modul "System". Lassen Sie dabei das /system/ am Ende weg.))<code bash>
php ldap.php
</code> aufrufen ((Unter Windows müssen Sie meist den vollen Pfad zur ''C:\Apache24\php\php.exe'' o.ä. angeben.)).


Wenn Sie "Push" aktiviert haben, wird jede Adressänderung sofort an den LDAP Server gesendet.

==== Schemas ====
=== mozillaorgperson.schema ===
Optional, wenn Sie mozillaOrgPerson nutzen möchten:

Ubuntu: ''/etc/ldap/schema/mozillaorgperson.schema''

{{:de:setup:setup:sideboard:system:mozillaorgperson.schema.zip|}}

=== Zarafa ===
Wenn Sie Zarafa einsetzen:

Ubuntu: ''/etc/ldap/schema/zarafa.schema''

Weiter Informationen zu Zarafa:
[[http://doc.zarafa.com/6.40/Administrator_Manual/en-US/html/_ConfigureOpenLDAP.html|Zarafa Administrator Manual]]


===== Genutzte Felder =====
^ LDAP ^ untermStrich ^
| cn | Vollständiger Name |
| sn | Bei Adressen mit Ansprechpartner: Ansprechpartner |
| sn | Bei Adressen ohne Ansprechpartner: Name |
| o | Bei Adressen mit Ansprechpartner: Firma |
| givenName | Vorname |
| title | Titel |
| postalAddress | Straße + Straße 2 |
| street | Straße + Straße 2 |
| postalCode | Plz |
| l | Ort |
| country | Im Modus "Land aktiv": Land |
| mail | E-Mail |
| telephoneNumber | Telefon 1 |
| homeTelephoneNumber | Telefon 2 |
| mobile | Mobil |
| facsimileTelephoneNumber | Fax |
| mozillaWorkUrl | Im Modus "Mozilla": Url |
| labeledURI | Url |

==== objectclass ====
Immer: 'inetOrgPerson'\\
Modus "Mozilla": Zusätzlich 'mozillaOrgPerson'\\
Modus "Zarafa": Zusätzlich 'top' und 'zarafa-contact'