Integration von Anwendungen

Die GExAdmin API baut auf den Funktionen der GEx API auf.

Das GEx Administrations Programming Interface (kurz GExAdmin API) stellt alle Funktionen zur Steuerung und Administration des GExCore Servers bereit. Das verwendete Protokoll basiert auf einem Befehlssatz, der intern zur Steuerung des GExCore verwendet wird. D.h. es werden kleine Programme übertragen, die asynchron vom GExCore abgearbeitet werden.

Folgende Funktionen stehen bereit:

  • Einfügen, Löschen, Updaten und Abfragen der Gerätekonfiguration.
  • Abfrage und Ändern globaler Laufzeitparameter des GExCore wie Voreinstellungen, Administrationsparameter, Logging, etc.
  • Abfrage aller Geräte, die online sind (Session-Liste). Sessions können aktiv beendet werden (kick).
  • Abfrage aller konfigurierten Modems.
  • Information über alle relevanten Statusänderungen des Servers sowie seiner Clients (subscription). Dazu gehören:
    • An- und Abmeldung von Teilnehmern.
    • Auf- und Abbau von Push-Channels.
    • Registrieren und Abmelden von Push-Targets.
    • Volumen des Datendurchsatzes.
    • Änderungen an Server-Optionen durch andere Administratoren.
    • Auf- und Abbau von Wählverbindungen und Standleitungen sowie deren
    • Status

Architektur

Einen Überblick, wie die Admin-API im GEx-System eingesetzt wird, gibt die Abbildung weiter unten. Zunächst erfolgt eine Anmeldung als IP-T Client am GExCore Server. War diese Anmeldung erfolgreich, wird ein Wählverbindung zur Admin-Session aufgebaut. Es handelt sich dabei um eine intrinsische Session, weil sie keinem externen Teilnehmer zugeordnet ist sondern vom System selbst verwaltet wird. Zur Kommunikation wird von der Admin-Session eine temporäre Proxy-Session erzeugt. Ist der Verbindungsaufbau abgeschlossen, erfolgt die Autorisierung. Dieser Schritt ist notwendig, damit das System nicht von unberechtigten Clients aus konfiguriert werden kann. Die weitere Kommunikation erfolgt nun über ein p2 genanntes Protokoll, das zur Übertragung von Befehlen und Daten an GExCore genutzt wird. Informationen dazu befinden sich hier.

Architektur der GEx Administrations API