English

Glossar

Alle Begriffe aus den ersten Schritten, einfach erklärt. Wörter in GROSSBUCHSTABEN zeigt die Konsole genau so an, als farbige Markierung.

Ihre Organisation und ihre Mitglieder

Organisation

Der eigene Bereich Ihrer Firma in der Konsole. Alles, was Sie anlegen (Templates, Geräte, Mitglieder), gehört zu genau einer Organisation. Niemand außerhalb kann es sehen. Mit der Registrierung legen Sie eine neue Organisation an.

Mitglied

Eine Person mit eigenem Zugang zu Ihrer Organisation. Mitglieder laden Sie unter Members per E-Mail ein.

Akteur (Audit history)

Wer etwas getan hat, in der Audit history: der Name (oder die E-Mail) eines Mitglieds, System für Aktionen, die die Plattform selbst ausführt, oder Former member für jemanden, der nicht mehr zu Ihrer Organisation gehört.

Rolle

Was ein Mitglied tun darf. Jedes Mitglied hat genau eine Rolle:

Rolle	Darf
Org Admin	Alles: Firmendaten ändern, Mitglieder einladen und entfernen, Rollen ändern, Geräte hinzufügen, bearbeiten und löschen, Geräte übernehmen, Templates anlegen und ändern. Wer sich registriert, ist der erste Org Admin.
Editor	Geräte von Hand hinzufügen, Geräte übernehmen, Templates anlegen und ändern, Templates Geräten zuweisen. Darf nicht die Identität eines vorhandenen Geräts ändern, keine Geräte löschen und keine Mitglieder verwalten.
Viewer	Alles ansehen, nichts ändern.

Konfiguration

Template

Alle Einstellungen, die ein Gateway von der Plattform bekommt, zum Beispiel wie oft es sich meldet. Sie legen ein Template einmal an und weisen es dann beliebig vielen Geräten zu. Ein Gerät ohne Template kann nicht eingerichtet werden.

Zielplattform

Wohin Ihre Gateways ihre Daten senden, sobald sie laufen. Sie wählen sie beim Anlegen eines Templates:

• Pallax: die IoT-Plattform Pallax. Die Plattform richtet die Verbindung zu Pallax für jedes Gateway selbst ein.
• Generic: jedes andere System, das Gateways über eine gesicherte Verbindung annimmt (ein MQTT-Broker). Sie geben die Adresse dieses Systems an (den Broker) und ein Zertifikat dafür.

Broker

Der Server, mit dem sich Ihre Gateways verbinden, um ihre Daten abzuliefern. Nur für die Zielplattform Generic nötig.

Zertifikat (Credential)

Der elektronische Ausweis, den ein Gateway dem Broker zeigt, damit der Broker es hereinlässt. Er besteht aus einem Zertifikat, dem zugehörigen privaten Schlüssel und der Zertifikatskette des Ausstellers. Sie bekommen ihn vom Betreiber Ihres Brokers, nicht von dieser Plattform. Zertifikate laufen ab, meist nach einem Jahr, und müssen dann ersetzt werden: Config templates zeigt vorher die Warnung „The certificate on … expires in N days. Upload a replacement before then, or N devices can no longer receive their configuration.“, und das Template trägt das Kennzeichen Certificate · N d left. Ist es abgelaufen, können Gateways mit diesem Template ihre Konfiguration nicht mehr erhalten. Beim Entfernen oder Ersetzen eines Zertifikats wird sein privater Schlüssel aus dem Speicher gelöscht; vom alten Schlüssel bleibt nichts zurück.

Geräte

Gerät (Gateway)

Ein einzelnes, physisches Gateway. In der Konsole ist es eine Zeile unter Devices. Diese Anleitung verwendet „Gerät“ und „Gateway“ für dasselbe.

EUI

Die weltweit eindeutige Nummer des Gateways: 16 Zeichen, Ziffern 0–9 und Buchstaben a–f, zum Beispiel 0000000000000001. Sie steht auf dem Typenschild des Gateways, manchmal mit Bindestrichen, Doppelpunkten, Punkten oder Leerzeichen zwischen den Zeichen. Sie können sie so oder ohne eintippen, zum Beispiel 00:00:00:00:00:00:00:01: Die Konsole entfernt die Trennzeichen und speichert die 16 Zeichen.

Seriennummer

Die Seriennummer des Herstellers, auf dem Typenschild des Gateways.

TPM

Ein Sicherheitschip im Gateway. Er enthält einen geheimen Schlüssel, der den Chip nie verlässt. So kann das Gateway beweisen, dass es wirklich es selbst ist.

AK-Fingerprint

Ein Code aus 64 Zeichen (Ziffern 0–9 und Buchstaben a–f), der das TPM des Gateways kennzeichnet. Daran erkennt die Plattform das Gateway, wenn es sich meldet. Er ist nicht geheim. Echtes Gateway registrieren zeigt die zwei Wege, ihn zu bekommen.

Claim-Code

Ein Einmal-Code, den Sie zu Gateways bekommen, die Sie beim Hersteller bestellt haben. Geben Sie ihn unter Devices → Claim devices ein, wird das Gateway in Ihre Organisation übernommen. Eine Bestellnummer macht dasselbe für eine ganze Bestellung auf einmal.

Was nach dem Einschalten passiert

Check-in

Das Gateway meldet sich von selbst bei der Plattform, standardmäßig einmal pro Stunde. Jede Meldung fragt „Gibt es etwas Neues für mich?“ und erscheint im Reiter Check-ins des Geräts. Ändern Sie das Template, übernimmt das Gateway die Änderung bei seinem nächsten Check-in.

Gerätestatus (Lifecycle)

Wie weit ein Gerät auf dem Weg von „eingetragen“ zu „läuft“ ist. Er erscheint als Markierung in der Spalte LIFECYCLE und auf der Geräteseite:

Markierung	Bedeutung
CLAIMED	Das Gerät gehört Ihrer Organisation, aber die Plattform hat das Gateway noch nicht eingerichtet. Hier beginnt jedes Gerät nach Add device oder Claim devices.
PROVISIONED	Das Gateway hat sich gemeldet, sich ausgewiesen und seine Einstellungen bekommen.
ACTIVE	Die eigene Software des Gateways hat gemeldet, dass sie ihre Zielplattform erreicht hat. Das Gerät läuft vollständig.

Weitere Markierungen, die Sie sehen können: LOCKED (absichtlich gesperrt, das Gateway wird abgewiesen), IMPORTED (hergestellt, aber noch von niemandem übernommen).

Health (Zustand)

Ob sich ein bereits eingerichtetes Gerät noch normal meldet. Erscheint in der Spalte HEALTH und neben dem Status auf der Geräteseite:

Markierung	Bedeutung
HEALTHY	Meldet sich normal.
FAILING	Meldet sich immer wieder, kann sich aber nicht fertig ausweisen. Meist ein Problem am Gateway selbst.
SILENT	Seit drei Check-in-Intervallen (standardmäßig 3 Stunden) ist nichts angekommen. Das Gateway ist aus, offline, oder seine Software läuft nicht.

Ein Gerät, das nie eingerichtet wurde, hat keine Health-Markierung.