PotoP API Translator

Ein Vorgang öffnet sich in drei Teilen: die Anfrage genau so, wie das andere System sie gesendet hat (Methode, URL, Body), die PotoP-Schritte – jeder REST-Aufruf mit Pfad, Statuscode und den Millisekunden, die er gebraucht hat – und die Antwort, die im eigenen Format des anderen Systems zurückging. Das Ergebnis ist ok, Fehler, abgelehnt oder nicht unterstützt, und genau das summieren die Zähler. Diese Detailansicht ist der schnellste Weg zu lernen, was der Befehl eines Herstellers auf PotoP wirklich tut – deshalb öffnet der Prüfstand dieselbe Ansicht für die Befehle, die Sie selbst senden.

Beim Koppeln bittet der Übersetzer PotoP VMS Studio um ein nach ihm benanntes API-Token mit einem festen Satz von Rechten, angelegt unter dem Administrator, der den Knopf gedrückt hat; das Token wird verschlüsselt gespeichert und kann hier oder im VMS widerrufen werden. Dieselbe Seite zeigt den Ereignis-Feed, den der Übersetzer offen hält, um jedes PotoP-Ereignis zu nummerieren, das Zertifikat, das er auf jedem Port ausliefert (das eigene des VMS-Servers, über Erneuerungen hinweg verfolgt, oder ein selbst erzeugter Ersatz), und pro Konnektor-Art, ob sie bereit ist, wie viele eingerichtet sind oder dass sie noch nicht gebaut ist.

Im Übersetzer gibt es keine Benutzerliste. Das Anmeldeformular sendet an den eigenen Login des VMS, beachtet die zweistufige Anmeldung und prüft dann, ob das Konto ein Administrator ist; alle anderen werden in klaren Worten abgewiesen. Die Sitzung ist ein striktes Cookie für diesen Browser mit einer gleitenden Lebensdauer von dreißig Minuten, jede Änderung trägt einen CSRF-Header, und acht Fehlversuche von einer Adresse in fünf Minuten pausieren diese Adresse. Die Seite wird über das Zertifikat des PotoP-Servers ausgeliefert, und ein Browser, der localhost öffnet, wird auf einen Namen umgeleitet, für den das Zertifikat ausgestellt wurde.

Der Übersetzer liefert das Zertifikat des VMS-Servers auf jedem Konnektor-Port aus und folgt dessen Erneuerungen, sodass die Adresse unter „Allgemein“ über HTTPS funktioniert, sobald sie in die PLC oder das Managementsystem eingetragen ist. Ports sind Tags: Ein zweiter – 443 oder 80 für ein System, das keinen anderen bekommen kann – wird ohne Neustart hinzugefügt, und Ports, die der PotoP-Server selbst nutzt, werden mit Begründung abgelehnt. „Diesen Konnektor entfernen“ verlangt eine Bestätigung und wird unter Ihrem Namen ins Aktivitätsprotokoll geschrieben.

„Konto hinzufügen“ erzeugt ein einmalig angezeigtes Passwort mit achtzehn Zeichen; aufbewahrt wird nur ein scrypt-Hash, geprüft neben der Hauptschleife des Dienstes mit einem kurzen Merker, sodass ein System, das sich bei jeder Anfrage anmeldet, nichts extra kostet. Zehn falsche Passwörter pausieren diesen Namen von dieser Adresse für fünf Minuten. „Unverschlüsseltes HTTP zulassen“ öffnet eine Warnung, die Sie namentlich akzeptieren müssen, und HTTPS funktioniert auf demselben Port weiter. Die Gruppen darunter sind Berechtigungen pro Konnektor: Ein Befehl, dessen Gruppe aus ist, wird im eigenen Vokabular des anderen Systems abgelehnt; „Einstellungen ändern“ ist standardmäßig aus.

Eine Sense-Integration adressiert einen Server über eine lange Nummer und eine Kamera über eine Geräte-ID, beide aus der ersetzten Installation. Die Zuordnung gibt jedem Paar seine PotoP-Kamera; ohne Zuordnung gilt die Geräte-ID als PotoP-Kameranummer, und eine zugeordnete Kamera ist nur unter ihrer zugeordneten Nummer erreichbar. Befehle mit einer unbekannten Nummer werden nicht geraten: Die Nummer wird in der Liste darunter gesammelt, mit Häufigkeit und letztem Zeitpunkt, und „Zuordnen…“ beginnt daraus eine Zuordnungszeile – lassen Sie das andere System eine Minute laufen, und die Liste sagt, was es noch erwartet.

ICX spricht in Rufnummern, Ausgangs- und Eingangsnummern, Kamera- und Monitornummern. Eine Rufnummer ist die PotoP VoIP-Nebenstelle mit derselben Nummer, sofern nicht zugeordnet; ein Ausgang wird real, sobald ein PotoP-Makro für Ein und Aus benannt ist; ein Eingang wird von einem PotoP-Ereignistyp, wahlweise einer einzelnen Kamera, für eine Anzahl Sekunden gepulst; ein Monitor ist ein PotoP-Layout samt der Kachel, auf die die Kamera gelegt wird. Unter den Tabellen listet der Konnektor die Task- und Type-Paare, die er empfangen hat und für die er keinen Handler hat – eine fehlende Funktion wird so gesehen statt geraten.

