ブリッジアダプター

Zabbixブリッジアダプターを使用すると、ZabbixサーバーとZabbixモバイルアプリ間で通信できます。

Zabbixモバイルアプリは、Zabbixサーバーに直接接続しません。 代わりに、2つのコンポーネントが両者の間でデータを受け渡します。

  • Zabbix Bridge - モバイルデバイス上のZabbixモバイルアプリとデータを交換する、中央ホスト型のサービス。
  • Zabbixブリッジアダプター - インストールして実行するコンポーネント。 ZabbixサーバーをZabbix Bridgeに接続します。

ブリッジアダプターは、パッケージを使用して、Zabbixサーバーと同じシステム、または別のシステムにインストールできます。

Zabbixブリッジアダプターを設定するには、その設定ファイル(デフォルトのパス: /etc/zabbix/zabbix_bridge_adapter.conf)を更新します。

Zabbixブリッジアダプターのセキュリティを確保する方法については、モバイルアクセスのセキュリティ保護を参照してください。

ネットワーク接続

Zabbixブリッジアダプターは、Zabbix Bridgeへのすべての接続を開始するため、インターネットからの受信接続を許可する必要はありません。

以下の接続はネットワーク内にとどまります。

  • Zabbixサーバー → ブリッジアダプター(HTTP(S): ListenPort) - プッシュ通知とデバイス管理リクエストを送信します。
  • ブリッジアダプター → Zabbix API(HTTP(S): ZabbixAPIURL ポート) - AllowedAPIMethods で許可されている場合、モバイルアプリからのリクエストを転送します。
  • ヘルスチェッククライアント → ブリッジアダプター(HTTP: ListenHealthPort) - ListenHealthPort が設定されている場合、/health および /ready エンドポイントをチェックします(ロードバランサーやコンテナオーケストレーターなどから)。

Zabbixサーバー、Zabbixブリッジアダプター、Zabbix API間の接続を暗号化できます。

以下の接続はインターネット経由で行われます(常に暗号化され、TLS 1.2/1.3を使用します)。

  • ブリッジアダプター → Bridge(HTTPS: 443):
    • 起動時に、ZabbixBridgeURL からサービスエンドポイントのリストを取得します。
    • https://auth.mobilebridge.zabbix.com/oauth2/token にあるZabbix BridgeのIDプロバイダー(OAuth 2.0)からアクセストークンを取得します。
  • ブリッジアダプター → Bridge(gRPC: 443):
    • 起動時に、enroll.mobilebridge.zabbix.com:443 を介してZabbixサーバーを登録します(1回のみ)。
    • モバイルアプリからのクエリに対応するため、api.mobilebridge.zabbix.com:443 への接続を開いたままにします。
    • デバイス管理リクエストを register.mobilebridge.zabbix.com:443 に送信します。
    • プッシュ通知を api.mobilebridge.zabbix.com:443 に送信します。
  • モバイルアプリ → Bridge(HTTPS: 443):
    • https://config.mobilebridge.zabbix.com/.well-known/bridge-configuration からサービスエンドポイントのリストを取得します。
    • https://auth.mobilebridge.zabbix.com/oauth2/token にあるZabbix BridgeのIDプロバイダー(OAuth 2.0)からアクセストークンを取得します。
  • モバイルアプリ → Bridge(gRPC: 443):
    • デバイスを追加してQRコードをスキャンすると、enroll.mobilebridge.zabbix.com:443 を介してモバイルデバイスを登録します。
    • api.mobilebridge.zabbix.com:443 にクエリを送信します(たとえば、障害を更新するとき)。