Zum Inhalt springen
Zuletzt geändert von Jonas Mayer am 2022/05/25 00:02
Von Version 53.1
bearbeitet von Jonas Mayer
am 2022/05/04 14:50
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 56.1
bearbeitet von Jens Gruber
am 2022/05/05 11:42
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.jonasmayer@sbede
1 +XWiki.JensGruber@sbede
Inhalt
... ... @@ -19,7 +19,7 @@
19 19  
20 20  (% 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.
21 21  
22 -(% style="color:#000000" %)Sollten die Daten des LDAP-Admins in unbefugte Hände gelangen, stellt dies ein massives datenschutz- und sicherheitstechnisches Problem dar. **__Von einem externen Gebrauch des Benutzerkontos ist daher strengstens abzuraten!__**
22 +(% 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!__**
23 23  
24 24  
25 25  (% class="wikigeneratedid" id="HZugangsdaten:" %)
... ... @@ -57,7 +57,7 @@
57 57  root@logosrv:~ # cat /etc/ldap.secret
58 58  {{/code}}
59 59  
60 -(% style="color:#000000" %)Optional kann man das Passwort (sowie die gültige BaseDN als Suffix des Benutzernamens) auch mit folgendem Befehl unter dem Punkt "Credentials" einsehen:
60 +(% 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:
61 61  
62 62  {{code language="bash"}}
63 63  root@logosrv:~ # ldconf -o
... ... @@ -69,12 +69,11 @@
69 69  (% class="wikigeneratedid" id="HNutzungsgebiet:" %)
70 70  (% style="color:#000000; font-size:20px" %)__Nutzungsgebiet:__
71 71  
72 -(% style="color:#000000" %)Der LDAP-ReadOnly Benutzer ist für die Verwendung von externen Diensten/Anbindungen gedacht.
72 +(% style="color:#000000" %)Der LDAP-ReadOnly Benutzer ist für die Verwendung in externen Diensten vorgesehen.
73 73  
74 -(% style="color:#000000" %)Mögliche Nutzungsszenarien wären unter anderem die Anbindung  von extern gehosteten Webdiensten (z.B. Moodle, WebUntis oder Nextcloud) an die LogoDIDACT-integrierte Benutzerdatenbank über das LDAP-Protokoll.
74 +(% 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.
75 75  
76 76  
77 -
78 78  (% class="wikigeneratedid" id="HBenutzername26Passwort:" %)
79 79  (% style="color:#000000; font-size:20px" %)__Zugangsdaten:__
80 80  
... ... @@ -85,11 +85,7 @@
85 85  cn=ldap-ro
86 86  {{/code}}
87 87  
88 -====== (% id="cke_bm_979S" style="color:#000000; display:none" %)__ __(%%) ======
89 89  
90 -
91 -
92 -(% class="wikigeneratedid" id="HAttributedesBenutzernamens" %)
93 93  (% style="color:#000000; font-size:16px" %)__Vollständiger Benutzername__
94 94  
95 95  (% 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.
... ... @@ -97,7 +97,7 @@
97 97  (% style="color:#000000" %)[[image:1651243652049-471.png]]
98 98  
99 99  
100 -(% style="color:#000000" %)Im Unterschied zum vorherigen Benutzer steckt das Konto verschachtelt in der OU //services//. Dadurch ergibt sich nachfolgender, vollständiger Benutzername (sogenannter //Distinguished Name//):
95 +(% 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//):
101 101  
102 102  {{code language="bash"}}
103 103  cn=ldap-ro,ou=services,dc=schule,dc=local
... ... @@ -117,9 +117,6 @@
117 117  (% 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.
118 118  
119 119  
120 -
121 -
122 -
123 123  == __**Ports über Firewall an Rev-Proxy weiterleiten**__ ==
124 124  
125 125  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.
... ... @@ -146,8 +146,8 @@
146 146  (% style="color:#16a085" %)###
147 147  # Shorewall version 4.0##(%%)
148 148  (% style="color:#16a085" %)#(%%)
149 -(% style="color:#8e44ad" %)##**DNAT ext dmz:172.28.29.3 tcp 636**##(%%)##
150 -DNAT ext dmz:172.28.29.3 tcp 80,443
141 +(% style="color:#8e44ad" %)##**DNAT ext dmz:172.28.29.3 tcp 636**##(%%)
142 +##DNAT ext dmz:172.28.29.3 tcp 80,443
151 151  DNAT ext dmz:172.28.29.2 tcp 1:21
152 152  DNAT ext dmz:172.28.29.2 tcp 23:2221
153 153  DNAT ext dmz:172.28.29.2 tcp 2223:65535
... ... @@ -212,6 +212,55 @@
212 212  {{/code}}
213 213  
214 214  
207 +== __**Konfiguration für LDAP im Rev-Proxy**__ ==
208 +
209 +Nun müssen Sie im Puppeteer Container eine rev-proxy.yaml anlegen. Sollte diese bereits vorhanden sein, muss diese bearbeitet werden.
210 +
211 +
212 +Wechseln Sie in das Verzeichnis /etc/logodidact/hiera/custom.d/ im Puppeteer Container:
213 +
214 +{{code language="bash"}}
215 +root@puppeteer:~ # cd /etc/logodidact/hiera/custom.d/
216 +{{/code}}
217 +
218 +
219 +Erstellen Sie die rev-proxy-yaml
220 +
221 +{{code language="bash"}}
222 +root@puppeteer:/etc/logodidact/hiera/custom.d # vim rev-proxy.yaml
223 +{{/code}}
224 +
225 +
226 +Fügen Sie folgende Einstellungen in die yaml ein und ersetzen **musterstadt-gym** durch den Shortname der Schule:
227 +
228 +{{code language="bash"}}
229 +---
230 +ld_rproxy::hosts:
231 +  ldap.musterstadt-gym.logoip.de:
232 +    type: stream
233 +    template: ldap
234 +    ensure: present
235 +{{/code}}
236 +
237 +
238 +Übernehmen Sie die Änderungen ins git:
239 +
240 +{{code language="bash"}}
241 +root@puppeteer:~ # cd /etc/logodidact/
242 +root@puppeteer:/etc/logodidact # git add .
243 +root@puppeteer:/etc/logodidact # git coomit -am "rev-proxy.yaml angelegt."
244 +{{/code}}
245 +
246 +
247 +Führen Sie einen prun im rev-proxy Container aus:
248 +
249 +{{code language="bash"}}
250 +root@rev-proxy:~ # prun
251 +{{/code}}
252 +
253 +(% class="wikigeneratedid" %)
254 +
255 +
215 215  == (% style="color:#000000" %)**__Weitere LDAP Attribute für ReadOnly-Benutzer freischalten__**(%%) ==
216 216  
217 217  (% style="color:#000000" %)Standardmäßig werden folgende Attribute an die externe LDAP Schnittstelle weitergegeben: