Acesso móvel seguro

Esta página contém práticas recomendadas para manter o aplicativo móvel do Zabbix e o adaptador Zabbix bridge seguros.

Proteger dispositivos móveis

Para impedir que outras pessoas abram o aplicativo no seu dispositivo móvel, ative o bloqueio do aplicativo em Configurações.

Se um dispositivo for perdido ou comprometido, remova-o na interface web do Zabbix. Isso revoga e remove suas credenciais de acesso, impedindo que o dispositivo acesse o Zabbix. Dependendo das permissões da sua função de usuário, você pode remover dispositivos nas seguintes seções:

Você também pode limitar quais partes do Zabbix podem ser acessadas de um dispositivo móvel. Para isso, atribua aos usuários uma função de usuário que conceda apenas as permissões necessárias para o aplicativo. As permissões mínimas são as seguintes:

Seção Configuração
Acesso aos elementos da interface Desmarque todas as caixas de seleção.
Acesso aos serviços Defina Acesso de leitura e gravação aos serviços e Acesso somente leitura aos serviços como None.
Acesso aos módulos Desmarque todas as caixas de seleção.
Acesso à API Desmarque a caixa de seleção Habilitado.
Acesso às ações Desmarque todas as caixas de seleção.

Para permitir que os usuários atualizem problemas no aplicativo, marque também as ações necessárias:
- Adicionar comentários aos problemas
- Alterar a severidade
- Confirmar problemas
- Suprimir problemas
- Fechar problemas

Observe que os problemas que os usuários podem ver no aplicativo também dependem do acesso aos hosts.

Para permitir que os usuários alterem quais notificações push recebem (por exemplo, severidades e períodos de atividade), marque também Criar e editar a própria mídia. Isso permite que eles editem sua mídia, incluindo mídias que não sejam notificações push.
Dispositivos Marque a caixa de seleção Habilitado.

Para permitir que os usuários adicionem e removam seus próprios dispositivos móveis, marque também a caixa de seleção Gerenciar os próprios dispositivos; caso contrário, um Super admin deverá gerenciar os dispositivos deles em Usuários > Dispositivos.

Proteger o adaptador de bridge do Zabbix

O adaptador de bridge do Zabbix armazena seus dados (arquivo de estado e chaves de criptografia) no diretório especificado no parâmetro DataDir do arquivo de configuração do adaptador de bridge do Zabbix. Certifique-se de que o diretório tenha permissões 0700 e que todos os arquivos armazenados nele tenham permissões 0600.

O adaptador de bridge do Zabbix encaminha solicitações de dispositivos móveis para a API do Zabbix. Para restringir quais métodos da API podem ser chamados por meio do adaptador de bridge do Zabbix, use o parâmetro AllowedAPIMethods. Por exemplo, permita apenas o conjunto mínimo de métodos exigido pelo aplicativo móvel ou até mesmo menos métodos, caso não queira que alguns recursos do aplicativo móvel sejam usados (por exemplo, não permita event.acknowledge se os usuários do aplicativo móvel não devem atualizar problemas).

O adaptador de bridge do Zabbix aceita conexões do server do Zabbix em sua ListenPort. A menos que TLSConfig.Mode esteja definido como mtls, o adaptador de bridge do Zabbix aceita essas conexões de qualquer host que possa acessar essa porta. Permita conexões nessa porta somente do server do Zabbix (por exemplo, usando um firewall ou definindo ListenIP como 127.0.0.1 se o adaptador de bridge do Zabbix e o server do Zabbix forem executados no mesmo sistema) ou use mTLS.

Os endpoints de verificação de integridade do adaptador de bridge do Zabbix em ListenHealthPort sempre usam HTTP não criptografado e sem autenticação, e suas mensagens de erro podem revelar detalhes sobre o seu ambiente. Se essa porta estiver acessível a partir de redes não confiáveis, restrinja o acesso a ela (por exemplo, usando um firewall).

Criptografar conexões entre componentes

Se o adaptador de bridge do Zabbix, o Zabbix server e o Zabbix frontend (que fornece a API do Zabbix) estiverem instalados em sistemas separados, é recomendável criptografar o fluxo de dados entre eles. Esta seção fornece orientações para proteger essas conexões:

  • Do Zabbix server para o adaptador de bridge do Zabbix
  • Do adaptador de bridge do Zabbix para o Zabbix frontend (API)

