In der Regel werden in pd-admin nur Lets Encrypt Zertifikate für Domains und Sub-Domains der Endkunden ausgestellt. Administratoren können jedoch auch ein Lets Encrypt Zertifikat für den Hostnamen ausstellen lassen. Das Zertifikat kann dann für die Mail-Dienste, Dovecot und qmail, verwenden werden. Dazu gehen Sie wie folgt vor:
Lets Encrypt Zertifikat für Hostname ausstellen
Im ersten Schritt kommt die Einrichtung eines Lets Encrypt Zertifikats für den Hostnamen. Hierfür führen Sie folgende Befehle aus:
$ /opt/pdadmin/bin/letsencrypt server.example.net$ /opt/pdadmin/bin/httpd_vhosts.pl
Bitte server.example.net durch den eigene Hostnamen ersetzen. Damit sind unter Anderem die pd-admin Login Seiten nun per HTTPS erreichbar.
Zertifikat bei Mail-Diensten einrichten
Für die Einrichtung eines SSL-Zertifikats bei (u.a.) den Mail-Diensten, wird von den pd-admin Entwicklern ein entsprechendes Installationsskript zur Verfügung gestellt. Dieses können Sie unter herunter laden.
$ wget http://download.pd-admin.de/dc-ssl-install.sh$ ./dc-ssl-install.sh
Nach Ausführung ist das Lets Encrypt Zertifikat bei den Mail-Diensten eingerichtet. Das Skript richtet das SSL-Zertifikat aber auch für den FTP-Dienst proFTPD ein.
Anpassung der Apache Templates
Der certbot hinterlegt die Datei zur Validierung unter /usr/local/pd-admin2/htdocs/.well-known/acme-challenge. Nachd Einrichtung des SSL-Zertifikat für den Hostnamen, werden sämtliche Anfragen auf HTTPS weiter geleitet. Dies macht soweit Sinn. Allerdings kann der certbot die Validierungsdatei nicht per HTTPS abrufen. Es käme somit zu einem Fehler bei Verlängerung des Zertifikats. Die Apache Templates müssen dazu angepasst werden. Je nachdem welche Apache Version verwendet wird, finden Sie die Templates hier:
Apache 2.2:/usr/local/pd-admin2/conf/httpd.conf-template
Apache 2.4: /usr/local/pd-admin2/httpd-2.4/conf/httpd24.conf-template
Sie ersetzen dort einfach die Zeile
## REDIRECT_TO_HTTPS ##
durch
RedirectMatch ^(?!/\.well-known/acme-challenge).* https://$$SERVERNAME$0
Es werden weiterhin sämtliche Anfragen auf HTTPS weitergeleitet. Mit Ausnahme von Anfragen auf /.well-known/acme-challenge. Der Apache ist für die Verlängerung des Hostname Zertifikats vorbereitet.
Cronjob einrichten
Standardmäßig wird für die Verlängerung der Lets Encrypt Zertifikate einmal pro Woche der certbot ausgeführt. Dies könnte im crontab etwa so aussehen:
00 3 * * 2 /opt/pdadmin/bin/certbot-auto renew
Damit nun SSL-Zertifikate verlängert und direkt bei den Mail-Diensten eingerichtet werden, wird dies mittels eines einfach Shell Skripts durchgeführt. Dies kann z.B. unter /root/certbot-renew.sh hinterlegt werden.
#!/bin/bash
H=/opt/pdadmin/bin/hostname.pl``
set -x
/opt/pdadmin/bin/certbot-auto renew
cat /opt/pdadmin/sslcerts/$H-key /opt/pdadmin/sslcerts/$H-cert /opt/pdadmin/sslcerts/$H-cacert > /var/qmail/control/servercert.pemcat /opt/pdadmin/sslcerts/$H-key /opt/pdadmin/sslcerts/$H-cert > /usr/local/pd-admin2/share/imapd.pemcat /opt/pdadmin/sslcerts/$H-cacert > /usr/local/pd-admin2/share/imapd.cacertcat /opt/pdadmin/sslcerts/$H-cacert > /etc/ssl/cert.pem/usr/local/bin/svc -du /service/dovecot22//opt/pdadmin/bin/httpd_vhosts.pl
Das Skript ist im Grunde eine abgespeckte Version des dc-ssl-install.sh Skripts. Zum Schluss wird der Cronjob angelegt.
00 3 * * 2 /root/certbot-renew.sh
Durch das setzen von set -x im Skript werden ausgeführte Kommandos ausgegeben. Dies kann dann in eine Log Datei geschrieben werden.
00 3 * * 2 /root/certbot-renew.sh &>> /var/log/certbot-renew.log
Die Einrichtung eines Lets Encrypt Zertifikats für den Hostnamen, sowie den Mail-Diensten, Dovecot und qmail, ist abgeschlossen.