Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Geräteprofile

Jeder Abschnitt und jedes Feld eines Geräteprofils – Transport, Anmeldungen, Themen, Online-Regel, Limits, Schlüssel, Provisionierung – mit Standardwerten und Löschregeln.

Ein Geräteprofil beschreibt, wie sich eine Geräteart verhält. Jedes Gerät verwendet genau ein Profil. Ändern Sie das Profil, folgen alle Geräte dieses Profils der Änderung. Legen Sie pro Geräteart ein Profil an: ein Profil pro Sensormodell, pro Firmware-Familie oder pro Sicherheitsbedarf (zum Beispiel ein TLS-Profil und eines für alte Geräte, die kein TLS können).

Öffnen Sie Profile unter Device Profiles im IoT-Menü. Zum Anzeigen benötigen Sie die Rolle User, zum Ändern die Rolle Admin. Die Bereitstellungsstrategie und die Schlüssel erfordern die separate Berechtigung zur Verwaltung der Bereitstellung (Administratoren).

Die Profilliste

Die Liste zeigt Name, Transport, Online-Regel, Geräte (der Zähler wird alle 30 s aktualisiert) und Aktualisiert, mit Kennzeichen für Default, Built-in und Platform template. Suchen Sie nach Name und filtern Sie nach Transport und Online-Regel.

Zum Anlegen eines Profils wählen Sie New profile, geben einen Name, eine Description und den Transport ein und wählen Create profile. Limits, Topics und Anmeldungen beginnen mit den Protokollvorgaben; Sie ändern sie auf der Profilseite. Bevor das Profil gespeichert werden kann, müssen Sie eine Online-Regel wählen.

Das Standardprofil

Jede Organisation hat genau ein Standardprofil. Hermetry legt ein Profil namens Default an, sobald es eines benötigt. Es verwendet:

  • die Online-Regel Live connection,
  • das Standard-Topic-Schema,
  • nur Anmeldung mit Zugriffstoken,
  • die Standardlimits des Protokolls,
  • Bereitstellung Disabled,
  • Nur TLS (Port 8883).

Ihr erstes eigenes Profil wird ebenfalls zum Standard. Um ein anderes Profil zum Standard zu machen, öffnen Sie es und wählen Make default. Neue Geräte ohne Profilangabe erhalten das Standardprofil.

Integrierte Profile

Einige Protokolle bringen ein integriertes Profil mit, gekennzeichnet mit Built-in profile. Hermetry legt es an, sobald es benötigt wird:

Integriertes ProfilVerwendet von
LoRaWAN EU868 Class A OTAA (1.0.3)LoRaWAN-Sensoren, die über New device > LoRaWAN device hinzugefügt werden
LoRaWAN-GatewayBasics-Station-Gateways
Das Profil des KameraprotokollsKameras und Recorder dieses Protokolls

Ein integriertes Profil behält seinen Transport („A built-in profile keeps its transport: devices of its protocol are registered with it.“) und kann nicht gelöscht werden. Alles andere darin ist bearbeitbar, und Sie dürfen es umbenennen.

Profile aus einer Vorlage

Ein lizenziertes Gerät, das Sie beanspruchen, erhält eine Kopie des Profils seines Modells, erstellt aus einer Plattformvorlage. Der Profilkopf zeigt, aus welcher Vorlage und Version es stammt, und einige Felder zeigen from template. Ein solches Profil akzeptiert nur X.509-Zertifikate („This profile accepts X.509 certificates only“). Bei einer Kopie bleibt die Bereitstellung Disabled.

Profilabschnitte

ReiterWas Sie festlegen
AllgemeinName (1 bis 128 Zeichen, eindeutig in Ihrer Organisation), Description (bis zu 2.000 Zeichen). Zeigt, wann das Profil erstellt und zuletzt geändert wurde, seine ID und was es verwendet (In use).
Transport & AuthentifizierungTransport, erlaubte Anmeldungen, unverschlüsseltes MQTT, Token in der URL, erlaubte Netzwerke, Befehle ohne TLS, Topic-Schemata, eigene Topics.
Online-StatusWie Hermetry entscheidet, dass ein Gerät online ist.
LimitsRatenlimits, Nutzlastgrößen, das In-Flight-Fenster, Inaktivität, Gateway-Kindgeräte, das Standard-Zeitlimit für Befehle.
Telemetrie-SchlüsselDie Schlüssel, die die Geräte senden, mit Bezeichnungen, Einheiten, Nachkommastellen und Bereichen.
KonfigurationsschlüsselDie cfg.*-Schlüssel, die Sie auf den Geräten setzen dürfen.
ProvisionierungWie sich Geräte ohne Zugangsdaten selbst registrieren.

Andere Module fügen Reiter hinzu: Alarm rules, Commands, Firmware, LoRaWAN (LoRaWAN-Profile) und SNMP (SNMP-Profile).