Esta seção não descreve como gerenciar certificados. Para obter orientações gerais, consulte Criptografia usando certificados.

TLS do Zabbix server para o adaptador de bridge do Zabbix

O Zabbix server usa a URL especificada no parâmetro BridgeAdapterURL para se conectar ao adaptador de bridge do Zabbix. O adaptador de bridge usa o parâmetro TLSConfig.Mode para determinar quais conexões aceita:

  • none (padrão) - somente conexões não criptografadas. BridgeAdapterURL deve usar http://.
  • tls - somente conexões criptografadas; o adaptador de bridge apresenta seu certificado ao Zabbix server. BridgeAdapterURL deve usar https://.
  • mtls - além de tls, o adaptador de bridge verifica o certificado do cliente do Zabbix server.

Para configurar tls:

1. Escolha qual CA emitirá o certificado do adaptador de bridge do Zabbix:

  • A CA que emitiu os certificados já utilizados pelo Zabbix server - escolha esta opção se o Zabbix server usa criptografia baseada em certificados com proxies ou agents do Zabbix (os parâmetros TLSCAFile, TLSCertFile e TLSKeyFile estão definidos).
  • Uma CA cujo certificado esteja no armazenamento de CAs do sistema operacional em que o Zabbix server está instalado (por exemplo, uma CA pública).
  • Qualquer outra CA (por exemplo, uma CA privada da sua organização).

2. Se você escolheu qualquer outra CA na etapa 1, prepare os seguintes arquivos no sistema em que o Zabbix server está instalado, todos no formato PEM:

  • Um arquivo de CA com o certificado da CA escolhida.
  • Um certificado (ou cadeia de certificados) para o server, emitido pela CA escolhida.
  • Uma chave privada para o server; certifique-se de que ela possa ser lida somente pelo usuário que o executa (normalmente, zabbix).

3. Edite o arquivo de configuração do Zabbix server:

BridgeAdapterURL=https://zabbix-bridge-adapter.example.com:10054/rpc

# Se você escolheu qualquer outra CA na etapa 1 (já definido se você escolheu a CA já utilizada pelo Zabbix server):
TLSCAFile=/etc/zabbix/certs/zabbix_ca_file.crt
TLSCertFile=/etc/zabbix/certs/zabbix_server.crt
TLSKeyFile=/etc/zabbix/certs/zabbix_server.key

4. No sistema em que o adaptador de bridge do Zabbix está instalado, prepare os seguintes arquivos, todos no formato PEM:

  • Um certificado (ou cadeia de certificados) para o adaptador de bridge, emitido pela CA escolhida; certifique-se de que a extensão Subject Alternative Name (SAN) contenha o nome do host ou o endereço IP da BridgeAdapterURL do Zabbix server.
  • Uma chave privada para o adaptador de bridge; certifique-se de que ela possa ser lida somente pelo usuário que o executa (normalmente, zabbix-bridge-adapter).

5. Edite o arquivo de configuração do adaptador de bridge do Zabbix:

TLSConfig.Mode=tls
TLSConfig.CertFile=/etc/zabbix/certs/zabbix_bridge_adapter.crt
TLSConfig.KeyFile=/etc/zabbix/certs/zabbix_bridge_adapter.key

6. Reinicie o adaptador de bridge do Zabbix:

systemctl restart zabbix-bridge-adapter

7. Reinicie o Zabbix server. Por exemplo (consulte outras opções):

systemctl restart zabbix-server

Para configurar mtls:

1. Escolha qual CA emitirá os certificados do Zabbix server e do adaptador de bridge do Zabbix:

2. Se você escolheu qualquer outra CA na etapa 1, prepare os seguintes arquivos no sistema em que o Zabbix server está instalado, todos no formato PEM:

  • Um arquivo de CA com o certificado da CA escolhida.
  • Um certificado (ou cadeia de certificados) para o server, emitido pela CA escolhida.
  • Uma chave privada para o server; certifique-se de que ela possa ser lida somente pelo usuário que o executa (normalmente, zabbix).

3. Edite o arquivo de configuração do Zabbix server:

BridgeAdapterURL=https://zabbix-bridge-adapter.example.com:10054/rpc

# Já definido se você escolheu a CA já utilizada pelo Zabbix server:
TLSCAFile=/etc/zabbix/certs/zabbix_ca_file.crt
TLSCertFile=/etc/zabbix/certs/zabbix_server.crt
TLSKeyFile=/etc/zabbix/certs/zabbix_server.key

