Änderungen von Dokument Let’s Encrypt SSL-Zertifikat für Kopano beantragen

Zusammenfassung

• Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Dokument-Autor

...	...	@@ -1,1 +1,1 @@
1		-XWiki.JensGruber@sbede
	1	+XWiki.jonasmayer@sbede

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	+(% style="color:#000000" %)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	+==== (% style="color:#000000" %)__**Vorrausetzungen**__(%%) ====
6	6
7		-----
8	8
9		-==== (% style="color:#000000" %)__Voraussetzungen__(%%) ====
	7	+===== (% style="color:#000000" %)__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	+(% style="color:#000000" %)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,35 +16,13 @@
16	16	{{/code}}
17	17
18	18
19		-===== __Freigabe von Kopano über rev-proxy__ =====
20		-
21		-
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.
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.
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	42	===== (% style="color:#000000" %)__Split-DNS__(%%) =====
43	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.
	19	+(% style="color:#000000" %)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.
45	45
46		-(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch, falls noch nicht erfolgt.
47	47
	22	+(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch:
	23	+
48	48	(% style="color:#000000" %)Öffnen Sie die Datei "named.conf.local" im logosrv:
49	49
50	50	{{code language="bash"}}
...	...	@@ -64,7 +64,7 @@
64	64	{{/code}}
65	65
66	66
67		-(% style="color:#000000" %)Öffnen Sie die referenzierte Datei {{box}}db.dynip{{/box}} im logosrv:
	43	+(% style="color:#000000" %)Ö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	+(% style="color:#000000" %)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,7 +86,7 @@
86	86	NS      ns1.schule.local.
87	87	NS      ns2.schule.local.
88	88
89		-@                A       172.28.28.27
	65	+                 A       172.28.28.27
90	90	*                A       172.28.28.27
91	91	{{/code}}
92	92
...	...	@@ -98,13 +98,11 @@
98	98	{{/code}}
99	99
100	100
101		-----
	77	+==== (% style="color:#000000" %)**__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__**(%%) ====
102	102
103		-==== (% style="color:#000000" %)__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__(%%) ====
	79	+(% style="color:#000000" %)Nach Schaffung der technischen Vorrausetzungen können Sie das Let's Encrypt-Zertifikat anfordern. Je nach verwendeter Software/Serverstand können Sie die folgenden 2 Wege nutzen:
104	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	106
107		-
108	108	===== (% style="color:#000000" %)__acmetool__(%%) =====
109	109
110	110	(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
...	...	@@ -130,7 +130,7 @@
130	130	{{/code}}
131	131
132	132
133		-(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung des Benutzers le-acme zur Verwaltung der Let's Encrypt Zertifikate:
	107	+(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
134	134
135	135	{{code language="bash"}}
136	136	root@puppeteer:~ # sle
...	...	@@ -137,7 +137,7 @@
137	137	{{/code}}
138	138
139	139
140		-(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
	114	+(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
141	141
142	142	{{code language="bash"}}
143	143	le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
...	...	@@ -144,7 +144,7 @@
144	144	{{/code}}
145	145
146	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:
	121	+(% style="color:#000000" %)Um das verteilen der Zertifikate zu beschleunigen können Sie ggf. einen prun im puppeteer und rev-proxy Container durchführen:
148	148
149	149	{{code language="bash"}}
150	150	root@puppeteer:~ # prun