Zum Inhalt springen
Zuletzt geändert von Jens Gruber am 2022/05/25 09:01
Von Version 1.1
bearbeitet von Jens Gruber
am 2022/05/02 09:53
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 8.1
bearbeitet von cge@sbede
am 2022/05/03 12:02
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -xwiki: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,12 +13,139 @@
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 zur Einrichtung durch:
25 +{{code language="bash"}}
26 +[ReverseProxy kopano.ShortName.logoip.de]
27 +Url https://kopano
28 +Template kopano
29 +{{/code}}
23 23  
31 +(% style="color:#000000" %) Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:
32 +
33 +{{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"}}
50 +root@logosrv:~ # vim /etc/bind/named.conf.local
51 +{{/code}}
52 +
53 +
54 +(% style="color:#000000" %)Bearbeiten Sie die Datei wie folgt (Ersetzen Sie "musterstadt" durch den Schul-Shortname):
55 +
56 +{{code language="bash"}}
57 +## Externe dynamische IP intern auflösen
58 +zone "musterstadt.logoip.de" {
59 +  type master;
60 +  file "/etc/bind/db.dynip";
61 +  check-names ignore;
62 +};
63 +{{/code}}
64 +
65 +
66 +(% style="color:#000000" %)Öffnen Sie die Datei "db.dynip" im logosrv:
67 +
68 +{{code language="bash"}}
69 +root@logosrv:~ # vim /etc/bind/db.dynip
70 +{{/code}}
71 +
72 +
73 +(% style="color:#000000" %)Passen Sie gegebenenfalls die IP des Rev-Proxy Containers an. Im Standard ist diese die "172.28.28.27":
74 +
75 +{{code language="bash"}}
76 +$TTL 1h
77 +@                IN     SOA   ns1.schule.local. postmaster.schule.local. (
78 +                                2009010101 ; serial
79 +                                86400      ; refresh (1 day)
80 +                                900        ; retry (15 minutes)
81 +                                604800     ; expire (1 week)
82 +                                900        ; minimum (15 minutes)
83 +                                )
84 +
85 +                 NS      ns1.schule.local.
86 +                 NS      ns2.schule.local.
87 +
88 +                 A       172.28.28.27
89 +*                A       172.28.28.27
90 +{{/code}}
91 +
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 +
24 24