Zertifikate automatisch beziehen (ACME)

ℹ️ Verfügbar ab QuickHMI 15

ℹ️ Hinweis: Version 15 ist noch nicht veröffentlicht.

QuickHMI kann TLS-Zertifikate für die Weboberfläche und weitere TLS-Endpunkte selbst bei einer Zertifizierungsstelle wie Let’s Encrypt beziehen und vor Ablauf automatisch erneuern. Browser vertrauen diesen Zertifikaten ohne Warnung, und der manuelle Austausch von Zertifikatsdateien entfällt. Das dafür verwendete Verfahren heißt ACME; neben Let’s Encrypt unterstützen es auch viele andere Zertifizierungsstellen, etwa firmeninterne.

Ein so bezogenes Zertifikat ist im Zertifikatsmanager ein ganz normales eigenes Zertifikat. Sie weisen es wie gewohnt unter TLS-Zuweisungen einem Port zu oder legen es als Standard-TLS-Zertifikat fest.

Voraussetzungen

  • Ein öffentlicher Name (z. B. hmi.firma.de), der im DNS auf diesen Rechner zeigt, oder eine feste öffentliche IP-Adresse. Interne Namen (z. B. hmi.local) und private IP-Adressen (z. B. 192.168.1.20) zertifiziert Let’s Encrypt nicht.
  • Port 80 ist aus dem Internet erreichbar, denn die Zertifizierungsstelle prüft darüber, ob der Name wirklich zu diesem Rechner gehört. Port 80 kann direkt bei QuickHMI ankommen, über eine Weiterleitung (Router, Firewall, Reverse Proxy) an einen HTTP-Port von QuickHMI, oder bei einem anderen Webserver auf diesem Rechner, siehe Wie die Zertifizierungsstelle prüft.
  • Für die automatische Erneuerung muss mindestens eine QuickHMI-Instanz laufen. Ohne laufende Instanz können Sie im Zertifikatsmanager jederzeit von Hand erneuern.

Tipp: Probieren Sie die Einrichtung zuerst mit der Zertifizierungsstelle „Let’s Encrypt (Testumgebung, nicht vertrauenswürdig)“. Sie verhält sich wie Let’s Encrypt, stellt aber nicht vertrauenswürdige Testzertifikate aus und begrenzt Anfragen deutlich weniger streng. Klappt dort alles, fordern Sie das echte Zertifikat an.

Zertifikat anfordern

Dialog „TLS-Zertifikat automatisch beziehen“ mit Let’s Encrypt und einem Beispielnamen
  1. Öffnen Sie den Zertifikatsmanager und klicken Sie in der Werkzeugleiste auf Zertifikat anfordern (ACME).
  2. Wählen Sie die Zertifizierungsstelle: Let’s Encrypt, Let’s Encrypt (Testumgebung, nicht vertrauenswürdig) oder Eigene ACME-Zertifizierungsstelle (siehe Eigene ACME-Zertifizierungsstelle).
  3. Tragen Sie unter Namen / IP-Adressen alle Namen ein, unter denen QuickHMI erreichbar sein soll, durch Komma getrennt. Der erste Eintrag wird zum Anzeigenamen des Zertifikats. Namen, die die Zertifizierungsstelle nicht zertifizieren würde, meldet der Dialog schon beim Tippen.
  4. Wählen Sie unter Prüfung über den Prüfweg, meist Automatisch (QuickHMI beantwortet die Prüfung).
  5. Belassen Sie den Schlüssel auf RSA 2048 (empfohlen), sofern Sie nicht ausdrücklich ECDSA P-256 brauchen.
  6. Bei der ersten Anforderung an eine Zertifizierungsstelle bestätigen Sie deren Nutzungsbedingungen (Link Nutzungsbedingungen anzeigen). Das ist nur einmal je Zertifizierungsstelle nötig; danach zeigt der Dialog „Diese Installation ist bei der Zertifizierungsstelle bereits registriert.“
  7. Klicken Sie auf Anfordern. Die Anforderung kann bis zu einigen Minuten dauern.
  8. Weisen Sie das neue Zertifikat unter TLS-Zuweisungen einem Port zu oder legen Sie es unter Eigene Zertifikate als Standard-TLS-Zertifikat fest.

