Quelltext der Seite Seafile Server - Active Directory Anbindung

<u>'''Changelog:'''</u><br>
* 20.12.2017: Erste Version
* 11.01.2018: Probleme mit Sonderzeichen ergänzt
<br>
----
Es ist zwar in der Anleitung von Seafile beschrieben: https://manual.seafile.com/deploy/using_ldap.html<br>
Aber man muss genau lesen - und scheitert eventuell doch.<br>
Deshalb hier meine Version der Anleitung.<br>
<br>
----
==Ausgangslage==
Ich gehe davon aus das der Seafile-Server ansonsten bereits funktioniert, man kann lokale Benutzer anlegen und nutzen.<br>
Fehlt nur noch die Anbindung an das Active Directory.<br>
<br>
----
==Ziel==
Benutzer die sich in einer bestimmten Active Directory-Gruppe befinden sollen sich ohne weitere Eingriffe in Seafile anmelden können.<br>
Die Gruppe heißt in diesen Beispielen:<br>
 SeafileUser
<br>
----
==Voraussetzungen==
Wir müssen den Namen der Domäne wissen, sowie die Adresse eines Domänencontrollers.<br>
Wir brauchen einen Benutzer mit dem sich der Seafile Server am Active Directory anmelden kann. Ein ganz normaler Windows-Benutzer reicht:<br>
Die Gruppe sollte angelegt sein und zumindest ein Mitglied haben. Die Benutzer in der Gruppe haben einen Eintrag im Feld "E-Mail:", denn Seafile möchte bei LDAP Benutzern immer das Format '''''Name@domain.suffix''''' haben.<br>
Ergibt die folgenden Daten:<br>
 Domäne ..........: znil.local
 Domänencontroller: 192.168.45.50
 Gruppe ..........: seafileUser
 Benutzer ........: ldapSearch
 Passwort ........: abcd1234
<br>
----
==Konfiguration Seafile==
Wir stoppen zunächst den Seafile Server:<br>
 systemctl stop seahub.service && systemctl stop seafile.service
und bearbeiten die Datei <code>ccnet.conf</code> im Seafile-Verzeichnis:<br>
 nano /home/seafile/haiwen/conf/ccnet.conf
Unten an die Datei hängen wir folgenden Abschnitt an:<br>
 [LDAP]
 HOST = ldap://192.168.45.50/
 BASE = OU=3.Funktionsbenutzer,DC=znil,DC=local;OU=1.Email-Benutzer,DC=znil,DC=local
 USER_DN = CN=ldapSearch,OU=3.Funktionsbenutzer,DC=znil,DC=local
 PASSWORD = abcd1234
 LOGIN_ATTR = mail
 FILTER = memberOf=CN=SeafileUser,OU=4.Funktionsgruppen,DC=znil,DC=local
Da sehen wir nun die ersten Hürden und Probleme. Zum einen müssen '''''Distinguished Names''''' angegeben werden, zum anderen Unterstützt der Seafile Server '''keine''' globale Suche in der Domäne, man muss immer eine OU (Organisationseinheit) angeben. Aber hier die Erklärungen im Detail:<br>
----
===HOST===
Hier geben wir den Namen oder die IP-Adresse des Domänencontrollers an:
 HOST = ldap://192.168.45.50/
Alternativ mit Port:
 HOST = ldap://192.168.45.50:389/
Es geht auch mit Verschlüsselung - was Ihr auf dem Domänencontroller aber erst einrichten müsst. Wer das will - siehe Seafile Handbuch.<br>
<br>
----
===BASE===
<code>BASE</code> ist die Suchbasis. Unterhalb dieses Knotens werden die Benutzer(!) gesucht. Bei vielen anderen Lösungen würde man einfach
 BASE = DC=znil,DC=local
eingeben und er würde alles innerhalb der Domäne durchsuchen. '''Das geht mit Seafile NICHT!'''<br>
Es muss immer eine OU angegeben werden. Für die Standard-OU "Users" sähe die korrekte Zuordnung also so aus: <br>
 BASE = OU=Users,DC=znil,DC=local
Wohl dem der alle Benutzer unterhalb der selben OU hat ... nein, ganz so schlimm ist es nicht.<br>
Mein Test Active Directory sieht so aus:<br>
:[[Datei:ClipCapIt-171220-151942.PNG]]<br>
Und ich möchte Benutzer unterhalb der beiden markierten OUs hinzufügen:<br>
 1.Email-Benutzer
 3.Funktionsbenutzer
Man darf mehrere BASE angeben, jeweils getrennt durch ein <code>;</code>, also brauchen wir nur noch die '''''Distinguished Names''''' der beiden OUs.<br>
Da Copy&Paste in der Regel weniger Fehler erzeugt zeige ich euch 2 Methoden um an diesen Namen zu kommen:<br>
<br>
====per CMD====
Startet auf einem Domänencontroller(!) eine Eingabeaufforderung und gebt folgenden Befehl ein:<br>
 dsquery ou -name 1.Email-Benutzer
Ausgabe:<br>
 "OU=1.Email-Benutzer,DC=znil,DC=local"
