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

Zusammenfassung

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

Details

Seiteneigenschaften

Inhalt

...	...	@@ -1,26 +1,47 @@
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 der Webzugriff von Kopano über ein Zertifikat abgesichert ist, muss dieses erst auf dem LogoDIDACT-Server generiert werden. Dies ist insbesondere auch für die Nutzung von Z-Push (ActiveSync-Protokoll) von besonderer Relevanz.
	2	+In diesem Artikel erfahren Sie, welche für Voraussetzungen es gibt und wie ein signiertes Let's Encrypt Zertifikat generiert werden kann.
2	2
3	3
4		-==== (% style="color:#000000" %)__**Vorrausetzungen**__(%%) ====
	5	+===== (% style="color:#000000" %)__Voraussetzungen__(%%) =====
5	5
	7	+(% style="color:#000000" %)Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom vorgeschalteten Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
6	6
7		-===== (% style="color:#000000" %)__Portweiterleitung__(%%) =====
8		-
9		-(% style="color:#000000" %)Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
10		-
11	11	{{code language="bash"}}
12	12	WAN (Internet) TCP-Port 80 -> auf externe IP-Adresse des logoDIDACT-Servers [http]
13	13	WAN (Internet) TCP-Port 443 -> auf externe IP-Adresse des logoDIDACT-Servers [https]
14	14	{{/code}}
15	15
	14	+==== ====
16	16
17		-===== (% style="color:#000000" %)__Split-DNS__(%%) =====
	16	+===== =====
18	18
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.
	18	+===== =====
20	20
	20	+===== __Freigabe von Kopano über rev-proxy__ =====
21	21
22		-(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch:
	22	+(% 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.
23	23
	24	+{{code language="bash"}}
	25	+[ReverseProxy kopano.ShortName.logoip.de]
	26	+Url https://kopano
	27	+Template kopano
	28	+{{/code}}
	29	+
	30	+(% style="color:#000000" %) Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:
	31	+
	32	+{{code language="bash"}}
	33	+cd /etc/logodidact/
	34	+git add .
	35	+git commit -a -m "Kopano über rev-proxy freigegeben."
	36	+{{/code}}
	37	+
	38	+
	39	+===== (% style="color:#000000" %)__Split-DNS__(%%) =====
	40	+
	41	+(% 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.
	42	+
	43	+(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch, falls noch nicht erfolgt.
	44	+
24	24	(% style="color:#000000" %)Öffnen Sie die Datei "named.conf.local" im logosrv:
25	25
26	26	{{code language="bash"}}
...	...	@@ -40,7 +40,7 @@
40	40	{{/code}}
41	41
42	42
43		-(% style="color:#000000" %)Öffnen Sie die Datei "db.dynip" im logosrv:
	64	+(% style="color:#000000" %)Öffnen Sie die referenzierte Datei {{box}}db.dynip{{/box}} im logosrv:
44	44
45	45	{{code language="bash"}}
46	46	root@logosrv:~ # vim /etc/bind/db.dynip
...	...	@@ -47,7 +47,7 @@
47	47	{{/code}}
48	48
49	49
50		-(% style="color:#000000" %)Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
	71	+(% 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":
51	51
52	52	{{code language="bash"}}
53	53	$TTL 1h
...	...	@@ -62,7 +62,7 @@
62	62	NS      ns1.schule.local.
63	63	NS      ns2.schule.local.
64	64
65		-                 A       172.28.28.27
	86	+@                A       172.28.28.27
66	66	*                A       172.28.28.27
67	67	{{/code}}
68	68
...	...	@@ -76,7 +76,7 @@
76	76
77	77	==== (% style="color:#000000" %)**__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__**(%%) ====
78	78
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:
	100	+(% 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:
80	80
81	81
82	82	===== (% style="color:#000000" %)__acmetool__(%%) =====
...	...	@@ -104,7 +104,7 @@
104	104	{{/code}}
105	105
106	106
107		-(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
	128	+(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung des Benutzers le-acme zur Verwaltung der Let's Encrypt Zertifikate:
108	108
109	109	{{code language="bash"}}
110	110	root@puppeteer:~ # sle
...	...	@@ -111,7 +111,7 @@
111	111	{{/code}}
112	112
113	113
114		-(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
	135	+(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
115	115
116	116	{{code language="bash"}}
117	117	le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
...	...	@@ -118,7 +118,7 @@
118	118	{{/code}}
119	119
120	120
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:
	142	+(% 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:
122	122
123	123	{{code language="bash"}}
124	124	root@puppeteer:~ # prun