Zum Inhalt springen
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 59.1
bearbeitet von Jens Gruber
am 2022/05/05 12:50
Ä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 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,6 +117,52 @@
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  
115 +== (% id="cke_bm_200S" style="display:none" %)__** **__(%%)__**Konfiguration für LDAP im Rev-Proxy**__ ==
116 +
117 +Nun müssen Sie im Puppeteer Container eine rev-proxy.yaml anlegen. Sollte diese bereits vorhanden sein, muss diese bearbeitet werden.
118 +
119 +
120 +Wechseln Sie in das Verzeichnis /etc/logodidact/hiera/custom.d/ im Puppeteer Container:
121 +
122 +{{code language="bash"}}
123 +root@puppeteer:~ # cd /etc/logodidact/hiera/custom.d/
124 +{{/code}}
125 +
126 +
127 +Erstellen Sie die rev-proxy.yaml:
128 +
129 +{{code language="bash"}}
130 +root@puppeteer:/etc/logodidact/hiera/custom.d # vim rev-proxy.yaml
131 +{{/code}}
132 +
133 +
134 +Fügen Sie folgende Einstellungen der yaml hinzu und ersetzen **musterstadt-gym** durch den Shortname der Schule:
135 +
136 +{{code language="bash"}}
137 +ld_rproxy::hosts:
138 +  ldap.musterstadt-gym.logoip.de:
139 +    type: stream
140 +    template: ldap
141 +    ensure: present
142 +{{/code}}
143 +
144 +
145 +Übernehmen Sie die Änderungen ins git:
146 +
147 +{{code language="bash"}}
148 +root@puppeteer:~ # cd /etc/logodidact/
149 +root@puppeteer:/etc/logodidact # git add .
150 +root@puppeteer:/etc/logodidact # git coomit -am "rev-proxy.yaml angelegt."
151 +{{/code}}
152 +
153 +
154 +Führen Sie einen prun im rev-proxy Container aus:
155 +
156 +{{code language="bash"}}
157 +root@rev-proxy:~ # prun
158 +{{/code}}
159 +
160 +
120 120  == __**Ports über Firewall an Rev-Proxy weiterleiten**__ ==
121 121  
122 122  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.
... ... @@ -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
187 +(% style="color:#8e44ad" %)##**DNAT ext dmz:172.28.29.3 tcp 636**##(%%)
188 +##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:
205 +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__ ======
207 +=== __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__ ======
221 +=== __acme.sh__ ===
181 181  
182 182  Wechseln Sie in den puppeteer Container:
183 183  
... ... @@ -200,16 +200,18 @@
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:
244 +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
248 +
207 207  root@rev-proxy:~ # prun
208 208  {{/code}}
209 209  
210 210  
211 -== (% style="color:#000000" %)**__LDAP Attribute__**(%%) ==
212 212  
254 +== (% style="color:#000000" %)**__Weitere LDAP Attribute für ReadOnly-Benutzer freischalten__**(%%) ==
255 +
213 213  (% style="color:#000000" %)Standardmäßig werden folgende Attribute an die externe LDAP Schnittstelle weitergegeben:
214 214  
215 215  {{code language="bash"}}