In der Liste der eigenen Zertifikate erscheint das Zertifikat mit dem Typ Automatisch (ACME). Für Let’s Encrypt brauchen Sie keine E-Mail-Adresse anzugeben: Vor einem Ablauf warnt QuickHMI selbst.

Wie die Zertifizierungsstelle prüft

Vor jeder Ausstellung ruft die Zertifizierungsstelle eine kurzlebige Prüfdatei unter http://<Name>/.well-known/acme-challenge/ auf Port 80 ab. Dafür gibt es zwei Prüfwege:

  • Automatisch (QuickHMI beantwortet die Prüfung): QuickHMI liefert die Prüfdatei selbst aus. Ist Port 80 auf diesem Rechner frei, öffnet QuickHMI ihn für die Dauer der Prüfung; läuft dort bereits eine QuickHMI-Instanz, antwortet diese. Ist Port 80 lokal nicht nutzbar, fragt QuickHMI trotzdem an, denn Port 80 kann von außen an einen HTTP-Port von QuickHMI weitergeleitet sein (Router, Firewall, Reverse Proxy, Docker-Portzuordnung).
  • Ordner eines anderen Webservers: Läuft auf Port 80 bereits ein anderer Webserver (z. B. IIS, Apache, nginx), wählen Sie dessen Dokumentenordner als Webserver-Ordner. QuickHMI legt die Prüfdatei dort ab und entfernt sie danach wieder.

Zertifikate für IP-Adressen

Statt eines Namens können Sie eine öffentliche IP-Adresse eintragen (IPv4 oder IPv6). Let’s Encrypt stellt dafür Zertifikate mit nur wenigen Tagen Laufzeit aus, die QuickHMI entsprechend häufig erneuert. Das ist nur bei einer festen IP-Adresse sinnvoll: Ändert sich die Adresse, passt das Zertifikat nicht mehr.

Eigene ACME-Zertifizierungsstelle

Mit Eigene ACME-Zertifizierungsstelle nutzen Sie jede andere Zertifizierungsstelle, die ACME anbietet, etwa eine firmeninterne. Tragen Sie dazu die Verzeichnis-URL ein, die Ihnen die Zertifizierungsstelle nennt. Eine interne Zertifizierungsstelle darf auch interne Namen und private IP-Adressen zertifizieren; ob sie es tut, entscheidet sie selbst.

  • E-Mail (optional): Manche Zertifizierungsstellen verlangen eine Kontaktadresse.
  • Kunden-ID (Key-ID) und Kundenschlüssel (HMAC): erscheinen nur, wenn die Zertifizierungsstelle sie verlangt (External Account Binding), und sind dann Pflicht. Sie erhalten beides im Kundenportal der Zertifizierungsstelle.

Automatische Erneuerung

Jede laufende QuickHMI-Instanz prüft regelmäßig, ob ein Zertifikat zu erneuern ist. Erneuert wird rechtzeitig vor Ablauf, zu dem Zeitpunkt, den die Zertifizierungsstelle empfiehlt, sonst nach etwa zwei Dritteln der Laufzeit. Laufen mehrere Instanzen, erneuert genau eine; die anderen übernehmen das Ergebnis.

Das erneuerte Zertifikat behält seine Zuweisungen. Neue Verbindungen erhalten es sofort, ohne Neustart der Instanz; bereits offene Verbindungen laufen mit dem bisherigen Zertifikat weiter.

Reiter „Automatische Erneuerung“ im Detaildialog, Status „Aktiv“

