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

Version 5.1 von Jens Gruber am 2022/05/02 12:00

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
	16
5.1	17	===== (% style="color:#000000" %)__Split-DNS__(%%) =====
1.1	18
5.1	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.
1.1	20
	21
5.1	22	(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch:
1.1	23
5.1	24	(% style="color:#000000" %)Öffnen Sie die Datei "named.conf.local" im logosrv:
1.2	25
	26	{{code language="bash"}}
	27	root@logosrv:~ # vim /etc/bind/named.conf.local
	28	{{/code}}
	29
	30
5.1	31	(% style="color:#000000" %)Bearbeiten Sie die Datei wie folgt (Ersetzen Sie "musterstadt" durch den Schul-Shortname):
1.2	32
	33	{{code language="bash"}}
	34	## Externe dynamische IP intern auflösen
	35	zone "musterstadt.logoip.de" {
	36	type master;
2.1	37	file "/etc/bind/db.dynip";
1.2	38	check-names ignore;
	39	};
	40	{{/code}}
	41
	42
5.1	43	(% style="color:#000000" %)Öffnen Sie die Datei "db.dynip" im logosrv:
1.2	44
	45	{{code language="bash"}}
	46	root@logosrv:~ # vim /etc/bind/db.dynip
	47	{{/code}}
	48
	49
5.1	50	(% style="color:#000000" %)Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
1.2	51
	52	{{code language="bash"}}
	53	$TTL 1h
	54	@ IN SOA ns1.schule.local. postmaster.schule.local. (
	55	2009010101 ; serial
	56	86400 ; refresh (1 day)
	57	900 ; retry (15 minutes)
	58	604800 ; expire (1 week)
	59	900 ; minimum (15 minutes)
	60	)
	61
	62	NS ns1.schule.local.
	63	NS ns2.schule.local.
	64
2.1	65	A 172.28.28.27
	66	* A 172.28.28.27
1.2	67	{{/code}}
	68
2.1	69
5.1	70	(% style="color:#000000" %)Starten Sie nach den Anpassungen den DNS-Server im logosrv neu:
2.1	71
	72	{{code language="bash"}}
	73	root@logosrv:~ # /etc/init.d/bind9 restart
	74	{{/code}}
	75
	76
5.1	77	==== (% style="color:#000000" %)__Zertifikat über acmetool & acme.sh anfordern__(%%) ====
2.1	78
5.1	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:
2.1	80
	81
5.1	82	===== (% style="color:#000000" %)__acmetool__(%%) =====
2.1	83
5.1	84	(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
2.1	85
	86	{{code language="bash"}}
	87	root@ldhost:~ # lxc-ssh -n puppeteer
	88	{{/code}}
	89
	90
5.1	91	(% style="color:#000000" %)Fordern Sie das Zertifikat mit folgendem Befehl an (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
2.1	92
	93	{{code language="bash"}}
	94	root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
	95	{{/code}}
	96
	97
5.1	98	===== (% style="color:#000000" %)__acme.sh__(%%) =====
2.1	99
5.1	100	(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
2.1	101
	102	{{code language="bash"}}
	103	root@ldhost:~ # lxc-ssh -n puppeteer
	104	{{/code}}
	105
	106
5.1	107	(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
2.1	108
	109	{{code language="bash"}}
	110	root@puppeteer:~ # sle
	111	{{/code}}
	112
	113
5.1	114	(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
2.1	115
	116	{{code language="bash"}}
	117	le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
	118	{{/code}}
	119
	120
5.1	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:
2.1	122
	123	{{code language="bash"}}
	124	root@puppeteer:~ # prun
	125	root@rev-proxy:~ # prun
	126	{{/code}}
	127
	128