Start / Acmefyer / Tomcat-Zertifikat
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.
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.
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.xmlgelesen 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.
- 01
Domain anlegen
Zum Beispiel app.example.com, mit Let’s Encrypt und Prüfung per HTTP-01 oder DNS-01.
- 02
Agent installieren
Das Setup-Paket auf dem Tomcat-Server starten. Der Agent erkennt Tomcat und seinen Keystore.
- 03
Deployment anlegen
Ein Klick übernimmt den Vorschlag mit Pfad, Alias und der Datei für das Passwort.
- 04
Fertig
Acmefyer erneuert das Zertifikat ab jetzt rechtzeitig und meldet jedes Ergebnis.
Funktioniert Let’s Encrypt mit Tomcat?
JKS oder PKCS#12: Welches Format schreibt Acmefyer?
Wo liegt das Passwort des Keystores?
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?
Vertraut Tomcat danach auch Zertifikaten unserer internen CA?
cacerts, und den ändert Acmefyer nicht.