Geräte-Tokens erstellen und verwalten

Gilt für die CoCoCo-Plattform v1.0.0-rc.31. Jeder Schritt unten wurde auf dieser Version ausgeführt. Ein echtes Gerät mit den ausgegebenen Zugangsdaten zu verbinden gehört nicht zu diesem Test.

Was ist ein Geräte-Token?

Ein Geräte-Token gibt einem Gerät die Zugangsdaten, mit denen es über MQTT an CoCoCo sendet. Der Broker verlangt ein Client-Zertifikat, deshalb stellt ein Token eines aus: Client certificate und Client key sind das, womit sich das Gerät ausweist. Sie werden nur einmal angezeigt.

Bevor du anfängst

• Das Gerät braucht ein MQTT-Protokoll (eingehend oder ausgehend). Nur dann zeigt seine Seite Connection & Tokens. Siehe Ein Gerät hinzufügen.
• Du brauchst die Berechtigung, Geräte-Tokens anzulegen (device_token:write) und zu widerrufen (device_token:revoke).

Einen Token ausstellen

1. Klicke in der Seitenleiste unter IoT auf Geräte und öffne das Gerät.
2. Klicke unter Connection & Tokens auf Issue token. Es öffnet sich der Dialog Issue device token.
3. Gib einen Name ein, zum Beispiel presse-1 bridge. Description und Expires sind optional.
4. Klicke auf Issue token. Es öffnet sich der Dialog Token issued mit:
   • MQTT URL — die Broker-Adresse, mit der sich das Gerät verbindet
   • Suggested client ID — die Token-ID. Verwende sie als MQTT-Client-ID
   • unter mTLS certificates: Client certificate, Client key, Server CA und Tenant CA
5. Kopiere jetzt alle Werte und lege sie dort ab, wo die Software des Geräts sie nutzen kann. Später lässt sich nichts davon wieder anzeigen — geht es verloren, widerrufe den Token und stelle einen neuen aus.
6. Klicke unten im Dialog auf I have copied them oder drücke Esc.

Der Token steht jetzt mit dem Status Active in der Liste, zusammen mit Erstellungsdatum, Ablauf und letzter Nutzung.

Einen Token widerrufen

1. Klicke unter Connection & Tokens neben dem Token auf Revoke.
2. Lies die Bestätigung. Dort steht, dass auch das Zertifikat des Tokens widerrufen wird und ein Gerät, das es nutzt, sofort keine Verbindung mehr bekommt.
3. Klicke auf Revoke token.

Der Token bleibt mit dem Status Revoked in der Liste.

Hinweis: Dieser Bereich ist in dieser Version auch bei deutscher Oberfläche englisch beschriftet. Die Anleitung nennt die Texte so, wie sie auf dem Bildschirm stehen.