Änderungen von Dokument LDAP Admin-Benutzer und ReadOnly-Benutzer im logosrv

Zuletzt geändert von Jonas Mayer am 2022/05/25 00:02

Von Version 56.1

bearbeitet von Jens Gruber
am 2022/05/05 11:42

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 31.1

bearbeitet von David Haido
am 2022/05/02 18:14

Änderungskommentar: Renamed from entwurf:Main.LD Server.Puppet-Version.1\.3\.22\.14.LDAP Admin-Benutzer und ReadOnly-Benutzer.WebHome

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (3 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Titel

@@ -1,1 +1,1 @@
--Geändert: LDAP Admin-Benutzer und ReadOnly-Benutzer im logosrv
++LDAP Admin-Benutzer und ReadOnly-Benutzer

Dokument-Autor

@@ -1,1 +1,1 @@
--XWiki.JensGruber@sbede
++XWiki.davidhaido@sbede

Inhalt

@@ -1,47 +1,43 @@
--(% style="color:#000000" %)Um externe oder interne Dienste über das LDAPS-Protokoll einzubinden, gibt es seit Puppet-Version 1.3.22 neben dem sogenannten LDAP-Admin Konto einen neu hinzugefügten ReadOnly-Benutzer zur Anmeldung am integrierten OpenLDAP-Verzeichnisdienst.
++(% style="color:#000000" %)Um externe oder interne Dienste über LDAPS einzubinden, gibt es nach wie vor den sogenannten LDAP-Admin und den seit der Umstellung auf LDAPS neu hinzugefügten ReadOnly-Benutzer.
--(% style="color:#000000" %)In diesem Artikel erfahren Sie, wo Sie die Benutzernamen & Kennwörter der zwei Benutzer finden und welches Konto sich für welches Vorhaben am besten eignen.
++(% style="color:#000000" %)In diesem Artikel erfahren Sie, wo Sie die Benutzernamen & Kennwörter der zwei Benutzer finden und welche Nutzer sich für welches Vorhaben am besten eignen.
------
--
--{{toc start="2"/}}
--
--
  (% style="color:#000000" %)[[image:Grafik für LDAp.png||height="331" width="622"]]
++===   ===
--== (% style="color:#000000" %)__**Übersicht der Benutzer**__(%%) ==
++=== (% style="color:#000000" %)__**LDAP-Admin Benutzer**__(%%) ===
--=== (% style="color:#000000" %)**LDAP-Admin Benutzer**(%%) ===
++=== (% style="color:#000000" %)__Nutzungsgebiet:__(%%) ===
--(% style="color:#000000; font-size:20px" %)__Nutzungsgebiet:__
++(% style="color:#000000" %)Der LDAP-Admin Benutzer ist mit äußerster Vorsicht einzusetzen, da dieser einen beinahe uneingeschränkten Zugriff auf das Abrufen und Bearbeiten der Nutzerattribute des Servers besitzt. Daher sollte der Benutzer nur möglichst Intern eingesetzt werden.
--(% style="color:#000000" %)Der LDAP-Admin Benutzer ist mit äußerster Vorsicht einzusetzen, da dieser einen beinahe uneingeschränkten (Schreib-)Zugriff auf den Inhalt des OpenLDAP-Verzeichnisdienst sowie die Nutzerattribute besitzt. Daher sollte der Benutzer möglichst nur intern durch LogoDIDACT-integrierte Dienste zum Einsatz kommen.
++(% style="color:#000000" %)Sollten die Daten des Admins in unbefugte Hände gelangen, stellt dies ein massives datenschutz- und sicherheitstechnisches Problem dar. **__Von einem externen Gebrauch ist daher strengstens abzuraten!__**
--(% style="color:#000000" %)Sollten die Daten des LDAP-Admins in unbefugte Hände gelangen, stellt dies ein massives datenschutz- und sicherheitsrelevantes Problem dar. **__Von einem externen Gebrauch des Benutzerkontos ist daher strikt abzuraten!__**
++==== (% style="color:#000000" %)__Benutzername & Kennwort__(%%) ====
--(% class="wikigeneratedid" id="HZugangsdaten:" %)
--(% style="color:#000000; font-size:20px" %)__Zugangsdaten:__
++======   ======
--(% class="wikigeneratedid" id="HBenutzername" %)
--(% style="color:#000000" %)Der Benutzername des LDAP Admins lautet:
++====== (% style="color:#000000" %)__Benutzername__(%%) ======
++(% style="color:#000000" %)Der Benutzername des LDAP Admins wäre:
++
  {{code language="bash"}}
  cn=ldap-admin
  {{/code}}
++======   ======
--(% class="wikigeneratedid" id="HAttributedesBenutzernamens" %)
--(% style="color:#000000; font-size:16px" %)__Vollständiger Benutzername__
++====== (% style="color:#000000" %)__Attribute des Benutzernamens__(%%) ======
--(% style="color:#000000" %)Die BaseDN als Einstiegspunkt zum LDAP-Verzeichnisdienst kann über ein zusätzliches Programm ausgelesen werden, z.B. über das freie Tool LDAP Admin. In diesem Beispiel lautet die BaseDN {{code language="bash"}}dc=schule,dc=local{{/code}}. Dies kann von Installation zu Installation abweichen und wird durch die intern verwendete DNS Domain bestimmt, hier im Beispiel handelt es sich um den Standardwert.
++(% style="color:#000000" %)Die Attribute des LDAP Namens sind über ein zusätzliches Programm auszulesen wie z.B. die Software LDAP Admin auszulesen. In diesem Beispiel wären die Attribute {{code language="bash"}}dc=schule,dc=local{{/code}}. Dies kann von Installation zu Installation abweichen und wird durch die Intern verwendete DNS Domain bestimmt.
  (% style="color:#000000" %)[[image:1651243652049-471.png]]
--(% style="color:#000000" %)In diesem Beispiel ergibt sich der vollständige Benutzername (sogenannter //Distinguished Name// des Benutzerkontos) durch Anfügen der BaseDN:
++(% style="color:#000000" %)In diesem Beispiel wäre der Benutzername durch die ausgelesenen Attribute nun:
  {{code language="bash"}}
  cn=ldap-admin,dc=schule,dc=local
@@ -48,8 +48,7 @@
  {{/code}}
--(% class="wikigeneratedid" id="HKennwort" %)
--(% style="color:#000000; font-size:16px" %)__Kennwort__
++====== (% style="color:#000000" %)__Kennwort__(%%) ======
  (% style="color:#000000" %)Das Kennwort ist im logosrv unter folgendem Pfad einsehbar:
@@ -57,7 +57,7 @@
  root@logosrv:~ # cat /etc/ldap.secret
  {{/code}}
--(% style="color:#000000" %)Optional kann man das Passwort (sowie die gültige BaseDN des Servers als Teil des Benutzernamens) auch mit folgendem Befehl aus dem Abschnitt "Credentials" entnehmen:
++(% style="color:#000000" %)Optional kann man das Passwort auch mit folgendem Befehl unter dem Punkt "Credentials" einsehen:
  {{code language="bash"}}
  root@logosrv:~ # ldconf -o
@@ -64,43 +64,44 @@
  {{/code}}
--=== (% style="color:#000000" %)**LDAP-ReadOnly (ldap-ro) Benutzer**(%%) ===
++=== (% style="color:#000000" %)**__LDAP-ReadOnly (ldap-ro) Benutzer__**(%%) ===
--(% class="wikigeneratedid" id="HNutzungsgebiet:" %)
--(% style="color:#000000; font-size:20px" %)__Nutzungsgebiet:__
--(% style="color:#000000" %)Der LDAP-ReadOnly Benutzer ist für die Verwendung in externen Diensten vorgesehen.
++==== (% style="color:#000000" %)__Nutzungsgebiet:__(%%) ====
--(% style="color:#000000" %)Mögliche Nutzungsszenarien wären unter anderem die Anbindung  von extern gehosteten Webdiensten (z.B. Moodle, WebUntis oder Nextcloud) an die Benutzerdatenbank des LogoDIDACT Servers per LDAP-Protokoll.
++(% style="color:#000000" %)Der LDAP-ReadOnly Benutzer ist für die Verwendung von externen Diensten/Anbindungen gedacht.
++(% style="color:#000000" %)Mögliche Nutzungsmöglichkeiten wären unteranderem die Nutzung und Einbindung  von einem extern gehosteten moodle, WebUntis oder einer Nextcloud.
--(% class="wikigeneratedid" id="HBenutzername26Passwort:" %)
--(% style="color:#000000; font-size:20px" %)__Zugangsdaten:__
--(% class="wikigeneratedid" id="HBenutzername" %)
--(% style="color:#000000" %)Der Benutzername des LDAP ReadOnly Benutzers lautet:
++==== (% style="color:#000000" %)__Benutzername & Passwort:__(%%) ====
++
++====== (% style="color:#000000" %)__Benutzername__(%%) ======
++
++(% style="color:#000000" %)Relevant für den Zugriff von Außen wäre folgender Benutzername:
++
  {{code language="bash"}}
  cn=ldap-ro
  {{/code}}
++====== (% id="cke_bm_979S" style="color: rgb(0, 0, 0); display: none" %)__ __(%%) ======
--(% style="color:#000000; font-size:16px" %)__Vollständiger Benutzername__
++====== (% style="color:#000000" %)__Attribute des Benutzernamens__(%%) ======
--(% style="color:#000000" %)Die BaseDN als Einstiegspunkt zum LDAP-Verzeichnisdienst kann über ein zusätzliches Programm ausgelesen werden, z.B. über das freie Tool LDAP Admin. In diesem Beispiel lautet die BaseDN {{code language="bash"}}dc=schule,dc=local{{/code}}. Dies kann von Installation zu Installation abweichen und wird durch die intern verwendete DNS Domain bestimmt, hier im Beispiel handelt es sich um den Standardwert.
++(% style="color:#000000" %)Die Attribute des LDAP Namens sind über ein zusätzliches Programm auszulesen wie z.B. die Software LDAP Admin auszulesen. In diesem Beispiel wären die Attribute {{code language="bash"}}dc=schule,dc=local{{/code}}. Dies kann von Installation zu Installation abweichen und wird durch die Intern verwendete DNS Domain bestimmt.
  (% style="color:#000000" %)[[image:1651243652049-471.png]]
--(% style="color:#000000" %)Im Unterschied zum vorherigen Benutzer steckt das Konto verschachtelt in dem Unterobjekt //OU=services//. Dadurch ergibt sich nachfolgender, vollständiger Benutzername (sogenannter //Distinguished Name//):
++(% style="color:#000000" %)In diesem Beispiel wäre der Benutzername durch die ausgelesenen Attribute nun:
  {{code language="bash"}}
--cn=ldap-ro,ou=services,dc=schule,dc=local
++cn=ldap-ro,dc=schule,dc=local
  {{/code}}
--(% class="wikigeneratedid" id="HKennwort" %)
--(% style="color:#000000; font-size:16px" %)__Kennwort__
++====== (% style="color:#000000" %)__Kennwort__(%%) ======
  (% style="color:#000000" %)Das Kennwort ist im logosrv unter folgendem Pfad einsehbar:
@@ -109,152 +109,10 @@
  {{/code}}
--(% style="color:#000000" %)Im Zuge der Anbindung externer Dienste sollte stets darauf geachtet werden, die verschlüsselte Form des LDAP-Protokolls (d.h. LDAPS auf TCP-Port 636) zu verwenden, damit sensible Information wie Benutzer-Zugangsdaten prinzipiell per SSL-Transportverschlüsselung versendet werden. Zur Nutzung der SSL-Transportverschlüsselung ist es wiederum wichtig, ein gültiges Let's Encrypt Zertifikat zu beantragen, damit die Verbindungssicherheit zwischen zwei Servern gewährleistet werden kann.
++=== (% style="color:#000000" %)**__LDAP Attribute__**(%%) ===
--== __**Ports über Firewall an Rev-Proxy weiterleiten**__ ==
--Damit externe LDAPS-Verbindungen zum Server möglich werden, muss der TCP-Port 636 vom vorgeschalteten Router auf die externe IP-Adresse des LogoDIDACT Servers weitergeleitet werden. Vom ldhost wird die Verbindung dann entgegengenommen und abermals an den Rev-Proxy LXC-Container weitergeleitet. Die Einrichtung der zugehörige Poerweiterleitungs-Regel wird nachfolgend beschrieben.
--
--
--Wechseln Sie vom ldhost aus in das Verzeichnis der Shorewall:
--
--{{code language="bash"}}
--root@ldhosts:~ # cd /etc/shorewall
--{{/code}}
--
--
--Öffnen Sie die Datei rules mit einem Editor ihrer Wahl:
--
--{{code language="bash"}}
--root@ldhost:/etc/shorewall # vim rules
--{{/code}}
--
--
--Ergänzen Sie die Liste innerhalb der Datei um den obersten DNAT-Eintrag (lila eingefärbte Zeile). Dadurch werden externe Verbindungsanfragen auf Port 636 (LDAPS) vom ldhost zum rev-proxy LXC-Container weitergeleitet, so wie im Schaubild am Anfang des Artikels abgebildet. Falls diese Regel bereits vorhanden ist, können Sie den Schritt überspringen.
--
--(% class="box" %)
--(((
--(% style="color:#16a085" %)###
--# Shorewall version 4.0##(%%)
--(% style="color:#16a085" %)#(%%)
--(% style="color:#8e44ad" %)##**DNAT ext dmz:172.28.29.3 tcp 636**##(%%)
--##DNAT ext dmz:172.28.29.3 tcp 80,443
--DNAT ext dmz:172.28.29.2 tcp 1:21
--DNAT ext dmz:172.28.29.2 tcp 23:2221
--DNAT ext dmz:172.28.29.2 tcp 2223:65535
--DNAT ext dmz:172.28.29.2 udp 1:65535##
--)))
--
--
--Starten Sie nun die Firewall des ldhost neu:
--
--{{code language="bash"}}
--root@ldhosts:~ # /etc/init.d/shorewall restart
--{{/code}}
--
--
--== __**Zertifikat für Rev-Proxy erstellen und prüfen**__ ==
--
--Damit die Verbindung gesichert werden kann, wird ein Let's Encrypt Zertifikat benötigt. Dieses können Sie - abhängig vom zu Grunde liegenden Tool - mit den folgenden Kommandos im Puppeteer-Container erstellen.
--
--=== __acmetool__ ===
--
--Wechseln Sie in den puppeteer Container:
--
--{{code language="bash"}}
--root@ldhost:~ # lxc-ssh -n puppeteer
--{{/code}}
--
--Fordern Sie das Zertifikat mit folgendem Befehl an (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
--
--{{code language="bash"}}
--root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
--{{/code}}
--
--=== __acme.sh__ ===
--
--Wechseln Sie in den puppeteer Container:
--
--{{code language="bash"}}
--root@ldhost:~ # lxc-ssh -n puppeteer
--{{/code}}
--
--
--Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
--
--{{code language="bash"}}
--root@puppeteer:~ # sle
--{{/code}}
--
--
--Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
--
--{{code language="bash"}}
--le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
--{{/code}}
--
--
--Um das Verteilen der Zertifikate zu beschleunigen, können Sie einen gezielten 'prun' im puppeteer Container gefolgt von einen weiteren 'prun' im rev-proxy Container durchführen:
--
--{{code language="bash"}}
--root@puppeteer:~ # prun
--
--root@rev-proxy:~ # prun
--{{/code}}
--
--
--== __**Konfiguration für LDAP im Rev-Proxy**__ ==
--
--Nun müssen Sie im Puppeteer Container eine rev-proxy.yaml anlegen. Sollte diese bereits vorhanden sein, muss diese bearbeitet werden.
--
--
--Wechseln Sie in das Verzeichnis /etc/logodidact/hiera/custom.d/ im Puppeteer Container:
--
--{{code language="bash"}}
--root@puppeteer:~ # cd /etc/logodidact/hiera/custom.d/
--{{/code}}
--
--
--Erstellen Sie die rev-proxy-yaml
--
--{{code language="bash"}}
--root@puppeteer:/etc/logodidact/hiera/custom.d # vim rev-proxy.yaml
--{{/code}}
--
--
--Fügen Sie folgende Einstellungen in die yaml ein und ersetzen **musterstadt-gym** durch den Shortname der Schule:
--
--{{code language="bash"}}
-----
--ld_rproxy::hosts:
--  ldap.musterstadt-gym.logoip.de:
--    type: stream
--    template: ldap
--    ensure: present
--{{/code}}
--
--
--Übernehmen Sie die Änderungen ins git:
--
--{{code language="bash"}}
--root@puppeteer:~ # cd /etc/logodidact/
--root@puppeteer:/etc/logodidact # git add .
--root@puppeteer:/etc/logodidact # git coomit -am "rev-proxy.yaml angelegt."
--{{/code}}
--
--
--Führen Sie einen prun im rev-proxy Container aus:
--
--{{code language="bash"}}
--root@rev-proxy:~ # prun
--{{/code}}
--
--(% class="wikigeneratedid" %)
--
--
--== (% style="color:#000000" %)**__Weitere LDAP Attribute für ReadOnly-Benutzer freischalten__**(%%) ==
--
  (% style="color:#000000" %)Standardmäßig werden folgende Attribute an die externe LDAP Schnittstelle weitergegeben:
  {{code language="bash"}}
@@ -292,7 +292,7 @@
  {{/code}}
--(% style="color:#000000" %)Die angepassten ACL-Änderungen können zur Kontrolle im logosrv in der Konfigurationsdatei slapd.puppet.conf angeschaut werden:
++(% style="color:#000000" %)Die angepassten Änderungen können nun logosrv in der slapd.puppet.conf angeschaut werden:
  {{code language="bash"}}
  root@logosrv:~ # cat /etc/ldap/slapd.puppet.conf