TLS-Zertifikat erneuern
Das TLS-Zertifikat (SSL) Ihres ISPICIO_E-Servers austauschen: prüfen, wo TLS terminiert wird, und das Zertifikat in Apache Tomcat erneuern.
Auf dieser Seite
Prüfen, wo TLS terminiert wird
- Tomcat terminiert TLS selbst: Die Datei
server.xmlenthält einen<Connector ... SSLEnabled="true">auf Port 443 oder 8443 mit Keystore-Einstellungen oder die Elemente<SSLHostConfig>und<Certificate>. Fahren Sie mit dem nächsten Abschnitt fort. - Vor Tomcat läuft ein Reverse Proxy (Apache HTTPD, Nginx, Load Balancer): Tauschen Sie das Zertifikat dort aus, nicht in Tomcat.
Zertifikat in Tomcat erneuern
Welcher Abschnitt gilt, hängt davon ab, wie Schlüssel und Zertifikat abgelegt sind. Die ersten beiden Abschnitte behandeln die Standardimplementierung (JSSE), der dritte APR/Native.
Die Befehle stehen für Linux und für Windows da. Unter Windows geben Sie sie in einer Eingabeaufforderung ein, die Sie als Administrator geöffnet haben. Die Beispiele gehen von diesen Werten aus; ersetzen Sie sie durch die Werte Ihrer Installation:
| Wert | Linux | Windows |
|---|---|---|
| Ordner der Tomcat-Installation | /path/to/tomcat |
C:\Program Files\Apache Software Foundation\Tomcat 11.0 |
| Name des Tomcat-Dienstes | tomcat |
Tomcat11 |
| HTTPS-Port des Connectors | 8443 |
8443 |
Schlüssel und Zertifikat liegen als PEM-Dateien vor
Das ist der Fall, wenn die Dateien von Let’s Encrypt oder von Ihrer Zertifizierungsstelle (CA) stammen.
-
Sichern Sie die Konfiguration und den bisherigen Keystore.
Linux:
sudo cp /path/to/tomcat/conf/server.xml /path/to/tomcat/conf/server.xml.bak sudo cp /path/to/keystore.* /path/to/keystore.bak 2>/dev/null || trueWindows (wechseln Sie zuerst in den Ordner
conf; die zweitecopy-Zeile brauchen Sie nur, wenn dort schon ein Keystore liegt):cd /d "C:\Program Files\Apache Software Foundation\Tomcat 11.0\conf" copy server.xml server.xml.bak copy tomcat.p12 tomcat.p12.bak -
Erzeugen Sie aus privatem Schlüssel, Zertifikat und Kette eine PKCS#12-Datei. Vergeben Sie bei der Abfrage ein Passwort. Sie tragen es im nächsten Schritt in
server.xmlein.Linux:
openssl pkcs12 -export \ -inkey privkey.pem \ -in cert.pem \ -certfile chain.pem \ -name tomcat \ -out /path/to/tomcat/conf/tomcat.p12Windows (im Ordner
conf; die drei PEM-Dateien liegen im Beispiel inC:\certs):openssl pkcs12 -export -inkey C:\certs\privkey.pem -in C:\certs\cert.pem -certfile C:\certs\chain.pem -name tomcat -out tomcat.p12 -
Bearbeiten Sie
server.xmlso, dass der Connector auf die neue Datei verweist. Unter Windows geben Sie den Pfad relativ zum Ordner der Tomcat-Installation an:conf/tomcat.p12.Moderne Syntax (bevorzugt):
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true"> <SSLHostConfig> <Certificate certificateKeystoreFile="/path/to/tomcat/conf/tomcat.p12" certificateKeystorePassword="YOUR_P12_PASSWORD" type="RSA" /> </SSLHostConfig> </Connector>Klassische Syntax:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true" keystoreFile="/path/to/tomcat/conf/tomcat.p12" keystoreType="PKCS12" keystorePass="YOUR_P12_PASSWORD" clientAuth="false" sslProtocol="TLS" /> -
Beschränken Sie den Zugriff auf die Datei.
Linux:
sudo chown tomcat:tomcat /path/to/tomcat/conf/tomcat.p12 sudo chmod 600 /path/to/tomcat/conf/tomcat.p12Windows: Öffnen Sie die Eigenschaften der Datei
tomcat.p12und lassen Sie auf dem Reiter Security nur Administratoren und das Konto zu, unter dem der Tomcat-Dienst läuft. Dieses Konto steht in der Dienstverwaltung (services.msc) in den Eigenschaften des Dienstes auf dem Reiter Log On. -
Starten Sie Tomcat neu.
Linux:
sudo systemctl restart tomcat # or: catalina.sh stop && catalina.sh startWindows:
net stop Tomcat11 net start Tomcat11 -
Prüfen Sie Gültigkeitsdaten und Aussteller des Zertifikats. Ersetzen Sie
your.domain.comund den Port durch Ihre Werte.Linux:
openssl s_client -connect your.domain.com:8443 -servername your.domain.com </dev/null \ | openssl x509 -noout -dates -issuer -subjectWindows:
openssl s_client -connect your.domain.com:8443 -servername your.domain.com < NUL | openssl x509 -noout -dates -issuer -subjectOhne OpenSSL öffnen Sie ISPICIO_E im Browser und sehen sich das Zertifikat dort an.
Der Schlüssel wurde in einem Java-Keystore erzeugt
Das ist der Fall, wenn Sie die Zertifikatsanforderung (CSR) mit keytool erstellt haben. Importieren Sie das neue Zertifikat in denselben Alias.
Die keytool-Befehle lauten unter Linux und Windows gleich. Unter Windows liegt keytool im Ordner bin der Java-Installation; den Pfad zum Keystore geben Sie in Windows-Schreibweise und in Anführungszeichen an, zum Beispiel "C:\Program Files\Apache Software Foundation\Tomcat 11.0\conf\keystore.jks".
-
Importieren Sie bei Bedarf zuerst die Zertifikate der Zwischenzertifizierungsstelle:
keytool -importcert -alias intermediate -file intermediate.crt -keystore /path/to/keystore.jks -
Importieren Sie das Serverzertifikat:
keytool -importcert -alias tomcat -file server.crt -keystore /path/to/keystore.jksDer Wert von
-aliasmuss dem Alias des ursprünglichen Schlüsselpaars entsprechen. Sie prüfen ihn mitkeytool -list -v -keystore /path/to/keystore.jks.Haben Sie statt einer CRT-Datei eine PKCS#12-Datei erhalten, importieren Sie sie stattdessen so:
keytool -importkeystore \ -srckeystore tomcat.p12 -srcstoretype PKCS12 \ -destkeystore keystore.jks -deststoretype JKS \ -srcalias tomcat -destalias tomcatIn der Windows-Eingabeaufforderung schreiben Sie diesen Befehl in eine Zeile, ohne die Zeichen
\am Zeilenende. -
Lassen Sie
server.xmlunverändert. Die Datei verweist weiter auf den Keystore, der jetzt das neue Zertifikat enthält. -
Starten Sie Tomcat neu und prüfen Sie die Verbindung wie in den Schritten 5 und 6 des vorigen Abschnitts.
APR/Native mit OpenSSL
Das ist der Fall, wenn der Connector in server.xml statt auf einen Keystore direkt auf die PEM-Dateien von Zertifikat, Schlüssel und Kette verweist. So sieht ein solcher Connector aus.
Moderne Syntax:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11AprProtocol" SSLEnabled="true">
<SSLHostConfig>
<Certificate certificateFile="/path/to/cert.pem"
certificateKeyFile="/path/to/privkey.pem"
certificateChainFile="/path/to/chain.pem"
type="RSA" />
</SSLHostConfig>
</Connector>
Klassische Syntax:
<Connector port="8443" protocol="org.apache.coyote.http11.Http11AprProtocol"
SSLEnabled="true" scheme="https" secure="true"
SSLCertificateFile="/path/to/cert.pem"
SSLCertificateKeyFile="/path/to/privkey.pem"
SSLCertificateChainFile="/path/to/chain.pem" />
-
Sichern Sie
server.xmlund die bisherigen PEM-Dateien. -
Ersetzen Sie die Dateien, auf die der Connector verweist, durch Ihr neues Zertifikat, den Schlüssel und die Kette. Behalten Sie die Dateinamen bei, dann bleibt
server.xmlunverändert. Andernfalls tragen Sie die neuen Pfade in den Attributen ein. -
Beschränken Sie den Zugriff auf die Dateien wie in Schritt 4 des ersten Abschnitts.
-
Starten Sie Tomcat neu und prüfen Sie die Verbindung wie in den Schritten 5 und 6 des ersten Abschnitts.