Transport & Authentifizierung

Transport

TransportGeräte
MQTTVerbindung über MQTT herstellen.
HTTPNur Senden über HTTPS.
MQTT und HTTPBeides.
LoRaWANBeitritt über den Hermetry LoRaWAN Network Server. Sie melden sich nicht selbst an.
Ein AbfrageprotokollWerden von der Plattform über einen Endpunkt abgefragt (SNMP-Agenten, Kameras, Recorder). Die MQTT-, Token- und Netzwerkeinstellungen gelten nicht.

Ein Wechsel des Transports ändert nie die Online-Regel; eine Regel, die der Transport nicht nutzen kann, verhindert das Speichern.

Allowed authentication (mindestens eine): Access token, MQTT basic (username and password), X.509 certificate. Siehe Device credentials.

Transportsicherheit

EinstellungStandardWirkung
Unverschlüsseltes MQTTNur TLS (Port 8883)Ein Gerät, das sich über den unverschlüsselten Port 1883 anmeldet, wird abgewiesen. Wird ein Profil auf nur TLS umgestellt, werden die unverschlüsselten Sitzungen seiner Geräte sofort beendet. Plain MQTT allowed (port 1883) ist für Geräte gedacht, die kein TLS können.
Token in der URL (Geräte, die keine Header senden können)AusErlaubt POST /api/v1/{token}/telemetry und /attributes. Ein solches Profil wird nur noch HTTP: Jede MQTT-Anmeldung seiner Geräte wird abgewiesen.
Zulässige NetzwerkeLeer (beliebiges Netzwerk)Bis zu 64 IPv4- oder IPv6-Netzwerke (203.0.113.0/24) oder einzelne Adressen. Geräte außerhalb davon werden abgewiesen (MQTT CONNACK 5, HTTP 403).
Ohne TLS zulässige BefehleLeerBis zu 32 exakte Befehlsnamen, die ein Gerät während einer unverschlüsselten Sitzung empfangen darf. Jeder andere Befehl wartet auf eine TLS-Sitzung.

Warnung

Listen Sie ohne TLS nur Befehle auf, deren Missbrauch unschädlich ist, etwa sys.info oder sys.ping. Listen Sie niemals sys.reboot, ota.check oder cert.renew auf. Firmware-Updates und Geräteeinstellungen werden nie unverschlüsselt gesendet, und ein Werksreset wird gar nicht gesendet.

Topic schemes (mindestens eines):

SchemaTopics
Das Standardschemav1/telemetry, v1/attributes, v1/rpc/… und der Rest des Standardsatzes. Unbekannte v1/…-Topics werden abgewiesen.
AbwärtskompatibelNur v1/devices/me/telemetry und v1/devices/me/attributes, für bestehende Firmware: keine Befehle, Beanspruchung, Bereitstellung oder Gateway-Topics.

Sind beide Optionen aktiv, teilen sich alte und neue Firmware ein Profil; Downlinks folgen dem, was jedes Gerät abonniert hat.

Custom topics (Accept topics outside v1/ as telemetry): Jedes Topic außerhalb von v1/ wird als Telemetrie akzeptiert. Ein JSON-Objekt wird zu Schlüsseln; alles andere wird zu einem einzigen, in der Größe begrenzten raw-Schlüssel.

FeldStandardBereich
Schlüssel mit dem Topic präfixierenAus: Kommt derselbe Schlüssel auf zwei Topics an, gewinnt der letzte Schreibvorgang—
Maximale Topic-Tiefe (Ebenen)81 bis 16
Maximale Topic-Länge (Zeichen)12816 bis 256
Eindeutige Topics pro Gerät501 bis 1.000
Max. Rohdaten-Payload (Bytes)4,096256 bis 65.536, nie über der Nutzlastobergrenze

Online-Status

RegelEin Gerät ist online, wenn
Live-VerbindungEs hält seine MQTT-Verbindung. Empfohlen für Geräte, die MQTT offen halten.
Letzte NachrichtSeine letzte Nachricht ist jünger als Expected interval (seconds) × Factor. Die Seite zeigt „Shown offline after … without a message.“
Nur zuletzt gesehenWird nie als online oder offline angezeigt. Listen zeigen, wann es zuletzt gesehen wurde.

Erwartetes Intervall beträgt 60 bis 604.800 Sekunden und ist für Letzte Nachricht erforderlich. Faktor beträgt 1,5 bis 10 (eine Nachkommastelle), standardmäßig 3. HTTP- und LoRaWAN-Geräte halten keine Verbindung, daher wird Live-Verbindung für sie nicht angeboten; abgefragte Geräte verwenden Nur zuletzt gesehen. Siehe Verbindungsstatus und Aktivität.

Limits

