Start / Acmefyer / Tomcat-Zertifikat

AcmefyerAgentenbasierter Zertifikatsmanager

Tomcat-Zertifikat automatisch erneuern, samt Keystore.

Tomcat und viele Java-Anwendungen lesen ihr Zertifikat nicht als PEM-Datei, sondern aus einem Java-Keystore mit Passwort und Alias. Bei jedem Tausch wird der Keystore neu gebaut, und Tomcat startet neu. Acmefyer holt das Zertifikat per ACME, zum Beispiel kostenlos von Let’s Encrypt, und ein Agent schreibt den Keystore so, wie der Connector ihn erwartet.

01Von HandWas bei jedem Tausch zu tun ist

So tauschen Sie das SSL-Zertifikat im Tomcat-Keystore von Hand.

Zertifikat, Kette und Schlüssel werden zu einem Keystore zusammengefasst, zum Beispiel mit OpenSSL als PKCS#12-Datei:

openssl pkcs12 -export -in fullchain.pem -inkey privkey.pem -name tomcat -out keystore.p12

Datei, Passwort und Alias müssen zu dem passen, was der Connector in server.xml nennt (certificateKeystoreFile, certificateKeystorePassword, certificateKeyAlias). Danach startet Tomcat neu. Erwartet die Anwendung das ältere JKS-Format, kommt eine Umwandlung mit keytool dazu.

Format
PKCS#12 oder JKS, mit dem Passwort und dem Alias des Connectors. Ein Tippfehler, und Tomcat startet ohne HTTPS oder gar nicht.
Mitgeliefert
Viele Produkte bringen ihren eigenen Tomcat mit, unter Windows oft als Dienst mit eigenem Namen. Der Keystore liegt dann irgendwo im Ordner des Produkts.
Wie oft
Seit März 2026 gelten öffentliche Zertifikate höchstens 200 Tage, ab 2029 nur noch 47 Tage. Dann steht der Tausch etwa jeden Monat an.
02Mit AcmefyerWas der Agent übernimmt

Der Agent schreibt den Keystore und startet Tomcat neu.

Der Acmefyer-Server holt das Zertifikat bei Let’s Encrypt oder einer anderen ACME-Zertifizierungsstelle und erneuert es rund 30 Tage vor Ablauf. Auf dem Tomcat-Server läuft der Acmefyer-Agent als Dienst, unter Windows wie unter Linux. Er holt das neue Zertifikat ab, schreibt es als Java-Keystore mit Passwort und Alias des Connectors und startet Tomcat neu.

Das Passwort des Keystores muss dafür nicht in Acmefyer stehen: Der Agent liest es bei jedem Deployment aus server.xml. So verlässt es den Rechner nie.

Keystore
PKCS#12, bei Dateien mit der Endung .jks oder .keystore das JKS-Format. Zertifikat, Kette und Schlüssel unter dem Alias des Connectors.
Passwort
Aus server.xml gelesen oder im Deployment hinterlegt. Platzhalter wie ${…} liest der Agent nicht, dann tragen Sie das Passwort selbst ein.
Erkennung
Der Agent findet Tomcat mit Connector, Keystore und dem Zertifikat, das dort gerade steckt, und schlägt das passende Deployment vor. Unter Windows auch dort, wo ein Produkt seinen eigenen Tomcat als Dienst mitbringt.
Neustart
Über den Dienst, der Tomcat startet. Das neue Zertifikat greift nach dem Neustart.
Verwandte
Auch das enaio-Gateway: Sein Keystore wird wie bei Tomcat ersetzt, mit Neustart des Dienstes.
Prüfung
Per DNS-01 muss der Tomcat-Server für die Prüfung der Domain nicht aus dem Internet erreichbar sein.
03EinrichtenEinmal einrichten, danach läuft es von selbst
  1. 01

    Domain anlegen

    Zum Beispiel app.example.com, mit Let’s Encrypt und Prüfung per HTTP-01 oder DNS-01.

  2. 02

    Agent installieren

    Das Setup-Paket auf dem Tomcat-Server starten. Der Agent erkennt Tomcat und seinen Keystore.

  3. 03

    Deployment anlegen

    Ein Klick übernimmt den Vorschlag mit Pfad, Alias und der Datei für das Passwort.

  4. 04

    Fertig

    Acmefyer erneuert das Zertifikat ab jetzt rechtzeitig und meldet jedes Ergebnis.

04FragenHäufige Fragen zum Tomcat-Zertifikat

Funktioniert Let’s Encrypt mit Tomcat?

Ja. Tomcat nimmt jedes Zertifikat, das mit Kette und Schlüssel im Keystore des Connectors liegt. Let’s Encrypt stellt es per ACME kostenlos aus, und Acmefyer schreibt den Keystore und startet Tomcat neu.

JKS oder PKCS#12: Welches Format schreibt Acmefyer?

Beide. Maßgeblich ist die Datei, die der Connector nennt: Bei den Endungen .jks und .keystore schreibt der Agent JKS, sonst PKCS#12.

Wo liegt das Passwort des Keystores?

Dort, wo es schon liegt: in server.xml. Der Agent liest es bei jedem Deployment von dort, es wird nicht an den Acmefyer-Server übertragen. Alternativ tragen Sie es im Deployment ein. Dann speichert Acmefyer es verschlüsselt.

Unser Produkt bringt seinen eigenen Tomcat mit. Geht das auch?

In vielen Fällen ja. Unter Windows findet der Agent Tomcat auch über den Dienst, der ihn startet, und startet ihn über diesen Dienst neu. Schreibt ein Produkt die Konfiguration seines Webservers selbst, markiert der Scan es als vom Hersteller verwaltet und schlägt nichts vor.

Vertraut Tomcat danach auch Zertifikaten unserer internen CA?

Das ist ein anderer Speicher. Der Keystore enthält das eigene Zertifikat von Tomcat. Welchen fremden Zertifikaten Java vertraut, steht im Vertrauensspeicher cacerts, und den ändert Acmefyer nicht.