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):
ZabbixAPIURLport) - forwards requests from the mobile app, ifAllowedAPIMethodsallows it. - Health-check client → Bridge adapter (HTTP:
ListenHealthPort) - checks the/healthand/readyendpoints (e.g., from a load balancer or container orchestrator), ifListenHealthPortis 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.
- When started, retrieves a list of service endpoints from
- 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:443for queries from the mobile app. - Sends device management requests to
register.mobilebridge.zabbix.com:443. - Sends push notifications to
api.mobilebridge.zabbix.com:443.
- When started, enrolls (only once) Zabbix server through
- 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.
- Retrieves a list of service endpoints from
- 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).
- When you add your device and scan the QR code, enrolls the mobile device through