Rate-Limits verwenden die Form count:seconds; mehrere Zeitfenster gelten gleichzeitig, wobei jedes länger ist als das vorherige (höchstens 4 pro Familie, eine Anzahl von 1 bis 1.000.000 über 1 Sekunde bis 1 Tag). Protokollstandard setzt eine Familie zurück.

FamilieStandard
Telemetrie-Nachrichten10:1,300:60
Telemetrie-Datenpunkte200:1,6000:60
Attribut-Aktualisierungen5:1,60:60
Attribut-Anfragen5:1,60:60
RPC-Nachrichten5:1,60:60
Zertifikatsanfragen1:3600
Verbindungsaufbauten6:60

Hermetry wendet die Limits für Telemetrienachrichten, Telemetriepunkte und Attributaktualisierungen auf jedes Gerät an. Bei Überschreitung eines Limits wird die Nachricht quittiert und verworfen. Eigentümer und Administratoren erhalten pro Gerät und Stunde einen Hinweis. Jedes Gerät erhält seine effektiven Limits im gemeinsamen Attribut session_limits.

FeldStandardBereich
Wiedergabe-Nachrichten pro SekundeLeer: die Hälfte der Telemetrie-Anzahl pro Sekunde1 bis 10.000
Max. Nachrichtenlast (Bytes)65,5361.024 bis 65.536
Max. Downlink-Last (Bytes)65,5361.024 bis 65.536
Max. unbestätigte Nachrichten (MQTT)201 bis 1.000
Inaktivitäts-Timeout (Sekunden)60010 bis 604.800. Ein Gerät, das so lange nichts sendet, gilt als inaktiv (nicht dasselbe wie offline).
Max. untergeordnete Geräte eines Gateways5000 bis 10.000
Profil neuer untergeordneter GeräteGenerisches KindprofilBeliebiges Profil; verwendet, wenn das Gateway keinen Typ angibt
Standard-RPC-Timeout (Sekunden)101 bis 300

Telemetrie-Schlüssel

Liste der Schlüssel, die die Geräte senden (bis zu 500). Jeder Schlüssel hat einen Typ (Zahl, Ganzzahl, Ja / Nein, Text, JSON) und optional eine Einheit (bis zu 32 Zeichen), eine Bezeichnung (bis zu 128), Min, Max und Dezimalstellen (0 bis 10). Dashboards nutzen diese Angaben: Ein Messinstrument übernimmt den Bereich als Standardskala. Schlüssel folgen den Schlüsselregeln: bis zu 64 Zeichen aus A–Z a–z 0–9 _ . -, und sie dürfen nicht mit _, fw_, current_fw_ oder cfg. beginnen.

Nicht aufgelistete Schlüssel werden trotzdem gespeichert.

Wenn Sie Schlüssel entfernen oder umbenennen, zeigt das Profil Entfernte Schlüssel werden noch verwendet mit den Alarmregeln und anderen Lesern an, die sie lesen, und bietet Auf die neuen Namen aktualisieren oder Behalten an.

Konfigurationsschlüssel

Die cfg.*-Schlüssel, die ein Gerät als gemeinsame Attribute akzeptiert, jeweils mit Typ, Bezeichnung und Grenzwerten: Min, Max, Erlaubte Werte (bis zu 100), Min. Länge und Max. Länge sowie Geheim (nur schreibbar). Siehe Attribute.

Provisionierung

Die Strategie (Deaktiviert, Neue Geräte erlauben, Nur vorab bereitgestellte Geräte) und die Provisionierungsschlüssel. Siehe Geräte hinzufügen und beanspruchen.

Änderungen speichern

  • Änderungen speichern sendet nur die geänderten Felder; Verwerfen verwirft sie. Ihre Änderungen bleiben im Formular, während Sie zwischen Registerkarten wechseln.
  • Beim Speichern von Änderungen an Transport, Anmeldungen, Netzwerken, Themenschemata oder Limits eines verwendeten Profils erscheint Wie verbinden sich die Geräte von … neu?: Live-Sitzungen, die nicht mehr passen, enden sofort. Wählen Sie Speichern und anwenden.
  • Hat jemand anderes das Profil gespeichert, nachdem Sie es geöffnet haben, wird Ihr Speichern abgelehnt: „Jemand anderes hat dieses Profil gespeichert, nachdem Sie es geöffnet haben.“ Verwenden Sie Profil neu laden.

Duplizieren und löschen

  • Profil duplizieren erstellt „ein neues Profil mit allen Einstellungen dieses Profils; die Provisionierung beginnt deaktiviert und kein Schlüssel wird kopiert“, benannt <name> (copy).
  • Profil löschen wird verweigert für das Standardprofil („make another profile the default first“), ein integriertes Profil, eine Plattformvorlage und ein Profil, das noch von Geräten, Alarmregeln oder Befehlen verwendet wird („Still used by …: move or remove them first.“).

Verwandt