Protokoll-Endpunkte

Manche Geräte können keine Verbindung zu Hermetry herstellen: ein SNMP-Agent in einer USV, eine Kamera, ein Recorder. Stattdessen stellt Hermetry die Verbindung zu ihnen her. Sie beschreiben das Gerät einmal als Endpoint und binden ein oder mehrere Geräte daran. Der Poller der Plattform liest die Geräte nach Zeitplan aus und speichert jedes Ergebnis als normale Gerätemeldung.

Begriff	Bedeutung
Protokoll	Die Sprache, in der Hermetry mit dem Gerät spricht: SNMP, RTSP-Kamera oder das HTTP-Protokoll unterstützter Kameras und Recorder
Endpoint	Ein Gerät: sein Host, Port, Einstellungen und nur schreibbare Geheimnisse (Passwörter, Communities)
Gerät	Ein an einen Endpoint gebundenes Gerät, mit einer Adresse darauf, wenn das Gerät mehrere Geräte bereitstellt (der Kanal eines Recorders)

Kameras und Recorder werden über ihre eigene Auswahl Kamera oder Recorder hinzugefügt; siehe Kamera oder Recorder hinzufügen. Diese Seite behandelt die allgemeinen Regeln und die Auswahl Netzwerkgerät.

Before you start

Legen Sie ein Geräteprofil für das Protokoll an. Wählen Sie unter Geräteprofile die Option Neues Profil und wählen Sie das Protokoll als Transport. Abgefragte Profile verwenden die Online-Regel Nur zuletzt gesehen. Ohne ein solches Profil sehen Sie: „Noch kein Geräteprofil verwendet „…“. Legen Sie unter Geräteprofile einen mit diesem Transport an; die neuen Geräte verwenden ihn.“
Machen Sie das Gerät unter einer öffentlichen Adresse erreichbar. Der Poller läuft in der Cloud. Bei jedem Speichern und jedem Test wird der Host aufgelöst, und private, Loopback- und Link-Local-Adressen werden abgelehnt („The host is a private address. Only public addresses can be reached from the cloud; use a site router for a private network.“) sowie Ports, die zu Plattformdiensten gehören („That port belongs to a service and cannot be used.“).
Öffnen Sie Ihre Firewall für den Poller. Das Endpoint-Formular zeigt die festen Adressen, von denen die Plattform sich verbindet: „The platform polls from …. Allow these addresses in the firewall of the site.“ Erlauben Sie nur diese Adressen zum Port des Geräts.

Netzwerkgerät hinzufügen

Sie benötigen die Berechtigungen, Geräte anzulegen und Protokoll-Endpoints zu verwalten.

Öffnen Sie Geräte und wählen Sie Neues Gerät. Wählen Sie Netzwerkgerät („An SNMP agent or another box the platform polls, by its address and credentials; the connection is tested first.“).
Schritt Verbindung: Wählen Sie das Protokoll und unter Verbindung entweder einen vorhandenen Endpoint dieses Protokolls (angezeigt als Name, Host und Anzahl der Geräte) oder Ein neuer Endpoint.
Geben Sie für einen neuen Endpoint einen Namen ein und füllen Sie die Felder des Protokolls aus. Wählen Sie Speichern und Verbindung testen.
- Wenn der Test erfolgreich ist, fahren Sie fort.
- Schlägt der Test fehl, wird der Endpoint ausgeschaltet gespeichert: „The endpoint is saved switched off because its test failed. Fix it and save again, or add the devices now and switch it on later on their Connection tab.“ Korrigieren Sie die Einstellungen und wählen Sie Erneut speichern und testen, oder fahren Sie mit Geräte trotzdem hinzufügen fort.
Schritt Geräte: Wählen Sie das Geräteprofil. Dann markieren Sie entweder die Einträge, die Hermetry hinter dem Endpoint erkannt hat, oder geben Sie bei einem Protokoll ohne Erkennung (SNMP) einen Gerätenamen ein (und die Adressfelder, falls das Protokoll welche hat). Wählen Sie Gerät hinzufügen.
Schritt Fertig: „{count} devices were added.“ Wählen Sie Weitere hinzufügen, um weitere Geräte anzulegen.

Endpoint-Namen sind in Ihrer Organisation eindeutig („An endpoint with this name already exists. Choose another name.“).

Geheimnisse sind nur schreibbar

Passwörter, Communities und andere geheime Felder werden verschlüsselt gespeichert und nie wieder angezeigt, weder in der Oberfläche noch in der API. Das Formular zeigt „Stored. Leave empty to keep it; it is never shown again.“ Um ein Geheimnis zu ändern, geben Sie ein neues ein.