4. No sistema em que o adaptador de bridge do Zabbix está instalado, prepare os seguintes arquivos, todos no formato PEM:

  • Um arquivo de CA com o certificado da CA escolhida (mesmo que seja uma CA pública, pois o adaptador de bridge não usa o armazenamento de CAs do sistema operacional).
  • Um certificado (ou cadeia de certificados) para o adaptador de bridge, emitido pela CA escolhida; certifique-se de que a extensão Subject Alternative Name (SAN) contenha o nome do host ou o endereço IP da BridgeAdapterURL do Zabbix server.
  • Uma chave privada para o adaptador de bridge; certifique-se de que ela possa ser lida somente pelo usuário que o executa (normalmente, zabbix-bridge-adapter).

5. Edite o arquivo de configuração do adaptador de bridge do Zabbix:

TLSConfig.Mode=mtls
TLSConfig.CertFile=/etc/zabbix/certs/zabbix_bridge_adapter.crt
TLSConfig.KeyFile=/etc/zabbix/certs/zabbix_bridge_adapter.key
TLSConfig.CAFile=/etc/zabbix/certs/zabbix_ca_file.crt

# Common Name (CN) do certificado do Zabbix server (correspondência exata e com distinção entre maiúsculas e minúsculas; SANs não são verificados):
TLSConfig.AllowedCN=zabbix-server

6. Reinicie o adaptador de bridge do Zabbix:

systemctl restart zabbix-bridge-adapter

7. Reinicie o Zabbix server. Por exemplo (consulte outras opções):

systemctl restart zabbix-server

TLS do adaptador bridge do Zabbix para a API do Zabbix

O adaptador bridge do Zabbix usa a URL especificada no parâmetro ZabbixAPIURL para se conectar à API do Zabbix. O adaptador bridge usa o parâmetro ZabbixAPITLSConnect para determinar com que rigor ele verifica o certificado do frontend do Zabbix:

  • disabled - a conexão não é criptografada. Somente com esta opção, ZabbixAPIURL deve usar http://.
  • required (padrão) - a conexão é criptografada, mas o adaptador bridge aceita qualquer certificado.
  • verify_ca - a conexão é criptografada, e o certificado deve ter sido emitido por uma CA do arquivo ZabbixAPITLSCAFile.
  • verify_full - a conexão é criptografada, o certificado deve ter sido emitido por uma CA do arquivo ZabbixAPITLSCAFile, e o nome do host em ZabbixAPIURL deve corresponder ao certificado.

Para configurar required, verify_ca ou verify_full:

1. No sistema em que o frontend do Zabbix está instalado, certifique-se de que:

  • O frontend do Zabbix é servido por HTTPS (consulte Configuração de SSL para o frontend do Zabbix).
  • Para verify_full, a extensão Subject Alternative Name (SAN) do certificado do frontend do Zabbix contém o nome do host ou o endereço IP de ZabbixAPIURL do adaptador bridge.

2. Para verify_ca e verify_full, no sistema em que o adaptador bridge do Zabbix está instalado, prepare um arquivo PEM com o certificado da CA que emitiu o certificado do frontend do Zabbix.

  • Se o certificado do frontend do Zabbix for autoassinado, o arquivo deverá conter o próprio certificado do frontend do Zabbix.
  • Se o certificado do frontend do Zabbix tiver sido emitido por uma CA pública, o arquivo poderá ser o pacote de CAs do sistema operacional (por exemplo, /etc/ssl/certs/ca-certificates.crt no Ubuntu). O adaptador bridge usa certificados de CA somente deste arquivo, e não do armazenamento de CAs do sistema operacional.
  • Certifique-se de que o arquivo PEM possa ser lido pelo usuário que executa o adaptador bridge (normalmente, zabbix-bridge-adapter).

3. Edite o arquivo de configuração do adaptador bridge do Zabbix:

ZabbixAPIURL=https://zabbix.example.com/zabbix/api_jsonrpc.php

# For required, verify_ca, or verify_full:
ZabbixAPITLSConnect=verify_full

# For verify_ca or verify_full:
ZabbixAPITLSCAFile=/etc/zabbix/certs/zabbix_api_ca.crt

4. Reinicie o adaptador bridge do Zabbix:

systemctl restart zabbix-bridge-adapter