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

Zuletzt geändert von Jens Gruber am 2022/05/25 09:01

Von 1.2 nach 1.1 Von 11.1 nach 10.1

Von Version 10.1

bearbeitet von Jonas Mayer
am 2022/05/09 13:43

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 1.2

bearbeitet von Jens Gruber
am 2022/05/02 10:02

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

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

Details

Seiteneigenschaften

Dokument-Autor

@@ -1,1 +1,1 @@
--XWiki.jonasmayer@sbede
++XWiki.JensGruber@sbede

Inhalt

@@ -1,66 +1,46 @@
--(% 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 Voraussetzungen es gibt und über welche Wege ein Zertifikat generiert werden kann.
++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.
--===== (% style="color:#000000" %)__Voraussetzungen__(%%) =====
++==== __**Vorrausetzungen**__ ====
--(% style="color:#000000" %)Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom vorgeschalteten Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
++===== __Portweiterleitung__ =====
++
++Damit ein Zertifikat generiert werden kann, müssen folgende Ports vom Router (WAN) an den logoDIDACT-Server weitergeleitet werden:
++
  {{code language="bash"}}
  WAN (Internet) TCP-Port 80 -> auf externe IP-Adresse des logoDIDACT-Servers [http]
  WAN (Internet) TCP-Port 443 -> auf externe IP-Adresse des logoDIDACT-Servers [https]
  {{/code}}
--====  ====
--=====  =====
++===== __Split-DNS__ =====
--=====  =====
++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.
--===== __Freigabe von Kopano über rev-proxy__ =====
--(% 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.
++Führen Sie folgende Schritte für die Einrichtung durch:
--{{code language="bash"}}
--[ReverseProxy kopano.ShortName.logoip.de]
--Url  https://kopano
--Template kopano
--{{/code}}
++Öffnen Sie die Datei "named.conf.local" im logosrv:
--(% style="color:#000000" %) Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:
--
  {{code language="bash"}}
--cd /etc/logodidact/
--git add .
--git commit -a -m "Kopano über rev-proxy freigegeben."
--{{/code}}
--
--
--===== (% style="color:#000000" %)__Split-DNS__(%%) =====
--
--(% 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.
--
--(% style="color:#000000" %)Führen Sie folgende Schritte für die Einrichtung durch, falls noch nicht erfolgt.
--
--(% style="color:#000000" %)Öffnen Sie die Datei "named.conf.local" im logosrv:
--
--{{code language="bash"}}
  root@logosrv:~ # vim /etc/bind/named.conf.local
  {{/code}}
--(% style="color:#000000" %)Bearbeiten Sie die Datei wie folgt (Ersetzen Sie "musterstadt" durch den Schul-Shortname):
++Bearbeiten Sie die Datei wie folgt (Ersetzen Sie "musterstadt" durch den Schul-Shortname=):
  {{code language="bash"}}
  ## Externe dynamische IP intern auflösen
  zone "musterstadt.logoip.de" {
    type master;
--  file "/etc/bind/db.dynip";
++  file "/etc/bind/db.logoip";
    check-names ignore;
  };
  {{/code}}
--(% style="color:#000000" %)Öffnen Sie die Datei "db.dynip" im logosrv:
++Öffnen Sie die Datei "db.dynip" im logosrv:
  {{code language="bash"}}
  root@logosrv:~ # vim /etc/bind/db.dynip
@@ -67,7 +67,7 @@
  {{/code}}
--(% style="color:#000000" %)Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
++Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
  {{code language="bash"}}
  $TTL 1h
@@ -82,67 +82,7 @@
                   NS      ns1.schule.local.
                   NS      ns2.schule.local.
--                 A       172.28.28.27
--*                A       172.28.28.27
++                 A       10.16.1.1
++*                A       10.16.1.1
  {{/code}}
--
--(% style="color:#000000" %)Starten Sie nach den Anpassungen den DNS-Server im logosrv neu:
--
--{{code language="bash"}}
--root@logosrv:~ # /etc/init.d/bind9 restart
--{{/code}}
--
--
--==== (% style="color:#000000" %)**__SSL-Zertifikat über Tool acmetool oder acme.sh anfordern__**(%%) ====
--
--(% 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:
--
--
--===== (% style="color:#000000" %)__acmetool__(%%) =====
--
--(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
--
--{{code language="bash"}}
--root@ldhost:~ # lxc-ssh -n puppeteer
--{{/code}}
--
--
--(% style="color:#000000" %)Fordern Sie das Zertifikat mit folgendem Befehl an (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
--
--{{code language="bash"}}
--root@puppeteer:~ # acmetool want kopano.SCHULKUERZEL.logoip.de
--{{/code}}
--
--
--===== (% style="color:#000000" %)__acme.sh__(%%) =====
--
--(% style="color:#000000" %)Wechseln Sie in den puppeteer Container:
--
--{{code language="bash"}}
--root@ldhost:~ # lxc-ssh -n puppeteer
--{{/code}}
--
--
--(% style="color:#000000" %)Wechseln Sie im puppeteer Container in die Umgebung für das Verwalten der Zertifikate:
--
--{{code language="bash"}}
--root@puppeteer:~ # sle
--{{/code}}
--
--
--(% style="color:#000000" %)Beantragen Sie ein neues Zertifikat mit folgendem Befehl (Ersetzen Sie "SCHULKUERZEL" mit dem jeweiligen Shortname):
--
--{{code language="bash"}}
--le-acme@puppeteer:~ $ issue kopano.SCHULKUERZEL.logoip.de
--{{/code}}
--
--
--(% style="color:#000000" %)Um das verteilen der Zertifikate zu beschleunigen können Sie ggf. einen prun im puppeteer und rev-proxy Container durchführen:
--
--{{code language="bash"}}
--root@puppeteer:~ # prun
--root@rev-proxy:~ # prun
--{{/code}}
--
--