Adaptador bridge

O adaptador bridge do Zabbix permite que seu server Zabbix se comunique com o aplicativo móvel do Zabbix.

O aplicativo móvel do Zabbix não se conecta diretamente ao seu server Zabbix. Em vez disso, dois componentes transferem dados entre eles:

  • Zabbix Bridge - um serviço hospedado centralmente que troca dados com o aplicativo móvel do Zabbix em seu dispositivo móvel.
  • Adaptador bridge do Zabbix - um componente que você instala e executa. Ele conecta seu server Zabbix ao Zabbix Bridge.

O adaptador bridge pode ser instalado no mesmo sistema que o seu server Zabbix ou em um sistema diferente, usando pacotes.

Para configurar o adaptador bridge do Zabbix, atualize seu arquivo de configuração (caminho padrão: /etc/zabbix/zabbix_bridge_adapter.conf).

Para manter o adaptador bridge do Zabbix seguro, consulte Acesso móvel seguro.

Conexões de rede

O adaptador de bridge do Zabbix inicia todas as conexões com o Zabbix Bridge, portanto, não é necessário permitir conexões de entrada da internet.

As conexões a seguir permanecem dentro da sua rede:

  • Zabbix server → adaptador de bridge (HTTP(S): ListenPort) - envia notificações push e solicitações de gerenciamento de dispositivos.
  • Adaptador de bridge → API do Zabbix (HTTP(S): porta ZabbixAPIURL) - encaminha solicitações do aplicativo móvel, se AllowedAPIMethods permitir.
  • Cliente de verificação de integridade → adaptador de bridge (HTTP: ListenHealthPort) - verifica os endpoints /health e /ready (por exemplo, a partir de um balanceador de carga ou orquestrador de contêineres), se ListenHealthPort estiver definido.

Você pode criptografar as conexões entre o Zabbix server, o adaptador de bridge do Zabbix e a API do Zabbix.

As conexões a seguir passam pela internet (sempre criptografadas, TLS 1.2/1.3):

  • Adaptador de bridge → Bridge (HTTPS: 443):
    • Ao ser iniciado, recupera uma lista de endpoints de serviço de ZabbixBridgeURL.
    • Obtém um token de acesso do provedor de identidade do Zabbix Bridge (OAuth 2.0) em https://auth.mobilebridge.zabbix.com/oauth2/token.
  • Adaptador de bridge → Bridge (gRPC: 443):
    • Ao ser iniciado, registra (apenas uma vez) o Zabbix server por meio de enroll.mobilebridge.zabbix.com:443.
    • Mantém uma conexão aberta com api.mobilebridge.zabbix.com:443 para consultas do aplicativo móvel.
    • Envia solicitações de gerenciamento de dispositivos para register.mobilebridge.zabbix.com:443.
    • Envia notificações push para api.mobilebridge.zabbix.com:443.
  • Aplicativo móvel → Bridge (HTTPS: 443):
    • Recupera uma lista de endpoints de serviço de https://config.mobilebridge.zabbix.com/.well-known/bridge-configuration.
    • Obtém um token de acesso do provedor de identidade do Zabbix Bridge (OAuth 2.0) em https://auth.mobilebridge.zabbix.com/oauth2/token.
  • Aplicativo móvel → Bridge (gRPC: 443):
    • Quando você adiciona seu dispositivo e escaneia o código QR, registra o dispositivo móvel por meio de enroll.mobilebridge.zabbix.com:443.
    • Envia consultas para api.mobilebridge.zabbix.com:443 (por exemplo, quando você atualiza os problemas).