Wenn Sie den Host, einen Port oder den Benutzer ändern, müssen Sie das Passwort erneut eingeben („You changed the host, a port or the user: enter the password again.“). So wird verhindert, dass ein gespeichertes Passwort an eine neue Adresse gesendet wird.

Der Verbindungstest

Der Test führt die eigene Prüfung des Protokolls aus (bei SNMP ein Lesen der System-Gruppe). Das Ergebnis ist OK oder Fehlgeschlagen mit einem Grund, dazu Warnungen, die den Test nicht fehlschlagen lassen.

Fehler	Bedeutung
„The user name or password was refused.“	Falsche Zugangsdaten
„The device refused the connection. Check the port.“	Auf diesem Port lauscht niemand
„The device did not answer in time.“	Firewall, falscher Host oder das Gerät ist aus
„The host name does not resolve.“	DNS-Name unbekannt
„The secure connection could not be set up (certificate).“	Zertifikatsproblem bei einem HTTPS-Gerät
„The stored credentials cannot be read. Enter them again.“	Geheimnisse erneut eingeben
„The protocol module is not active for this workspace.“	Das Protokoll ist nicht Teil Ihres Tarifs

Tests sind begrenzt: „This endpoint was just tested. Wait a few seconds.“ Jeder Test und jede Prüfung eines neuen Hosts wird im Audit-Protokoll erfasst.

Geräte erkennen

Ein Protokoll, das auflisten kann, was dahintersteckt (die Kanäle eines Recorders), bietet Geräte erkennen / Weitere Geräte erkennen an. Die Liste zeigt Name, Adresse und Status (Online, Offline, Bereits verbunden). Markieren Sie, was Sie möchten, und wählen Sie {count} Geräte hinzufügen. Jedes wird zu einem Gerät an diesem Endpoint, das gemäß dem Intervall seines Profils abgefragt wird.

Ihr Gerätelimit wird für den gesamten Stapel geprüft, bevor ein Gerät angelegt wird: „{current} of {limit} devices used; {adding} more do not fit in your plan.“

Der Reiter Verbindung

Die Seite eines abgefragten Geräts hat einen Reiter Verbindung. Er zeigt:

Feld	Bedeutung
Endpoint, Protokoll, Adresse	Wo das Gerät abgefragt wird
Zugangsdaten	„Set: … (never shown; Edit replaces them)“
Letzte Abfrage, Letzter Erfolg, Nächste Abfrage	Der Zeitplan; Nie abgefragt vor der ersten Abfrage
Fehlgeschlagene Abfragen in Folge, Letzter Fehler	Warum das Gerät nicht antwortet
Gerätereignisse	Für Endpoints, die Gerätereignisse empfangen, siehe Kameraereignisse

Aktionen auf dem Reiter:

Endpoint bearbeiten öffnet das Endpoint-Formular. Teilen sich mehrere Geräte den Endpoint, weist ein Hinweis darauf hin: „Shared by {n} devices. A change to the endpoint applies to all of them“
Ausschalten / Einschalten stoppt bzw. setzt die Abfrage fort. Ein ausgeschalteter Endpoint fragt keines seiner Geräte ab. Das Einschalten testet ihn erneut.
Trennen beendet die Abfrage des Geräts und behält seine Daten. Für das letzte Gerät eines Endpoints wählen Sie Nur trennen oder Trennen und Endpoint löschen.
Über einen Endpoint verbinden bindet ein Gerät, das keinen hat. Das Profil des Geräts muss das Protokoll des Endpoints verwenden („The device’s profile uses a different transport than this endpoint’s protocol. Change the profile first.“).

Die Spalte IP-Adresse der Geräteliste zeigt die öffentliche Adresse des Geräts, von dem ein abgefragtes Gerät gelesen wird.

Ungenutzte Endpoints

Ein Endpoint, der kein Gerät bedient, hält trotzdem seine gespeicherten Zugangsdaten. In der Auswahl Netzwerkgerät listet Ungenutzte Endpoints ({n}) sie auf; wählen Sie Diesen ungenutzten Endpoint löschen, um einen zu entfernen. Ein Endpoint, der noch Geräte bedient, kann nicht gelöscht werden („The endpoint still serves devices. Disconnect them first.“).

Fehler

Meldung	Abhilfe
„A device is already connected at this address of the endpoint.“	Wählen Sie eine andere Adresse (Kanal).
„This endpoint can hold only one device, and it already has one.“	Legen Sie für das nächste Gerät einen neuen Endpoint an.
„The device is already connected through an endpoint.“	Trennen Sie es zuerst.
„Geräte werden gerade hinzugefügt. Bitte versuchen Sie es gleich noch einmal.“	In Ihrer Organisation läuft gerade ein anderer Hinzufügevorgang.
„Protokoll nicht installiert“	Das Modul des Protokolls ist nicht verfügbar; das Gerät wird nicht abgefragt.