Diese Seite richtet sich an Firmware-Entwickler und Sicherheitsprüfer. Sie erklärt, welchen Zertifikaten ein Gerät vertrauen muss, wenn es sich mit Hermetry verbindet, welche Zertifikate Hermetry von Geräten akzeptiert und was sich im Laufe der Zeit ändert. Wie die Zertifizierungsstelle für Gerätezertifikate aufgebaut ist und betrieben wird, steht unter Die Zertifizierungsstelle für Gerätezertifikate.
Zwei Vertrauensrichtungen
| Richtung | Wer prüft | Wogegen |
|---|---|---|
| Das Serverzertifikat des Brokers | Ihr Gerät, wenn es eine TLS-Verbindung zum MQTT-Broker öffnet | Öffentliche Root-Zertifikate (ein übliches CA-Bundle) und der Hostname |
| Das Client-Zertifikat eines Geräts (X.509-Anmeldung) | Hermetry, wenn ein Gerät ein Zertifikat vorlegt | Nur die eigene Gerätezertifizierungsstelle von Hermetry |
Ein Gerät, das sich mit einem Zugriffstoken oder MQTT-Basic anmeldet, braucht nur die erste Zeile. Ein Gerät mit X.509-Zertifikat braucht beide.
Dem müssen Ihre Geräte vertrauen
Der Broker auf Port 8883 legt ein öffentliches Zertifikat für den Broker-Host vor, also den Host, der auf der Karte Verbindungsdetails des Geräts angezeigt wird.
- Prüfen Sie das Serverzertifikat gegen öffentliche Root-Zertifikate und den Hostnamen. Verbinden Sie sich über den Hostnamen, niemals über eine IP-Adresse, damit die Hostnamenprüfung bestehen kann.
- Pinnen Sie das Serverzertifikat nicht. Es wird vor Ablauf automatisch ersetzt, und ein Gerät, das es festpinnt, verbindet sich nach der nächsten Erneuerung nicht mehr.
- Bewahren Sie das CA-Bundle auf dem Gerät auf und machen Sie es über ein Firmware-Update austauschbar.
- Stellen Sie die Uhr (NTP), bevor Sie TLS öffnen. Ein Gerät mit falscher Uhr hält ein gültiges Zertifikat für abgelaufen oder noch nicht gültig.
Wenn das Zertifikat erneuert wird, verwendet der Broker das neue, ohne verbundene Geräte zu trennen. Ein Gerät sieht das neue Zertifikat beim nächsten TLS-Handshake.
Was Hermetry von Geräten akzeptiert
Ein Client-Zertifikat wird nur akzeptiert, wenn es von einer der ausstellenden Gerate-CAs (Device issuing CAs) von Hermetry ausgestellt wurde. Ein Zertifikat einer öffentlichen CA, Ihrer eigenen CA oder eines direkt signierten Roots beendet den TLS-Handshake. Es gibt keinen Rückfall auf ein Passwort. Eigene CAs hochzuladen ist nicht möglich; siehe Gerätezugangsdaten.
Bei jeder X.509-Anmeldung prüft Hermetry außerdem:
| Prüfung | Bei Fehlschlag |
|---|---|
| Das Zertifikat liegt innerhalb seines Gültigkeitszeitraums | Abgelehnt mit CONNACK 5, damit das Gerät die Wiederherstellung starten kann |
Es ist ein Client-Zertifikat (keine CA, mit Client-Authentifizierung) und sein Subject lautet genau CN=<serial> | Abgelehnt mit CONNACK 5 |
| Es ist nicht widerrufen | Abgelehnt mit CONNACK 5 |
| Es ist das aktive X.509-Zertifikat des Geräts, und sein CN ist die Seriennummer dieses Geräts | Abgelehnt mit CONNACK 5 |
| Die Liste widerrufener Zertifikate ist geladen | Solange sie es nicht ist, erhalten X.509-Anmeldungen CONNACK 3, und das Gerät wiederholt den Versuch |
Hermetry lädt die Liste der vertrauenswürdigen ausstellenden CAs bei jeder Änderung und alle 10 Minuten neu. Der Widerruf wird bei jeder Anmeldung und erneut bei jeder laufenden Sitzung etwa alle 60 Sekunden geprüft.
Die Hierarchie der Gerätezertifikate
| Zertifikat | Gültig für | Signiert |
|---|---|---|
| Root G1 | 20 Jahre | Die derzeit verwendeten ausstellenden CAs |
| Root G2 | 25 Jahre | Derzeit nichts. Ein Ersatz-Root, bei derselben Zeremonie wie G1 erstellt und offline aufbewahrt. |
| Ausstellende CA für Geräte (Device issuing CA) | 5 Jahre; sie stellt neue Zertifikate höchstens 24 Monate lang aus | Gerätezertifikate |
| Gerätezertifikat | Standardmäßig 365 Tage (30 bis 825, im Geräteprofil festgelegt) | Nichts |
Die Roots und ausstellenden CAs verwenden ECDSA-P-256-Schlüssel. Zusammen mit seinem Zertifikat erhält ein Gerät das Zertifikat der ausstellenden CA, die es signiert hat (chain in der Antwort auf v1/cert).
Was sich ändert und was Sie tun
| Änderung | Wann | Was Geräte bemerken | Ihre Maßnahme |
|---|---|---|---|
| Serverzertifikat des Brokers erneuert | Automatisch, vor Ablauf | Das neue Zertifikat beim nächsten TLS-Handshake. Verbundene Geräte bleiben verbunden. | Keine, wenn Geräte öffentlichen Roots vertrauen und darunter nichts pinnen |
| Gerätezertifikat erneuert | Das Gerät erneuert spätestens 30 Tage vor Ablauf. Hermetry fragt mit cert.renew an, wenn noch 21 Tage oder weniger übrig sind. | Ein neues Zertifikat. Das alte funktioniert weiter bis 24 Stunden nachdem das neue erstmals verwendet wurde, danach wird es als ersetzt widerrufen. | Halten Sie Geräte online und auf aktueller Firmware. Reagieren Sie auf die Erneuerungshinweise. |
| Ausstellende CA gewechselt | Nach höchstens 24 Monaten Ausstellung | Nichts. Die alte CA bleibt vertrauenswürdig und veröffentlicht weiter ihre Sperrliste, bis ihr letztes Zertifikat abläuft. Erneuerungen erhalten Zertifikate von der neuen CA. | Keine |
| Root erreicht das Ende seiner Lebensdauer | G1 ist 20 Jahre gültig | Auf Geräteseite geschieht nichts: Client-Zertifikate prüft Hermetry, nicht das Gerät | Keine. Die Betreiber von Hermetry werden alarmiert, wenn für einen Root weniger als 3 Jahre übrig sind. |
So wird ein Gerätezertifikat erneuert
- Das Gerät erneuert selbstständig. Es sendet eine neue Zertifikatsignierungsanforderung (CSR) über
v1/csrin seiner eigenen TLS-Sitzung, spätestens 30 Tage bevor sein Zertifikat abläuft. Pro Gerät wird eine Erneuerung pro Stunde akzeptiert. - Hermetry sucht jeden Tag nach Zertifikaten mit 21 Tagen oder weniger Restlaufzeit. Hat das Gerät in den letzten 7 Tagen keine CSR gesendet, ist online und hat angekündigt, die Methode zu unterstützen, erhält es einmalig
cert.renew. Ein Gerät, das offline ist, wird am nächsten Tag erneut angefragt. - Ein Administrator kann auf der Geräteseite Zertifikat erneuern auswählen. Die Option wird angeboten, wenn weniger als 30 Tage übrig sind oder wenn die Plattform den Schlüssel des Zertifikats erzeugt hat.
- Wenn 7 Tage nach
cert.renewnichts geschehen ist, erhalten die Inhaber und Administratoren der Organisation die Meldung „Geräte haben ihre Zertifikate nicht erneuert“. - Ein abgelaufenes Zertifikat wird mit CONNACK 5 abgelehnt. Das Gerät durchläuft dann die Wiederherstellung. Siehe Gerätezertifikate.
Inhaber und Administratoren werden außerdem täglich über Zertifikate informiert, die innerhalb der Ablaufwarnung (Tage) ablaufen (standardmäßig 30, 30 bis 180) und für die kein neueres Zertifikat existiert. Siehe Sicherheitswarnungen für Geräte.
Sperrlisten
Jede ausstellende CA veröffentlicht eine signierte Sperrliste (CRL), die 7 Tage gültig ist und mindestens einmal täglich neu signiert wird. Ihre Geräte müssen sie nicht herunterladen, um sich bei Hermetry anzumelden: Hermetry prüft den Widerruf selbst, bei der Anmeldung und während der Sitzung.
Checkliste für die Firmware
- Verbinden Sie sich per TLS über den Hostnamen und prüfen Sie die Kette gegen öffentliche Roots und den Hostnamen.
- Pinnen Sie nichts unterhalb eines Root-Zertifikats. Liefern Sie das CA-Bundle so aus, dass ein Firmware-Update es ändern kann.
- Stellen Sie die Uhr vor dem ersten TLS-Handshake richtig.
- Für X.509-Geräte: Erneuern Sie spätestens 30 Tage vor Ablauf, beantworten Sie
cert.renewund behalten Sie das aktuelle Zertifikat, bis das neue in Gebrauch ist.

