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

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,14 +1,12 @@
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.
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.
3 3  
4 -{{toc start="4"/}}
5 5  
4 +==== __**Vorrausetzungen**__ ====
6 6  
7 -----
8 8  
9 -==== (% style="color:#000000" %)__Voraussetzungen__(%%) ====
7 +===== __Portweiterleitung__ =====
10 10  
11 -(% style="color:#000000" %)Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom vorgeschalteten Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
9 +Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
12 12  
13 13  {{code language="bash"}}
14 14  WAN (Internet) TCP-Port 80 -> auf externe IP-Adresse des logoDIDACT-Servers [http]
... ... @@ -16,55 +16,33 @@
16 16  {{/code}}
17 17  
18 18  
19 -===== __Freigabe von Kopano über rev-proxy__ =====
17 +===== __Split-DNS__ =====
20 20  
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.
21 21  
22 22  
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.
22 +Führen Sie folgende Schritte für die Einrichtung durch:
24 24  
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.
24 +Öffnen Sie die Datei "named.conf.local" im logosrv:
26 26  
27 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 51  root@logosrv:~ # vim /etc/bind/named.conf.local
52 52  {{/code}}
53 53  
54 54  
55 -(% style="color:#000000" %)Bearbeiten Sie die Datei wie folgt (Ersetzen Sie "musterstadt" durch den Schul-Shortname):
31 +Bearbeiten Sie die Datei wie folgt (Ersetzen Sie "musterstadt" durch den Schul-Shortname=):
56 56  
57 57  {{code language="bash"}}
58 58  ## Externe dynamische IP intern auflösen
59 59  zone "musterstadt.logoip.de" {
60 60    type master;
61 -  file "/etc/bind/db.dynip";
37 +  file "/etc/bind/db.logoip";
62 62    check-names ignore;
63 63  };
64 64  {{/code}}
65 65  
66 66  
67 -(% style="color:#000000" %)Öffnen Sie die referenzierte Datei {{box}}db.dynip{{/box}} im logosrv:
43 +Öffnen Sie die Datei "db.dynip" im logosrv:
68 68  
69 69  {{code language="bash"}}
70 70  root@logosrv:~ # vim /etc/bind/db.dynip
... ... @@ -71,7 +71,7 @@
71 71  {{/code}}
72 72  
73 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":
50 +Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
75 75  
76 76  {{code language="bash"}}
77 77  $TTL 1h
... ... @@ -86,69 +86,7 @@
86 86                   NS      ns1.schule.local.
87 87                   NS      ns2.schule.local.
88 88  
89 -@                A       172.28.28.27
90 -*                A       172.28.28.27
65 +                 A       10.16.1.1
66 +*                A       10.16.1.1
91 91  {{/code}}
92 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 -
154 -