Ä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.cge@sbede
	1	+XWiki.JensGruber@sbede

Inhalt

...	...	@@ -1,12 +1,14 @@
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.
	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		-==== (% style="color:#000000" %)__**Vorrausetzungen**__(%%) ====
5	5
	7	+----
6	6
7		-===== (% style="color:#000000" %)__Portweiterleitung__(%%) =====
	9	+==== (% style="color:#000000" %)__Voraussetzungen__(%%) ====
8	8
9		-(% style="color:#000000" %)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]
...	...	@@ -13,15 +13,18 @@
13	13	WAN (Internet) TCP-Port 443 -> auf externe IP-Adresse des logoDIDACT-Servers [https]
14	14	{{/code}}
15	15
16		-==== ====
17	17
18	18	===== __Freigabe von Kopano über rev-proxy__ =====
19	19
20		-(% style="color:#000000" %)Erweitern Sie die ##{{code}}/etc/logodidact/hosts/rev-proxy/revproxy.conf{{/code}}## im Puppeteer-LXC um folgende Zeilen, um Kopano über den rev-proxy freizugeben, falls dies noch nicht erfolgt ist.
21	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	+
22	22	{{code language="bash"}}
23	23	[ReverseProxy kopano.ShortName.logoip.de]
24		-Url https://kopano
	29	+Url https://kopano
25	25	Template kopano
26	26	{{/code}}
27	27
...	...	@@ -36,11 +36,10 @@
36	36
37	37	===== (% style="color:#000000" %)__Split-DNS__(%%) =====
38	38
39		-(% 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.
	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.
40	40
	46	+(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch, falls noch nicht erfolgt.
41	41
42		-(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch:
43		-
44	44	(% style="color:#000000" %)Öffnen Sie die Datei "named.conf.local" im logosrv:
45	45
46	46	{{code language="bash"}}
...	...	@@ -60,7 +60,7 @@
60	60	{{/code}}
61	61
62	62
63		-(% style="color:#000000" %)Öffnen Sie die Datei "db.dynip" im logosrv:
	67	+(% style="color:#000000" %)Öffnen Sie die referenzierte Datei {{box}}db.dynip{{/box}} im logosrv:
64	64
65	65	{{code language="bash"}}
66	66	root@logosrv:~ # vim /etc/bind/db.dynip
...	...	@@ -67,7 +67,7 @@
67	67	{{/code}}
68	68
69	69
70		-(% style="color:#000000" %)Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
	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":
71	71
72	72	{{code language="bash"}}
73	73	$TTL 1h
...	...	@@ -82,7 +82,7 @@
82	82	NS      ns1.schule.local.
83	83	NS      ns2.schule.local.
84	84
85		-                 A       172.28.28.27
	89	+@                A       172.28.28.27
86	86	*                A       172.28.28.27
87	87	{{/code}}
88	88
...	...	@@ -94,11 +94,13 @@
94	94	{{/code}}
95	95
96	96
97		-==== (% style="color:#000000" %)**__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__**(%%) ====
	101	+----
98	98
99		-(% 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:
	103	+==== (% style="color:#000000" %)__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__(%%) ====
100	100
	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:
101	101
	107	+
102	102	===== (% style="color:#000000" %)__acmetool__(%%) =====
103	103
104	104	(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
...	...	@@ -124,7 +124,7 @@
124	124	{{/code}}
125	125
126	126
127		-(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
	133	+(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung des Benutzers le-acme zur Verwaltung der Let's Encrypt Zertifikate:
128	128
129	129	{{code language="bash"}}
130	130	root@puppeteer:~ # sle
...	...	@@ -131,7 +131,7 @@
131	131	{{/code}}
132	132
133	133
134		-(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
	140	+(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
135	135
136	136	{{code language="bash"}}
137	137	le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
...	...	@@ -138,7 +138,7 @@
138	138	{{/code}}
139	139
140	140
141		-(% style="color:#000000" %)Um das verteilen der Zertifikate zu beschleunigen können Sie ggf. einen prun im puppeteer und rev-proxy Container durchführen:
	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:
142	142
143	143	{{code language="bash"}}
144	144	root@puppeteer:~ # prun