Der Konnektor beantwortet die Konfigurations-API von Milestone mit eigenen IDs, stabil über Neustarts hinweg. Eine Integration, die Kameras, Ausgänge oder Ereignistypen über Namen nachschlägt, funktioniert daher unverändert; eine, die mit den GUIDs der alten XProtect-Installation programmiert wurde, heftet sie hier fest, jede an das PotoP-Objekt, das sie ersetzt hat, mit dem ID-Typ gewählt aus Kameras, Hardware, Recording-Servern, Ausgängen, Eingangsereignissen, benutzerdefinierten Ereignissen, Ereignistypen, Ansichten, Basisbenutzern und Rollen. Ausgänge erhalten eine Nummer, einen Namen und ein PotoP-Makro, damit das Auslösen wirklich etwas schaltet.

PotoP ist ein Videosystem, und die Seite sagt das unverblümt: Alarme landen im Alarmregister von PotoP mit der Instanz-ID gleich der PotoP-Alarmnummer, Videoschutz ist eine Aufbewahrungssperre für Aufnahmen, Aufzeichnung ist die manuelle Aufzeichnung von PotoP, Ereignisse werden unter den Namen von Security Center veröffentlicht. Zutrittskontrolle, Einbruchmeldung, LPR-Patrouille und Parken haben kein Gegenstück – ihre Entitäten werden aufbewahrt, ihre Berichte antworten Ok mit leerer Liste, ihre Aktionen antworten Fail mit einer Meldung, die den Grund nennt – und nie wird vorgetäuscht, dass etwas geschehen sei.

Jede Familie trägt ihre ICX-Task- und Type-Codes unter dem Namen, sodass ein Protokollingenieur 40/80 oder 80/AC direkt nachschlagen kann. Fast jede Familie wird zu einer Operation (op) des Intercom-Befehlsendpunkts des VMS – call, hangup, dtmf, busy, privacy, page, conference, output, input, door code, request, desk –, und die Notiz sagt, was sich unterscheidet: Privatsphäre pro Gespräch beachtet, Simplex-Modus gemeldet, aber nicht erzwungen, ein Funkkanal als Konferenzraum. Aufbewahrte Familien sind die Teile, die nur eine Commend-Sprechstelle hat; PotoP speichert sie pro Sprechstelle und meldet sie als Ereignis.

Die 75 Zeilen decken die Anmelde-Endpunkte, die WebSockets für Ereignisse und Messaging, Alarme, Lesezeichen, Beweissperren, WebRTC und jeden Konfigurations-Ressourcentyp der veröffentlichten MIP VMS API ab. Vollständige Zeilen sind durch PotoP gedeckt (Kameras, Recording-Server, Ausgänge, benutzerdefinierte Ereignisse als Makros, Ansichten als Layouts, Basisbenutzer und Rollen als echte Benutzer und Gruppen); aufbewahrte Zeilen speichern, was das andere System anlegt, und geben es mit eigenen IDs zurück; und jede Aufgabe, die PotoP nicht ausführen kann – Speicher kürzen, ein Gerätepasswort ändern, Hardware ersetzen –, ist als mit einem Fehler beantwortet aufgeführt, nicht als vorgetäuschter Erfolg.

Das Web SDK wird mit seiner eigenen q=-Syntax für Methodenaufrufe beantwortet, JSON oder XML in moderner oder alter Form, wie der Accept-Header es verlangt. Entitäten stammen aus Kameras, Servern, Benutzern, Gruppen, Makros und Intercom-Zustand von PotoP, mit der logischen ID gleich der PotoP-Nummer; Kameramethoden, PTZ, Ausgänge, Kacheln und Alarme werden auf die gezeigten Aufrufe abgebildet; der Ereignisstrom trägt den Feed von PotoP unter 37 Ereignisnamen von Security Center. Die Zeilen für Zutrittskontrolle, Einbruchmeldung, LPR und Parken sind die ehrlichen: aufbewahrte Entitäten, leere Berichte und Aktionen, die mit Begründung fehlschlagen.

ICX ist binär, daher bietet der Prüfstand jede Befehlsfamilie mit durchgerechneten Beispielen, deren Nummern Sie durch Ihre ersetzen, zeigt die Hex-Nachricht, die er senden wird, und dekodiert jeden Antwortrahmen in Worte, neben den PotoP-Aufrufen, die ihn erzeugt haben. Der zweite Teil simuliert, was in PotoP VoIP geschieht – ein Gespräch klingelt, wird angenommen, endet, eine Sprechstelle fällt aus, ein Ausgang schaltet, eine Rufanforderung wird gestellt – und gibt die ICX-Statusmeldungen aus, die der Konnektor senden würde; sie erreichen das angebundene System nur, wenn das Kästchen angehakt ist, und das wird ins Aktivitätsprotokoll geschrieben. Der dritte Teil ist die Live-Leitung: jeder Rahmen hinein und hinaus.

Das Protokoll ist die eigene Audit-Tabelle des Übersetzers, neben dem Ereignisjournal in seiner SQLite-Datei: Konsolen-Anmeldungen mit ihrer Adresse, jede Konnektor-Änderung mit Feld und Person, abgewiesene Anmeldungen anderer Systeme – einmal pro Adresse, Name und Grund in fünf Minuten –, abgewiesene ICX-Clients und jede Statusmeldung, die der Prüfstand an ein Live-System geschoben hat. Was das Token des Übersetzers auf dem VMS getan hat, wird dort ebenfalls festgehalten, im Audit-Trail von PotoP unter dem Namen des Tokens – die beiden Bücher zusammen beantworten so, wer was auf welcher Seite getan hat.