Ä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,55 +1,34 @@
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	+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.
2	2
3	3
4		-===== (% style="color:#000000" %)__Voraussetzungen__(%%) =====
	4	+==== __**Vorrausetzungen**__ ====
5	5
6		-(% style="color:#000000" %)Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom vorgeschalteten Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
7	7
	7	+===== __Portweiterleitung__ =====
	8	+
	9	+Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
	10	+
8	8	{{code language="bash"}}
9	9	WAN (Internet) TCP-Port 80 -> auf externe IP-Adresse des logoDIDACT-Servers [http]
10	10	WAN (Internet) TCP-Port 443 -> auf externe IP-Adresse des logoDIDACT-Servers [https]
11	11	{{/code}}
12	12
13		-==== ====
14	14
15		-===== =====
	17	+===== __Split-DNS__ =====
16	16
17		-(% class="wikigeneratedid" %)
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.
19	19
20		-===== __Freigabe von Kopano über rev-proxy__ =====
21	21
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.
	22	+Führen Sie folgende Schritte für die Einrichtung durch:
23	23
24		-{{code language="bash"}}
25		-[ReverseProxy kopano.ShortName.logoip.de]
26		-Url https://kopano
27		-Template kopano
28		-{{/code}}
	24	+Öffnen Sie die Datei "named.conf.local" im logosrv:
29	29
30		-(% style="color:#000000" %) Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:
31		-
32	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		-
45		-(% style="color:#000000" %)Öffnen Sie die Datei "named.conf.local" im logosrv:
46		-
47		-{{code language="bash"}}
48	48	root@logosrv:~ # vim /etc/bind/named.conf.local
49	49	{{/code}}
50	50
51	51
52		-(% 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):
53	53
54	54	{{code language="bash"}}
55	55	## Externe dynamische IP intern auflösen
...	...	@@ -61,7 +61,7 @@
61	61	{{/code}}
62	62
63	63
64		-(% style="color:#000000" %)Öffnen Sie die Datei "db.dynip" im logosrv:
	43	+Öffnen Sie die Datei "db.dynip" im logosrv:
65	65
66	66	{{code language="bash"}}
67	67	root@logosrv:~ # vim /etc/bind/db.dynip
...	...	@@ -68,7 +68,7 @@
68	68	{{/code}}
69	69
70	70
71		-(% style="color:#000000" %)Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
	50	+Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
72	72
73	73	{{code language="bash"}}
74	74	$TTL 1h
...	...	@@ -88,7 +88,7 @@
88	88	{{/code}}
89	89
90	90
91		-(% style="color:#000000" %)Starten Sie nach den Anpassungen den DNS-Server im logosrv neu:
	70	+Starten Sie nach den Anpassungen den DNS-Server im logosrv neu:
92	92
93	93	{{code language="bash"}}
94	94	root@logosrv:~ # /etc/init.d/bind9 restart
...	...	@@ -95,14 +95,14 @@
95	95	{{/code}}
96	96
97	97
98		-==== (% style="color:#000000" %)**__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__**(%%) ====
	77	+==== **__Zertifikat über acmetool & acme.sh anfordern__** ====
99	99
100		-(% 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:
	79	+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:
101	101
102	102
103		-===== (% style="color:#000000" %)__acmetool__(%%) =====
	82	+===== __acmetool__ =====
104	104
105		-(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
	84	+Wechseln Sie in den puppeteer Container:
106	106
107	107	{{code language="bash"}}
108	108	root@ldhost:~ # lxc-ssh -n puppeteer
...	...	@@ -109,7 +109,7 @@
109	109	{{/code}}
110	110
111	111
112		-(% style="color:#000000" %)Fordern Sie das Zertifikat mit folgendem Befehl an (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
	91	+Fordern Sie das Zertifikat mit folgendem Befehl an (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
113	113
114	114	{{code language="bash"}}
115	115	root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
...	...	@@ -116,9 +116,9 @@
116	116	{{/code}}
117	117
118	118
119		-===== (% style="color:#000000" %)__acme.sh__(%%) =====
	98	+===== __acme.sh__ =====
120	120
121		-(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
	100	+Wechseln Sie in den puppeteer Container:
122	122
123	123	{{code language="bash"}}
124	124	root@ldhost:~ # lxc-ssh -n puppeteer
...	...	@@ -125,7 +125,7 @@
125	125	{{/code}}
126	126
127	127
128		-(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
	107	+Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
129	129
130	130	{{code language="bash"}}
131	131	root@puppeteer:~ # sle
...	...	@@ -132,7 +132,7 @@
132	132	{{/code}}
133	133
134	134
135		-(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
	114	+Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
136	136
137	137	{{code language="bash"}}
138	138	le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
...	...	@@ -139,7 +139,7 @@
139	139	{{/code}}
140	140
141	141
142		-(% style="color:#000000" %)Um das verteilen der Zertifikate zu beschleunigen können Sie ggf. einen prun im puppeteer und rev-proxy Container durchführen:
	121	+Um das verteilen der Zertifikate zu beschleunigen können Sie ggf. einen prun im puppeteer und rev-proxy Container durchführen:
143	143
144	144	{{code language="bash"}}
145	145	root@puppeteer:~ # prun