Zum Inhalt springen
Zuletzt geändert von Jonas Mayer am 2022/05/25 00:02
Von Version 54.1
bearbeitet von Jonas Mayer
am 2022/05/04 14:52
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 66.1
bearbeitet von Jonas Mayer
am 2022/05/23 11:18
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Titel
... ... @@ -1,1 +1,1 @@
1 -Geändert: LDAP Admin-Benutzer und ReadOnly-Benutzer im logosrv
1 +LDAP Admin-Benutzer und ReadOnly-Benutzer im logosrv
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:" %)
... ... @@ -69,9 +69,9 @@
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 77  (% class="wikigeneratedid" id="HBenutzername26Passwort:" %)
... ... @@ -84,9 +84,7 @@
84 84  cn=ldap-ro
85 85  {{/code}}
86 86  
87 -====== (% id="cke_bm_979S" style="color:#000000; display:none" %)__ __(%%) ======
88 88  
89 -
90 90  (% style="color:#000000; font-size:16px" %)__Vollständiger Benutzername__
91 91  
92 92  (% 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.
... ... @@ -94,7 +94,7 @@
94 94  (% style="color:#000000" %)[[image:1651243652049-471.png]]
95 95  
96 96  
97 -(% 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//):
98 98  
99 99  {{code language="bash"}}
100 100  cn=ldap-ro,ou=services,dc=schule,dc=local
... ... @@ -114,6 +114,52 @@
114 114  (% 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.
115 115  
116 116  
115 +== (% style="color:#000000" %)__**Konfiguration zur Freischaltung von OpenLDAP via Rev-Proxy**__(%%) ==
116 +
117 +Um den Verzeichnisdienst mit signiertem Let's Encrypt per nginx-stream freizuschalten, müssen Sie im Puppeteer-Container die Konfigurationsdatei {{box}}rev-proxy.yaml{{/box}} anlegen. Sollte diese bereits vorhanden sein, muss diese stattdessen bearbeitet werden.
118 +
119 +
120 +Wechseln Sie in das Verzeichnis {{box}}/etc/logodidact/hiera/custom.d/{{/box}} 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 Datei {{box}}rev-proxy.yaml{{/box}} bzw. fügen Sie den Inhalt aus dem nachfolgenden Schritt darin hinzu, falls die Datei bereits vorhanden ist:
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 folgenden Konfigurationsabschnitt zur Konfigurationsdatei hinzu und ersetzen Sie **SCHULKUERZEL** in der zweiten Zeile durch den passenden ShortName der Schule:
135 +
136 +{{code language="bash"}}
137 +ld_rproxy::hosts:
138 +  ldaps.SCHULKUERZEL.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 {{box}}prun{{/box}} im rev-proxy Container aus, um die Freischaltung des LDAPS-Tunnels zu aktivieren:
155 +
156 +{{code language="bash"}}
157 +root@rev-proxy:~ # prun
158 +{{/code}}
159 +
160 +
117 117  == __**Ports über Firewall an Rev-Proxy weiterleiten**__ ==
118 118  
119 119  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.
... ... @@ -126,7 +126,7 @@
126 126  {{/code}}
127 127  
128 128  
129 -Öffnen Sie die Datei rules mit einem Editor ihrer Wahl:
173 +Öffnen Sie die Datei {{box}}rules{{/box}} mit einem Editor ihrer Wahl:
130 130  
131 131  {{code language="bash"}}
132 132  root@ldhost:/etc/shorewall # vim rules
... ... @@ -133,7 +133,7 @@
133 133  {{/code}}
134 134  
135 135  
136 -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.
180 +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 LXC-Container rev-proxy weitergeleitet, so wie im Schaubild am Anfang des Artikels abgebildet. Falls diese Regel bereits vorhanden ist, können Sie den Schritt überspringen.
137 137  
138 138  (% class="box" %)
139 139  (((
... ... @@ -140,8 +140,8 @@
140 140  (% style="color:#16a085" %)###
141 141  # Shorewall version 4.0##(%%)
142 142  (% style="color:#16a085" %)#(%%)
143 -(% style="color:#8e44ad" %)##**DNAT ext dmz:172.28.29.3 tcp 636**##(%%)##
144 -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
145 145  DNAT ext dmz:172.28.29.2 tcp 1:21
146 146  DNAT ext dmz:172.28.29.2 tcp 23:2221
147 147  DNAT ext dmz:172.28.29.2 tcp 2223:65535
... ... @@ -149,10 +149,10 @@
149 149  )))
150 150  
151 151  
152 -Starten Sie nun die Firewall des ldhost neu:
196 +Starten Sie nun die Firewall am ldhost neu:
153 153  
154 154  {{code language="bash"}}
155 -root@ldhosts:~ # /etc/init.d/shorewall restart
199 +root@ldhosts:~ # systemctl restart shorewall.service
156 156  {{/code}}
157 157  
158 158  
... ... @@ -171,7 +171,7 @@
171 171  Fordern Sie das Zertifikat mit folgendem Befehl an (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
172 172  
173 173  {{code language="bash"}}
174 -root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
218 +root@puppeteer:~ # acmetool want ldaps.SCHULKUERZEL.logoip.de
175 175  {{/code}}
176 176  
177 177  === __acme.sh__ ===
... ... @@ -193,7 +193,7 @@
193 193  Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
194 194  
195 195  {{code language="bash"}}
196 -le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
240 +le-acme@puppeteer:~ $ issue ldaps.SCHULKUERZEL.logoip.de
197 197  {{/code}}
198 198  
199 199  
... ... @@ -206,6 +206,7 @@
206 206  {{/code}}
207 207  
208 208  
253 +
209 209  == (% style="color:#000000" %)**__Weitere LDAP Attribute für ReadOnly-Benutzer freischalten__**(%%) ==
210 210  
211 211  (% style="color:#000000" %)Standardmäßig werden folgende Attribute an die externe LDAP Schnittstelle weitergegeben: