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

Von Version 45.1
bearbeitet von Jonas Mayer
am 2022/05/04 09:27
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 55.1
bearbeitet von Jonas Mayer
am 2022/05/05 07:43
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -4,29 +4,28 @@
4 4  
5 5  ----
6 6  
7 -{{toc start="3"/}}
7 +{{toc start="2"/}}
8 8  
9 9  
10 10  (% style="color:#000000" %)[[image:Grafik für LDAp.png||height="331" width="622"]]
11 11  
12 -=== ===
13 13  
14 -== (% style="color:#000000" %)__**LDAP-Admin Benutzer**__(%%) ==
13 +== (% style="color:#000000" %)__**Übersicht der Benutzer**__(%%) ==
15 15  
16 16  
17 -=== (% style="color:#000000" %)__Nutzungsgebiet:__(%%) ===
16 +=== (% style="color:#000000" %)**LDAP-Admin Benutzer**(%%) ===
18 18  
18 +(% style="color:#000000; font-size:20px" %)__Nutzungsgebiet:__
19 +
19 19  (% 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.
20 20  
21 -(% 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!__**
22 22  
23 23  
24 -==== (% style="color:#000000" %)__Benutzername & Kennwort__(%%) ====
25 +(% class="wikigeneratedid" id="HZugangsdaten:" %)
26 +(% style="color:#000000; font-size:20px" %)__Zugangsdaten:__
25 25  
26 -====== ======
27 -
28 -====== (% style="color:#000000" %)__Benutzername__(%%) ======
29 -
28 +(% class="wikigeneratedid" id="HBenutzername" %)
30 30  (% style="color:#000000" %)Der Benutzername des LDAP Admins lautet:
31 31  
32 32  {{code language="bash"}}
... ... @@ -33,9 +33,9 @@
33 33  cn=ldap-admin
34 34  {{/code}}
35 35  
36 -====== ======
37 37  
38 -====== (% style="color:#000000" %)__Attribute des Benutzernamens__(%%) ======
36 +(% class="wikigeneratedid" id="HAttributedesBenutzernamens" %)
37 +(% style="color:#000000; font-size:16px" %)__Vollständiger Benutzername__
39 39  
40 40  (% 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.
41 41  
... ... @@ -49,7 +49,8 @@
49 49  {{/code}}
50 50  
51 51  
52 -====== (% style="color:#000000" %)__Kennwort__(%%) ======
51 +(% class="wikigeneratedid" id="HKennwort" %)
52 +(% style="color:#000000; font-size:16px" %)__Kennwort__
53 53  
54 54  (% style="color:#000000" %)Das Kennwort ist im logosrv unter folgendem Pfad einsehbar:
55 55  
... ... @@ -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
... ... @@ -64,30 +64,28 @@
64 64  {{/code}}
65 65  
66 66  
67 -== (% style="color:#000000" %)**__LDAP-ReadOnly (ldap-ro) Benutzer__**(%%) ==
67 +=== (% style="color:#000000" %)**LDAP-ReadOnly (ldap-ro) Benutzer**(%%) ===
68 68  
69 +(% class="wikigeneratedid" id="HNutzungsgebiet:" %)
70 +(% style="color:#000000; font-size:20px" %)__Nutzungsgebiet:__
69 69  
70 -==== (% style="color:#000000" %)__Nutzungsgebiet:__(%%) ====
72 +(% style="color:#000000" %)Der LDAP-ReadOnly Benutzer ist für die Verwendung in externen Diensten vorgesehen.
71 71  
72 -(% style="color:#000000" %)Der LDAP-ReadOnly Benutzer ist für die Verwendung von externen Diensten/Anbindungen gedacht.
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.
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.
75 75  
77 +(% class="wikigeneratedid" id="HBenutzername26Passwort:" %)
78 +(% style="color:#000000; font-size:20px" %)__Zugangsdaten:__
76 76  
77 -==== (% style="color:#000000" %)__Benutzername & Passwort:__(%%) ====
80 +(% class="wikigeneratedid" id="HBenutzername" %)
81 +(% style="color:#000000" %)Der Benutzername des LDAP ReadOnly Benutzers lautet:
78 78  
79 -
80 -====== (% style="color:#000000" %)__Benutzername__(%%) ======
81 -
82 -(% style="color:#000000" %)Relevant für den Zugriff von Außen wäre folgender Benutzername:
83 -
84 84  {{code language="bash"}}
85 85  cn=ldap-ro
86 86  {{/code}}
87 87  
88 -====== (% id="cke_bm_979S" style="color:#000000; display:none" %)__ __(%%) ======
89 89  
90 -====== (% style="color:#000000" %)__Attribute des Benutzernamens__(%%) ======
88 +(% 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.
93 93  
... ... @@ -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
... ... @@ -101,7 +101,8 @@
101 101  {{/code}}
102 102  
103 103  
104 -====== (% style="color:#000000" %)__Kennwort__(%%) ======
102 +(% class="wikigeneratedid" id="HKennwort" %)
103 +(% style="color:#000000; font-size:16px" %)__Kennwort__
105 105  
106 106  (% style="color:#000000" %)Das Kennwort ist im logosrv unter folgendem Pfad einsehbar:
107 107  
... ... @@ -110,16 +110,15 @@
110 110  {{/code}}
111 111  
112 112  
113 -(% 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.
114 -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.
112 +(% 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  
117 117  == __**Ports über Firewall an Rev-Proxy weiterleiten**__ ==
118 118  
119 -Damit die LDAP Verbindung funktioniert, muss der Port 636 an den Rev-Proxy weitergeleitet werden. Diese Weiterleitung können Sie wie folgt einrichten:
117 +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.
120 120  
121 121  
122 -Wechseln Sie in das Verzeichnis der Shorewall:
120 +Wechseln Sie vom ldhost aus in das Verzeichnis der Shorewall:
123 123  
124 124  {{code language="bash"}}
125 125  root@ldhosts:~ # cd /etc/shorewall
... ... @@ -133,15 +133,15 @@
133 133  {{/code}}
134 134  
135 135  
136 -Ergänzen Sie die Liste innerhalb der Datei um den obersten 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.
134 +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.
137 137  
138 138  (% class="box" %)
139 139  (((
140 140  (% style="color:#16a085" %)###
141 -# Shorewall version 4.0
142 -###(%%)##
143 -(% style="color:#8e44ad" %)**DNAT ext dmz:172.28.29.3 tcp 636**(%%)
144 -DNAT ext dmz:172.28.29.3 tcp 80,443
139 +# Shorewall version 4.0##(%%)
140 +(% style="color:#16a085" %)#(%%)
141 +(% style="color:#8e44ad" %)##**DNAT ext dmz:172.28.29.3 tcp 636**##(%%)
142 +##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
... ... @@ -158,12 +158,10 @@
158 158  
159 159  == __**Zertifikat für Rev-Proxy erstellen und prüfen**__ ==
160 160  
161 -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.
162 162  
163 -====== ======
161 +=== __acmetool__ ===
164 164  
165 -====== __acmetool__ ======
166 -
167 167  Wechseln Sie in den puppeteer Container:
168 168  
169 169  {{code language="bash"}}
... ... @@ -176,10 +176,8 @@
176 176  root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
177 177  {{/code}}
178 178  
179 -===== =====
175 +=== __acme.sh__ ===
180 180  
181 -====== __acme.sh__ ======
182 -
183 183  Wechseln Sie in den puppeteer Container:
184 184  
185 185  {{code language="bash"}}
... ... @@ -201,18 +201,17 @@
201 201  {{/code}}
202 202  
203 203  
204 -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:
205 205  
206 206  {{code language="bash"}}
207 207  root@puppeteer:~ # prun
202 +
208 208  root@rev-proxy:~ # prun
209 209  {{/code}}
210 210  
211 211  
212 -=== ===
207 +== (% style="color:#000000" %)**__Weitere LDAP Attribute für ReadOnly-Benutzer freischalten__**(%%) ==
213 213  
214 -== (% style="color:#000000" %)**__LDAP Attribute__**(%%) ==
215 -
216 216  (% style="color:#000000" %)Standardmäßig werden folgende Attribute an die externe LDAP Schnittstelle weitergegeben:
217 217  
218 218  {{code language="bash"}}