Ä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.cge@sbede

Inhalt

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