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

Von Version 51.1
bearbeitet von Jonas Mayer
am 2022/05/04 14:44
Ä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
... ... @@ -13,13 +13,13 @@
13 13  == (% style="color:#000000" %)__**Übersicht der Benutzer**__(%%) ==
14 14  
15 15  
16 -=== (% style="color:#000000" %)**LDAP-Admin Benutzer:**(%%) ===
16 +=== (% style="color:#000000" %)**LDAP-Admin Benutzer**(%%) ===
17 17  
18 18  (% style="color:#000000; font-size:20px" %)__Nutzungsgebiet:__
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 Serverper 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
... ... @@ -143,8 +143,8 @@
143 143  (% style="color:#16a085" %)###
144 144  # Shorewall version 4.0##(%%)
145 145  (% style="color:#16a085" %)#(%%)
146 -(% style="color:#8e44ad" %)##**DNAT ext dmz:172.28.29.3 tcp 636**##(%%)##
147 -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
148 148  DNAT ext dmz:172.28.29.2 tcp 1:21
149 149  DNAT ext dmz:172.28.29.2 tcp 23:2221
150 150  DNAT ext dmz:172.28.29.2 tcp 2223:65535
... ... @@ -161,9 +161,9 @@
161 161  
162 162  == __**Zertifikat für Rev-Proxy erstellen und prüfen**__ ==
163 163  
164 -Damit die Verbindung gesichert werden kann, wird ein Let's Encrypt Zertifikat benötigt. Dieses können Sie nach folgender Anleitung erstellen:
159 +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.
165 165  
166 -====== __acmetool__ ======
161 +=== __acmetool__ ===
167 167  
168 168  Wechseln Sie in den puppeteer Container:
169 169  
... ... @@ -177,7 +177,7 @@
177 177  root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
178 178  {{/code}}
179 179  
180 -====== __acme.sh__ ======
175 +=== __acme.sh__ ===
181 181  
182 182  Wechseln Sie in den puppeteer Container:
183 183  
... ... @@ -200,16 +200,66 @@
200 200  {{/code}}
201 201  
202 202  
203 -Um das verteilen der Zertifikate zu beschleunigen können Sie ggf. einen prun im puppeteer und rev-proxy Container durchführen:
198 +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:
204 204  
205 205  {{code language="bash"}}
206 206  root@puppeteer:~ # prun
202 +
207 207  root@rev-proxy:~ # prun
208 208  {{/code}}
209 209  
210 210  
211 -== (% style="color:#000000" %)**__LDAP Attribute__**(%%) ==
207 +== __**Konfiguration für LDAP im Rev-Proxy**__ ==
212 212  
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 +
256 +== (% style="color:#000000" %)**__Weitere LDAP Attribute für ReadOnly-Benutzer freischalten__**(%%) ==
257 +
213 213  (% style="color:#000000" %)Standardmäßig werden folgende Attribute an die externe LDAP Schnittstelle weitergegeben:
214 214  
215 215  {{code language="bash"}}