Im Detaildialog eines solchen Zertifikats zeigt der Reiter Automatische Erneuerung den Status (Aktiv, Letzte Erneuerung fehlgeschlagen oder Ausgesetzt), die Zertifizierungsstelle, die Namen, den Prüfweg sowie Zuletzt ausgestellt und Nächste Erneuerung. Nach einem Fehlschlag kommen Nächster Versuch und Letzter Fehler hinzu. Dort finden Sie auch die Aktionen:

  • Jetzt erneuern: erneuert sofort, z. B. nach einer Änderung an der Weiterleitung.
  • Automatische Erneuerung aussetzen: Das Zertifikat bleibt erhalten, wird aber nicht mehr erneuert und läuft zum angezeigten Datum ab. Die Einstellungen bleiben gespeichert, mit Automatische Erneuerung fortsetzen schalten Sie sie wieder ein. Nützlich etwa während Umbauten, wenn Port 80 vorübergehend nicht erreichbar ist.

Ersetzen Sie ein solches Zertifikat von Hand (Ersetzen / Erneuern), fragt QuickHMI, ob die automatische Erneuerung ausgesetzt werden soll; sonst würde die nächste Erneuerung Ihr ersetztes Zertifikat wieder ablösen. Löschen entfernt das Zertifikat samt automatischer Erneuerung.

Warnungen

Übersicht des Zertifikatsmanagers mit der Karte „Automatisch erneuert“

Solange die Erneuerung funktioniert, gibt es keine Ablaufwarnung, auch wenn das Zertifikat bald abläuft. Scheitert sie wiederholt oder rückt der Ablauf näher, zeigt die Karte Automatisch erneuert in der Übersicht das Problem an, und am Symbol des Zertifikatsmanagers im Hauptfenster erscheint ein roter Punkt. Bei Zertifikaten mit sehr kurzer Laufzeit (IP-Adressen) warnt QuickHMI schon nach dem ersten Fehlschlag.

Wenn die Anforderung scheitert

Scheitert eine Anforderung, bleibt der Dialog mit Ihren Eingaben offen und zeigt einen Hinweis sowie die Meldung der Zertifizierungsstelle. Die häufigsten Fälle:

  • Port 80 ist hier von einem anderen Programm belegt bzw. QuickHMI darf Port 80 auf diesem System nicht öffnen, und eine Weiterleitung fehlt: Leiten Sie Port 80 von außen an einen HTTP-Port von QuickHMI weiter oder wählen Sie Ordner eines anderen Webservers.
  • Die Zertifizierungsstelle konnte diesen Rechner nicht über Port 80 erreichen: Prüfen Sie, ob der Name öffentlich auf diesen Rechner zeigt und Port 80 von außen erreichbar ist (Firewall, Router).
  • Kann nicht zertifiziert werden: Der Name ist intern oder die IP-Adresse privat. Verwenden Sie einen öffentlichen Namen oder eine eigene Zertifizierungsstelle.
  • Vorübergehend keine weiteren Anfragen: Die Zertifizierungsstelle begrenzt die Zahl der Anfragen. Der Hinweis nennt den nächsten möglichen Zeitpunkt. Zum Ausprobieren eignet sich die Testumgebung.
  • Nicht erreichbar: Prüfen Sie Internetverbindung, Proxy und Firewall des Rechners.

Im ConsoleRuntimeManager

Im Menü Certificate manager › Own certificates fordern Sie mit a: Request certificate via ACME ein Zertifikat an; der Ablauf entspricht dem Dialog. Automatisch erneuerte Zertifikate sind in der Liste mit [ACME] markiert (bei Problemen [ACME: renewal failing], ausgesetzt [ACME: suspended]). Für ein solches Zertifikat gibt es zusätzlich 8: Automatic renewal (status), 9: Renew now und 10: Suspend bzw. Resume automatic renewal.

Linux und Docker

Unter Linux dürfen QuickHMI-Instanzen ab Version 15 Port 80 selbst öffnen, obwohl sie nicht als root laufen (siehe Betrieb als Dienst). Im Docker-Container übernimmt die Portzuordnung (z. B. 80:8080) diese Aufgabe; für QuickHMI ist das eine Weiterleitung, der Prüfweg Automatisch funktioniert damit.