Zum Inhalt springen
Zuletzt geändert von Jens Gruber am 2022/05/25 09:01
Von Version 1.1
bearbeitet von Jens Gruber
am 2022/05/02 09:53
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 17.2
bearbeitet von Jens Gruber
am 2022/05/25 09:01
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,12 +1,14 @@
1 -Damit der Webzugriff von Kopano über ein Zertifikat abgesichert ist, muss dieses erst auf dem logoDIDACT-Server generiert werden. In folgendem Artikel erfahren Sie, was für Vorrausetzungen es gibt und über welche Wege ein Zertifikat generiert werden kann.
1 +(% style="color:#000000" %)Damit Webzugriffe auf Kopano über ein Zertifikat abgesichert sind, muss dieses zunächst auf dem LogoDIDACT-Server beantragt werden. Dies ist insbesondere für die Nutzung von Z-Push (ActiveSync-Protokoll) von hoher Relevanz.
2 +In diesem Artikel erfahren Sie, welche Voraussetzungen es gibt und wie ein signiertes Let's Encrypt Zertifikat generiert werden kann.
2 2  
4 +{{toc start="4"/}}
3 3  
4 -==== __**Vorrausetzungen**__ ====
5 5  
7 +----
6 6  
7 -===== __Portweiterleitung__ =====
9 +==== (% style="color:#000000" %)__Voraussetzungen__(%%) ====
8 8  
9 -Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
11 +(% style="color:#000000" %)Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom vorgeschalteten Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
10 10  
11 11  {{code language="bash"}}
12 12  WAN (Internet) TCP-Port 80 -> auf externe IP-Adresse des logoDIDACT-Servers [http]
... ... @@ -14,11 +14,139 @@
14 14  {{/code}}
15 15  
16 16  
17 -===== __Split-DNS__ =====
19 +===== __Freigabe von Kopano über rev-proxy__ =====
18 18  
19 -Split-DNS muss im logosrv eingerichtet werden und sorgt für ein zuverlässiges beantragen des SSL-Zertifikates. Hintergrund für Split-DNS ist ein oftmals fehlerhaftes NAT-Loopback am Router. Dies sorgt dafür dass nicht versucht wird, interne Adressen auch intern aufzulösen sondern ins Internet geschickt werden.
20 20  
21 21  
22 -Führen Sie folgende Schritte zur Einrichtung durch:
23 +(% style="color:#000000" %)Stellen Sie zunächst sicher, dass der rev-proxy Container am Server aktiviert ist, falls Sie Kopano im Internet freischalten möchten.
23 23  
25 +(% style="color:#000000" %)Erweitern Sie die ##{{code}}/etc/logodidact/hosts/rev-proxy/revproxy.conf{{/code}}## im Puppeteer-LXC um folgende Zeilen, um Kopano im rev-proxy freizugeben. Achten Sie hierbei auf Angabe des richtigen Templates.
26 +
27 +{{code language="bash"}}
28 +[ReverseProxy kopano.ShortName.logoip.de]
29 +Url https://kopano
30 +Template kopano
31 +{{/code}}
32 +
33 +(% style="color:#000000" %) Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:
34 +
35 +{{code language="bash"}}
36 +cd /etc/logodidact/
37 +git add .
38 +git commit -a -m "Kopano über rev-proxy freigegeben."
39 +{{/code}}
40 +
41 +
42 +===== (% style="color:#000000" %)__Split-DNS__(%%) =====
43 +
44 +(% style="color:#000000" %)Hintergrund für Split-DNS ist ein oftmals fehlerhaftes NAT-Loopback am Router. Dies stellt sicher, dass externe Adressen wie z.b. kopano.shortname.logoip.de nicht zum Router geschickt werden, sondern zum internen rev-proxy weitergeleitet werden. Dadurch wird der Router als Fehlerquelle ausgeschlossen und alle Benutzer können im Schulnetz wie auch Zuhause die gleiche URL für den Zugriff verwenden.
45 +
46 +(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch, falls noch nicht erfolgt.
47 +
48 +(% style="color:#000000" %)Öffnen Sie die Datei "named.conf.local" im logosrv:
49 +
50 +{{code language="bash"}}
51 +root@logosrv:~ # vim /etc/bind/named.conf.local
52 +{{/code}}
53 +
54 +
55 +(% style="color:#000000" %)Bearbeiten Sie die Datei wie folgt (Ersetzen Sie "musterstadt" durch den Schul-Shortname):
56 +
57 +{{code language="bash"}}
58 +## Externe dynamische IP intern auflösen
59 +zone "musterstadt.logoip.de" {
60 +  type master;
61 +  file "/etc/bind/db.dynip";
62 +  check-names ignore;
63 +};
64 +{{/code}}
65 +
66 +
67 +(% style="color:#000000" %)Öffnen Sie die referenzierte Datei {{box}}db.dynip{{/box}} im logosrv:
68 +
69 +{{code language="bash"}}
70 +root@logosrv:~ # vim /etc/bind/db.dynip
71 +{{/code}}
72 +
73 +
74 +(% style="color:#000000" %)Passen Sie gegebenenfalls die IP-Adresse in den letzten beiden Zeilen an, als Ziel muss auf den Rev-Proxy Container verwiesen werden. Im Standard lautet dessen IP-Adresse "172.28.28.27":
75 +
76 +{{code language="bash"}}
77 +$TTL 1h
78 +@                IN     SOA   ns1.schule.local. postmaster.schule.local. (
79 +                                2009010101 ; serial
80 +                                86400      ; refresh (1 day)
81 +                                900        ; retry (15 minutes)
82 +                                604800     ; expire (1 week)
83 +                                900        ; minimum (15 minutes)
84 +                                )
85 +
86 +                 NS      ns1.schule.local.
87 +                 NS      ns2.schule.local.
88 +
89 +@                A       172.28.28.27
90 +*                A       172.28.28.27
91 +{{/code}}
92 +
93 +
94 +(% style="color:#000000" %)Starten Sie nach den Anpassungen den DNS-Server im logosrv neu:
95 +
96 +{{code language="bash"}}
97 +root@logosrv:~ # /etc/init.d/bind9 restart
98 +{{/code}}
99 +
100 +
101 +----
102 +
103 +==== (% style="color:#000000" %)__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__(%%) ====
104 +
105 +(% style="color:#000000" %)Nach Schaffung der technischen Voraussetzungen können Sie das Let's Encrypt-Zertifikat anfordern. Je nach verwendeter Software/Serverstand können Sie die folgenden 2 Wege nutzen:
106 +
107 +
108 +===== (% style="color:#000000" %)__acmetool__(%%) =====
109 +
110 +(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
111 +
112 +{{code language="bash"}}
113 +root@ldhost:~ # lxc-ssh -n puppeteer
114 +{{/code}}
115 +
116 +
117 +(% style="color:#000000" %)Fordern Sie das Zertifikat mit folgendem Befehl an (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
118 +
119 +{{code language="bash"}}
120 +root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
121 +{{/code}}
122 +
123 +
124 +===== (% style="color:#000000" %)__acme.sh__(%%) =====
125 +
126 +(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
127 +
128 +{{code language="bash"}}
129 +root@ldhost:~ # lxc-ssh -n puppeteer
130 +{{/code}}
131 +
132 +
133 +(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung des Benutzers le-acme zur Verwaltung der Let's Encrypt Zertifikate:
134 +
135 +{{code language="bash"}}
136 +root@puppeteer:~ # sle
137 +{{/code}}
138 +
139 +
140 +(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
141 +
142 +{{code language="bash"}}
143 +le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
144 +{{/code}}
145 +
146 +
147 +(% style="color:#000000" %)Um das Verteilen der Zertifikate zu beschleunigen, können Sie nacheinander einen {{box}}prun{{/box}} im puppeteer und rev-proxy Container durchführen:
148 +
149 +{{code language="bash"}}
150 +root@puppeteer:~ # prun
151 +root@rev-proxy:~ # prun
152 +{{/code}}
153 +
24 24