InhaltInstallation und Einrichtung

TLS-Zertifikat erneuern

Gilt für ISPICIO_E 2.1.1.0 Stand

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.xml enthä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.

  1. 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 || true

    Windows (wechseln Sie zuerst in den Ordner conf; die zweite copy-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
  2. 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.xml ein.

    Linux:

    openssl pkcs12 -export \
      -inkey privkey.pem \
      -in cert.pem \
      -certfile chain.pem \
      -name tomcat \
      -out /path/to/tomcat/conf/tomcat.p12

    Windows (im Ordner conf; die drei PEM-Dateien liegen im Beispiel in C:\certs):

    openssl pkcs12 -export -inkey C:\certs\privkey.pem -in C:\certs\cert.pem -certfile C:\certs\chain.pem -name tomcat -out tomcat.p12
  3. Bearbeiten Sie server.xml so, 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" />
  4. 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.p12

    Windows: Öffnen Sie die Eigenschaften der Datei tomcat.p12 und 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.

  5. Starten Sie Tomcat neu.

    Linux:

    sudo systemctl restart tomcat
    # or: catalina.sh stop && catalina.sh start

    Windows:

    net stop Tomcat11
    net start Tomcat11
  6. Prüfen Sie Gültigkeitsdaten und Aussteller des Zertifikats. Ersetzen Sie your.domain.com und 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 -subject

    Windows:

    openssl s_client -connect your.domain.com:8443 -servername your.domain.com < NUL | openssl x509 -noout -dates -issuer -subject

    Ohne 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".

  1. Importieren Sie bei Bedarf zuerst die Zertifikate der Zwischenzertifizierungsstelle:

    keytool -importcert -alias intermediate -file intermediate.crt -keystore /path/to/keystore.jks
  2. Importieren Sie das Serverzertifikat:

    keytool -importcert -alias tomcat -file server.crt -keystore /path/to/keystore.jks

    Der Wert von -alias muss dem Alias des ursprünglichen Schlüsselpaars entsprechen. Sie prüfen ihn mit keytool -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 tomcat

    In der Windows-Eingabeaufforderung schreiben Sie diesen Befehl in eine Zeile, ohne die Zeichen \ am Zeilenende.

  3. Lassen Sie server.xml unverändert. Die Datei verweist weiter auf den Keystore, der jetzt das neue Zertifikat enthält.

  4. 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" />
  1. Sichern Sie server.xml und die bisherigen PEM-Dateien.

  2. 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.xml unverändert. Andernfalls tragen Sie die neuen Pfade in den Attributen ein.

  3. Beschränken Sie den Zugriff auf die Dateien wie in Schritt 4 des ersten Abschnitts.

  4. Starten Sie Tomcat neu und prüfen Sie die Verbindung wie in den Schritten 5 und 6 des ersten Abschnitts.