Bridge-Adapter

Der Zabbix Bridge-Adapter ermöglicht Ihrem Zabbix Server die Kommunikation mit der Zabbix Mobile App.

Die Zabbix Mobile App verbindet sich nicht direkt mit Ihrem Zabbix Server. Stattdessen übertragen zwei Komponenten Daten zwischen ihnen:

  • Zabbix Bridge – ein zentral gehosteter Dienst, der Daten mit der Zabbix Mobile App auf Ihrem Mobilgerät austauscht.
  • Zabbix Bridge-Adapter – eine Komponente, die Sie installieren und ausführen. Sie verbindet Ihren Zabbix Server mit Zabbix Bridge.

Der Bridge-Adapter kann auf demselben System wie Ihr Zabbix Server oder auf einem anderen System mithilfe von Paketen installiert werden.

Um den Zabbix Bridge-Adapter zu konfigurieren, aktualisieren Sie seine Konfigurationsdatei (Standardpfad: /etc/zabbix/zabbix_bridge_adapter.conf).

Informationen zum Absichern des Zabbix Bridge-Adapters finden Sie unter Sicherer mobiler Zugriff.

Netzwerkverbindungen

Der Zabbix-Bridge-Adapter initiiert alle Verbindungen zum Zabbix Bridge, daher müssen Sie keine eingehenden Internetverbindungen zulassen.

Die folgenden Verbindungen bleiben innerhalb Ihres Netzwerks:

  • Zabbix Server → Bridge-Adapter (HTTP(S): ListenPort) – sendet Push-Benachrichtigungen und Anforderungen zur Geräteverwaltung.
  • Bridge-Adapter → Zabbix API (HTTP(S): ZabbixAPIURL-Port) – leitet Anforderungen der mobilen App weiter, sofern AllowedAPIMethods dies zulässt.
  • Health-Check-Client → Bridge-Adapter (HTTP: ListenHealthPort) – überprüft die Endpunkte /health und /ready (z. B. von einem Load Balancer oder Container-Orchestrator), sofern ListenHealthPort festgelegt ist.

Sie können die Verbindungen zwischen Zabbix Server, Zabbix-Bridge-Adapter und Zabbix API verschlüsseln.

Die folgenden Verbindungen laufen über das Internet (immer verschlüsselt, TLS 1.2/1.3):

  • Bridge-Adapter → Bridge (HTTPS: 443):
    • Ruft beim Start eine Liste der Service-Endpunkte von ZabbixBridgeURL ab.
    • Ruft ein Zugriffstoken vom Identitätsanbieter des Zabbix Bridge (OAuth 2.0) unter https://auth.mobilebridge.zabbix.com/oauth2/token ab.
  • Bridge-Adapter → Bridge (gRPC: 443):
    • Registriert beim Start den Zabbix Server (nur einmal) über enroll.mobilebridge.zabbix.com:443.
    • Hält eine offene Verbindung zu api.mobilebridge.zabbix.com:443 für Abfragen der mobilen App aufrecht.
    • Sendet Anforderungen zur Geräteverwaltung an register.mobilebridge.zabbix.com:443.
    • Sendet Push-Benachrichtigungen an api.mobilebridge.zabbix.com:443.
  • Mobile App → Bridge (HTTPS: 443):
    • Ruft eine Liste der Service-Endpunkte von https://config.mobilebridge.zabbix.com/.well-known/bridge-configuration ab.
    • Ruft ein Zugriffstoken vom Identitätsanbieter des Zabbix Bridge (OAuth 2.0) unter https://auth.mobilebridge.zabbix.com/oauth2/token ab.
  • Mobile App → Bridge (gRPC: 443):
    • Wenn Sie Ihr Gerät hinzufügen und den QR-Code scannen, registriert sie das mobile Gerät über enroll.mobilebridge.zabbix.com:443.
    • Sendet Abfragen an api.mobilebridge.zabbix.com:443 (z. B. wenn Sie Probleme aktualisieren).