Bridge adapter

Zabbix bridge adapter lets your Zabbix server communicate with Zabbix mobile app.

Zabbix mobile app doesn't connect to your Zabbix server directly. Instead, two components pass data between them:

  • Zabbix Bridge - a centrally hosted service that exchanges data with Zabbix mobile app on your mobile device.
  • Zabbix bridge adapter - a component that you install and run. It connects your Zabbix server to Zabbix Bridge.

The bridge adapter can be installed on the same system as your Zabbix server, or on a different system, using packages.

To configure Zabbix bridge adapter, update its configuration file (default path: /etc/zabbix/zabbix_bridge_adapter.conf).

To keep Zabbix bridge adapter secure, see Secure mobile access.

Network connections

Zabbix bridge adapter initiates all connections to Zabbix Bridge, so you do not need to allow incoming internet connections.

The following connections stay within your network:

  • Zabbix server → Bridge adapter (HTTP(S): ListenPort) - sends push notifications and device management requests.
  • Bridge adapter → Zabbix API (HTTP(S): ZabbixAPIURL port) - forwards requests from the mobile app, if AllowedAPIMethods allows it.
  • Health-check client → Bridge adapter (HTTP: ListenHealthPort) - checks the /health and /ready endpoints (e.g., from a load balancer or container orchestrator), if ListenHealthPort is set.

You can encrypt the connections between Zabbix server, Zabbix bridge adapter, and Zabbix API.

The following connections go over the internet (always encrypted, TLS 1.2/1.3):

  • Bridge adapter → Bridge (HTTPS: 443):
    • When started, retrieves a list of service endpoints from ZabbixBridgeURL.
    • Gets an access token from the Zabbix Bridge identity provider (OAuth 2.0) at https://auth.mobilebridge.zabbix.com/oauth2/token.
  • Bridge adapter → Bridge (gRPC: 443):
    • When started, enrolls (only once) Zabbix server through enroll.mobilebridge.zabbix.com:443.
    • Keeps an open connection to api.mobilebridge.zabbix.com:443 for queries from the mobile app.
    • Sends device management requests to register.mobilebridge.zabbix.com:443.
    • Sends push notifications to api.mobilebridge.zabbix.com:443.
  • Mobile app → Bridge (HTTPS: 443):
    • Retrieves a list of service endpoints from https://config.mobilebridge.zabbix.com/.well-known/bridge-configuration.
    • Gets an access token from the Zabbix Bridge identity provider (OAuth 2.0) at https://auth.mobilebridge.zabbix.com/oauth2/token.
  • Mobile app → Bridge (gRPC: 443):
    • When you add your device and scan the QR code, enrolls the mobile device through enroll.mobilebridge.zabbix.com:443.
    • Sends queries to api.mobilebridge.zabbix.com:443 (e.g., when you update problems).