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 49.1
bearbeitet von Jonas Mayer
am 2022/05/04 14:31
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -13,7 +13,7 @@
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  
... ... @@ -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 des Servers als Teil des Benutzernamens) auch mit folgendem Befehl aus dem Abschnitt "Credentials" entnehmen:
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:
61 61  
62 62  {{code language="bash"}}
63 63  root@logosrv:~ # ldconf -o
... ... @@ -64,21 +64,19 @@
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 +=== (% style="color:#000000" %)__Nutzungsgebiet:__(%%) ===
71 71  
72 72  (% style="color:#000000" %)Der LDAP-ReadOnly Benutzer ist für die Verwendung von externen Diensten/Anbindungen gedacht.
73 73  
74 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  
75 +==== (% style="color:#000000" %)__Benutzername & Passwort:__(%%) ====
76 76  
77 -(% class="wikigeneratedid" id="HBenutzername26Passwort:" %)
78 -(% style="color:#000000; font-size:20px" %)__Zugangsdaten:__
77 +====== (% style="color:#000000" %)__Benutzername__(%%) ======
79 79  
80 -(% class="wikigeneratedid" id="HBenutzername" %)
81 -(% style="color:#000000" %)Der Benutzername des LDAP ReadOnly Benutzers lautet:
79 +(% style="color:#000000" %)Relevant für den Zugriff von Außen wäre folgender Benutzername:
82 82  
83 83  {{code language="bash"}}
84 84  cn=ldap-ro
... ... @@ -86,9 +86,8 @@
86 86  
87 87  ====== (% id="cke_bm_979S" style="color:#000000; display:none" %)__ __(%%) ======
88 88  
87 +====== (% style="color:#000000" %)__Attribute des Benutzernamens__(%%) ======
89 89  
90 -(% style="color:#000000; font-size:16px" %)__Vollständiger Benutzername__
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 94  (% style="color:#000000" %)[[image:1651243652049-471.png]]
... ... @@ -101,8 +101,7 @@
101 101  {{/code}}
102 102  
103 103  
104 -(% class="wikigeneratedid" id="HKennwort" %)
105 -(% style="color:#000000; font-size:16px" %)__Kennwort__
101 +====== (% style="color:#000000" %)__Kennwort__(%%) ======
106 106  
107 107  (% style="color:#000000" %)Das Kennwort ist im logosrv unter folgendem Pfad einsehbar:
108 108  
... ... @@ -111,15 +111,16 @@
111 111  {{/code}}
112 112  
113 113  
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.
110 +(% 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.
111 +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 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.
116 +Damit die LDAP Verbindung funktioniert, muss der Port 636 an den Rev-Proxy weitergeleitet werden. Diese Weiterleitung können Sie wie folgt einrichten:
120 120  
121 121  
122 -Wechseln Sie vom ldhost aus in das Verzeichnis der Shorewall:
119 +Wechseln Sie in das Verzeichnis der Shorewall:
123 123  
124 124  {{code language="bash"}}
125 125  root@ldhosts:~ # cd /etc/shorewall
... ... @@ -133,14 +133,14 @@
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.
133 +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.
137 137  
138 138  (% class="box" %)
139 139  (((
140 140  (% style="color:#16a085" %)###
141 141  # Shorewall version 4.0##(%%)
142 -(% style="color:#16a085" %)#(%%)
143 -(% style="color:#8e44ad" %)##**DNAT ext dmz:172.28.29.3 tcp 636**##(%%)##
139 +(% style="color:#16a085" %)#(%%)##
140 +(% style="color:#8e44ad" %)**DNAT ext dmz:172.28.29.3 tcp 636**(%%)
144 144  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
... ... @@ -158,9 +158,9 @@
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 - abhängig vom zu Grunde liegenden Tool - mit den folgenden Kommandos im Puppeteer-Container erstellen.
158 +Damit die Verbindung gesichert werden kann, wird ein Let's Encrypt Zertifikat benötigt. Dieses können Sie nach folgender Anleitung erstellen:
162 162  
163 -=== __acmetool__ ===
160 +====== __acmetool__ ======
164 164  
165 165  Wechseln Sie in den puppeteer Container:
166 166  
... ... @@ -174,7 +174,7 @@
174 174  root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
175 175  {{/code}}
176 176  
177 -=== __acme.sh__ ===
174 +====== __acme.sh__ ======
178 178  
179 179  Wechseln Sie in den puppeteer Container:
180 180  
... ... @@ -197,16 +197,15 @@
197 197  {{/code}}
198 198  
199 199  
200 -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:
197 +Um das verteilen der Zertifikate zu beschleunigen können Sie ggf. einen prun im puppeteer und rev-proxy Container durchführen:
201 201  
202 202  {{code language="bash"}}
203 203  root@puppeteer:~ # prun
204 -
205 205  root@rev-proxy:~ # prun
206 206  {{/code}}
207 207  
208 208  
209 -== (% style="color:#000000" %)**__Weitere LDAP Attribute für ReadOnly-Benutzer freischalten__**(%%) ==
205 +== (% style="color:#000000" %)**__LDAP Attribute__**(%%) ==
210 210  
211 211  (% style="color:#000000" %)Standardmäßig werden folgende Attribute an die externe LDAP Schnittstelle weitergegeben:
212 212