Wiki-Quellcode von Let’s Encrypt SSL-Zertifikat für Kopano beantragen

Version 7.1 von cge@sbede am 2022/05/03 12:01

version	line-number	content
5.1	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.1	2
	3
5.1	4	==== (% style="color:#000000" %)__Vorrausetzungen__(%%) ====
1.1	5
	6
5.1	7	===== (% style="color:#000000" %)__Portweiterleitung__(%%) =====
1.1	8
5.1	9	(% style="color:#000000" %)Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
1.1	10
	11	{{code language="bash"}}
	12	WAN (Internet) TCP-Port 80 -> auf externe IP-Adresse des logoDIDACT-Servers [http]
	13	WAN (Internet) TCP-Port 443 -> auf externe IP-Adresse des logoDIDACT-Servers [https]
	14	{{/code}}
	15
7.1	16	==== ====
1.1	17
7.1	18	===== __Freigabe von Kopano über rev-proxy__ =====
	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
	22	{{code language="bash"}}
	23	[ReverseProxy kopano.ShortName.logoip.de]
	24	Url https://kopano
	25	Template kopano
	26	{{/code}}
	27
	28	(% style="color:#000000" %) Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:
	29
	30	{{code language="bash"}}
	31	cd /etc/logodidact/
	32	git add .
	33	git commit -a -m "Kopano über rev-proxy freigegeben."
	34	{{/code}}
	35
	36
5.1	37	===== (% style="color:#000000" %)__Split-DNS__(%%) =====
1.1	38
5.1	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.
1.1	40
	41
5.1	42	(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch:
1.1	43
5.1	44	(% style="color:#000000" %)Öffnen Sie die Datei "named.conf.local" im logosrv:
1.2	45
	46	{{code language="bash"}}
	47	root@logosrv:~ # vim /etc/bind/named.conf.local
	48	{{/code}}
	49
	50
5.1	51	(% style="color:#000000" %)Bearbeiten Sie die Datei wie folgt (Ersetzen Sie "musterstadt" durch den Schul-Shortname):
1.2	52
	53	{{code language="bash"}}
	54	## Externe dynamische IP intern auflösen
	55	zone "musterstadt.logoip.de" {
	56	type master;
2.1	57	file "/etc/bind/db.dynip";
1.2	58	check-names ignore;
	59	};
	60	{{/code}}
	61
	62
5.1	63	(% style="color:#000000" %)Öffnen Sie die Datei "db.dynip" im logosrv:
1.2	64
	65	{{code language="bash"}}
	66	root@logosrv:~ # vim /etc/bind/db.dynip
	67	{{/code}}
	68
	69
5.1	70	(% style="color:#000000" %)Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
1.2	71
	72	{{code language="bash"}}
	73	$TTL 1h
	74	@ IN SOA ns1.schule.local. postmaster.schule.local. (
	75	2009010101 ; serial
	76	86400 ; refresh (1 day)
	77	900 ; retry (15 minutes)
	78	604800 ; expire (1 week)
	79	900 ; minimum (15 minutes)
	80	)
	81
	82	NS ns1.schule.local.
	83	NS ns2.schule.local.
	84
2.1	85	A 172.28.28.27
	86	* A 172.28.28.27
1.2	87	{{/code}}
	88
2.1	89
5.1	90	(% style="color:#000000" %)Starten Sie nach den Anpassungen den DNS-Server im logosrv neu:
2.1	91
	92	{{code language="bash"}}
	93	root@logosrv:~ # /etc/init.d/bind9 restart
	94	{{/code}}
	95
	96
6.1	97	==== (% style="color:#000000" %)__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__(%%) ====
2.1	98
5.1	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:
2.1	100
	101
5.1	102	===== (% style="color:#000000" %)__acmetool__(%%) =====
2.1	103
5.1	104	(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
2.1	105
	106	{{code language="bash"}}
	107	root@ldhost:~ # lxc-ssh -n puppeteer
	108	{{/code}}
	109
	110
5.1	111	(% style="color:#000000" %)Fordern Sie das Zertifikat mit folgendem Befehl an (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
2.1	112
	113	{{code language="bash"}}
	114	root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
	115	{{/code}}
	116
	117
5.1	118	===== (% style="color:#000000" %)__acme.sh__(%%) =====
2.1	119
5.1	120	(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
2.1	121
	122	{{code language="bash"}}
	123	root@ldhost:~ # lxc-ssh -n puppeteer
	124	{{/code}}
	125
	126
5.1	127	(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
2.1	128
	129	{{code language="bash"}}
	130	root@puppeteer:~ # sle
	131	{{/code}}
	132
	133
5.1	134	(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
2.1	135
	136	{{code language="bash"}}
	137	le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
	138	{{/code}}
	139
	140
5.1	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:
2.1	142
	143	{{code language="bash"}}
	144	root@puppeteer:~ # prun
	145	root@rev-proxy:~ # prun
	146	{{/code}}
	147
	148