Adapter mostu

Adapter mostu Zabbix umożliwia komunikację serwera Zabbix z aplikacją mobilną Zabbix.

Aplikacja mobilna Zabbix nie łączy się bezpośrednio z serwerem Zabbix. Zamiast tego dwa komponenty przekazują między sobą dane:

  • Zabbix Bridge - centralnie hostowana usługa, która wymienia dane z aplikacją mobilną Zabbix na urządzeniu mobilnym.
  • Adapter mostu Zabbix - komponent instalowany i uruchamiany przez użytkownika. Łączy serwer Zabbix z usługą Zabbix Bridge.

Adapter mostu można zainstalować w tym samym systemie co serwer Zabbix lub w innym systemie, korzystając z pakietów.

Aby skonfigurować adapter mostu Zabbix, zaktualizuj jego plik konfiguracyjny (domyślna ścieżka: /etc/zabbix/zabbix_bridge_adapter.conf).

Aby zapewnić bezpieczeństwo adaptera mostu Zabbix, zobacz Bezpieczny dostęp mobilny.

Połączenia sieciowe

Adapter Zabbix Bridge inicjuje wszystkie połączenia z Zabbix Bridge, dlatego nie trzeba zezwalać na przychodzące połączenia internetowe.

Następujące połączenia pozostają w obrębie sieci:

  • Serwer Zabbix → adapter Bridge (HTTP(S): ListenPort) - wysyła powiadomienia push i żądania zarządzania urządzeniami.
  • Adapter Bridge → API Zabbix (HTTP(S): port ZabbixAPIURL) - przekazuje żądania z aplikacji mobilnej, jeśli AllowedAPIMethods na to zezwala.
  • Klient sprawdzania stanu → adapter Bridge (HTTP: ListenHealthPort) - sprawdza punkty końcowe /health i /ready (np. z modułu równoważenia obciążenia lub orkiestratora kontenerów), jeśli ustawiono ListenHealthPort.

Można szyfrować połączenia między serwerem Zabbix, adapterem Zabbix Bridge i API Zabbix.

Następujące połączenia odbywają się przez internet (zawsze szyfrowane, TLS 1.2/1.3):

  • Adapter Bridge → Bridge (HTTPS: 443):
    • Po uruchomieniu pobiera listę punktów końcowych usług z ZabbixBridgeURL.
    • Pobiera token dostępu od dostawcy tożsamości Zabbix Bridge (OAuth 2.0) pod adresem https://auth.mobilebridge.zabbix.com/oauth2/token.
  • Adapter Bridge → Bridge (gRPC: 443):
    • Po uruchomieniu rejestruje (tylko raz) serwer Zabbix za pośrednictwem enroll.mobilebridge.zabbix.com:443.
    • Utrzymuje otwarte połączenie z api.mobilebridge.zabbix.com:443 na potrzeby zapytań z aplikacji mobilnej.
    • Wysyła żądania zarządzania urządzeniami do register.mobilebridge.zabbix.com:443.
    • Wysyła powiadomienia push do api.mobilebridge.zabbix.com:443.
  • Aplikacja mobilna → Bridge (HTTPS: 443):
    • Pobiera listę punktów końcowych usług z https://config.mobilebridge.zabbix.com/.well-known/bridge-configuration.
    • Pobiera token dostępu od dostawcy tożsamości Zabbix Bridge (OAuth 2.0) pod adresem https://auth.mobilebridge.zabbix.com/oauth2/token.
  • Aplikacja mobilna → Bridge (gRPC: 443):
    • Po dodaniu urządzenia i zeskanowaniu kodu QR rejestruje urządzenie mobilne za pośrednictwem enroll.mobilebridge.zabbix.com:443.
    • Wysyła zapytania do api.mobilebridge.zabbix.com:443 (np. podczas aktualizowania problemów).