Das Wiederholt Ihr für alle OUs unterhalb derer eure Benutzer stehen. Ihr müsst NICHT jede Unter-OU mit aufführen!<br>
<br>
----
====per Active Directory-Benutzer und -Computer====
Öffnet '''''Active Directory-Benutzer und -Computer'''''<br>
Aktiviert unter '''Ansicht''' die '''Erweiterte Features'''<br>
:[[Datei:ClipCapIt-171220-153033.PNG]]<br>
Ruft per Rechtsklick auf die OU deren Eigenschaften auf:<br>
:[[Datei:ClipCapIt-171220-153253.PNG]]<br>
Geht auf den Reiter '''Attribut-Editor''' und sucht die Zeile '''distinguishedName''' und macht einen Doppelklick:<br>
:[[Datei:ClipCapIt-171220-153402.PNG]]
Nun könnt Ihr den Text herauskopieren.<br>
<br>
----
Nun haben wir also die DN zusammen:<br>
 1.Email-Benutzer      = OU=3.Funktionsbenutzer,DC=znil,DC=local
 3.Funktionsbenutzer   = OU=1.Email-Benutzer,DC=znil,DC=local
Diese beiden gebe ich nun, per <code>;</code> getrennt bei <code>BASE</code> an:<br>
 BASE = OU=3.Funktionsbenutzer,DC=znil,DC=local;OU=1.Email-Benutzer,DC=znil,DC=local
<br>
----

==USER_DN, PASSWORD==
Als nächstes folgt der Benutzer für den Active Directory Zugriff und dessen Passwort:<br>
 USER_DN = CN=ldapSearch,OU=3.Funktionsbenutzer,DC=znil,DC=local
 PASSWORD = abcd1234
Den '''''Distinguished Names''''' erhalten wir nach dem gleichen Prinzip wie für die OU, der CMD Aufruf ist
 dsquery user -samid ldapSearch
<br>
----
==LOGIN_ATTR==
 LOGIN_ATTR = mail
Damit geben wir an das wir die Email-Adresse des Benutzers als Login-Benutzernamen verwenden wollen.<br>
Das ist das Feld '''E-Mail:''' bei den Eigenschaften eines Benutzer im Active Directory
Alternativ ginge auch
 LOGIN_ATTR = userPrincipalName
Das wäre die folgenden Stelle:<br>
:[[Datei:ClipCapIt-171220-154436.PNG]]<br>
Das kann mit der E-Mail-Adresse identisch sein, muss er aber nicht. Wenn der Administrator nichts anderes konfiguriert hat ist der in der Regel der interne Domänenname, also '''''Bernhard@znil.local'''''<br>
<br>
----

==FILTER==
Mit Filter kann ich die Bedingungen definieren die ein Benutzer erfüllen muss um Seafile nutzen zu können.<br>
Hier soll er Mitglied der Gruppe "SeafileUser" sein:<br>
 FILTER = memberOf=CN=SeafileUser,OU=4.Funktionsgruppen,DC=znil,DC=local
Den DN kriegen wir wiederum wie bei der OU raus, die Abfrage per CMD sieht so aus:<br>
 dsquery group -samid SeafileUser
<br>
{{Tipp| Ihr könnt den Filter auch ganz weglassen - dann dürfen alle Benutzer unterhalb der OU sich anmelden}}<br>
{{Hinweis| Besondere Zeichen müssen ggf. wiederum "escaped" werden. Zum Beispiel wird ein <code>#</code> im Namen bei der Ermittlung als <code>\#</code> eingefügt. Für einen DN ist das auch die Korrekte Schreibweise. Hier an dieser Stelle geht es aber um einen LDAP-Suchstring - und in dem ist es so nicht erlaubt. Statt <code>\#</code> muss man hier ein <code>\\23</code> einfügen. Die Werte findet Ihr hier: http://www.utf8-zeichentabelle.de/<br> Wenn es nicht klappt, eure Gruppe Sonderzeichen enthält die bei der Ermittlung mit <code>\</code> escaped wurden dann liegt es daran!}}<br>
{{Warnung| Generell ist es eine schlechte Idee eine Gruppe mit Sonderzeichen zu verwenden. Der Name sollte nur aus Buchstaben, Zahlen und dem "-" bestehen. Bei einem Kunden hat es zwar scheinbar nach vorzu beschriebener Methode geklappt - aber dann gab es Probleme bei der Anmeldung. Nur Benutzer die auf dem Reiter '''LDAP''' erscheinen können sich auch anmelden. Ist dieser Leer stimmt etwas nicht mit der Gruppe}}<br>
----

==Kontrolle==
Speichert die <code>ccnet.conf</code> und startet die Dienste wieder:<br>
 systemctl start seafile.service && systemctl start seahub.service
<br>
In der Administrationsoberfläche von Seafile in der Benutzerverwaltung gibt es nun einen neuen Reiter LDAP:<br>
:[[Datei:ClipCapIt-171220-155449.PNG]]<br>
Dort werden alle gefundenen Benutzer aufgeführt.<br>
Diese können sich mit ihrer Email-Adresse (alles klein geschrieben) und Ihrem Windows-Passwort an Seafile anmelden.<br>
<br>
----
==Kommentare==
<comments />