Table of Contents
1 E-mail
Visão geral
Para configurar o e-mail como canal de entrega de mensagens, é necessário configurar o e-mail como tipo de mídia e atribuir endereços específicos aos usuários.
Várias notificações para um único evento serão agrupadas no mesmo tópico de e-mail.
Configuração
Para configurar o e-mail como tipo de mídia:
- Vá para Alertas > Tipos de mídia.
- Clique em Criar tipo de mídia (ou clique em E-mail na lista de tipos de mídia predefinidos).
A aba Tipo de mídia contém os atributos gerais do tipo de mídia:
Todos os campos obrigatórios estão marcados com um asterisco vermelho.
A senha é exportada em texto claro ao exportar a configuração do tipo de mídia de e-mail.
Os seguintes parâmetros são específicos para o tipo de mídia de e-mail:
| Parâmetro | Descrição |
|---|---|
| Provedor de e-mail | Selecione o provedor de e-mail: SMTP genérico, Gmail, Gmail relay, Office365 ou Office365 relay. Se você selecionar as opções relacionadas ao Gmail/Office365, será necessário apenas fornecer o endereço de e-mail do remetente e a senha; opções como Servidor SMTP, Porta do servidor SMTP, SMTP helo e Segurança da conexão serão preenchidas automaticamente pelo Zabbix. Veja também: Tipos de mídia automatizados do Gmail/Office365. |
| Servidor SMTP | Defina um servidor SMTP para lidar com mensagens de saída. Este campo está disponível se SMTP genérico for selecionado como provedor de e-mail. |
| Porta do servidor SMTP | Defina a porta do servidor SMTP para lidar com mensagens de saída. Este campo está disponível se SMTP genérico for selecionado como provedor de e-mail. |
| O endereço inserido aqui será usado como o endereço De para as mensagens enviadas. Adicionar um nome de exibição do remetente (como "Zabbix_info" em Zabbix_info <[email protected]> na captura de tela acima) com o endereço de e-mail real é suportado. Existem algumas restrições para nomes de exibição em e-mails do Zabbix em comparação com o que é permitido pelo RFC 5322, conforme ilustrado pelos exemplos: Exemplos válidos: [email protected] (apenas endereço de e-mail, não é necessário usar colchetes angulares) Zabbix_info <[email protected]> (nome de exibição e endereço de e-mail entre colchetes angulares) ∑Ω-monitoring <[email protected]> (caracteres UTF-8 no nome de exibição) Exemplos inválidos: Zabbix HQ [email protected] (nome de exibição presente, mas sem colchetes angulares em torno do endereço de e-mail) "Zabbix\@\<H(comment)Q\>" <[email protected]> (embora válido pelo RFC 5322, pares entre aspas e comentários não são suportados em e-mails do Zabbix) |
|
| SMTP helo | Defina um valor SMTP helo correto, normalmente um nome de domínio. Se estiver vazio, será enviado o nome de domínio do e-mail (ou seja, o que vem após @ no campo E-mail). Se não for possível obter o nome de domínio, um aviso de nível de depuração será registrado e o nome do host do servidor será enviado como domínio para o comando HELO.Este campo está disponível se SMTP genérico for selecionado como provedor de e-mail. |
| Segurança da conexão | Selecione o nível de segurança da conexão: Nenhum - não usar a opção CURLOPT_USE_SSL STARTTLS - usar a opção CURLOPT_USE_SSL com valor CURLUSESSL_ALL SSL/TLS - o uso de CURLOPT_USE_SSL é opcional |
| Verificar par SSL | Marque a caixa de seleção para verificar o certificado SSL do servidor SMTP. O valor da diretiva de configuração do servidor "SSLCALocation" deve ser colocado em CURLOPT_CAPATH para validação do certificado. Isso define a opção cURL CURLOPT_SSL_VERIFYPEER. |
| Verificar host SSL | Marque a caixa de seleção para verificar se o campo Common Name ou o campo Subject Alternate Name do certificado do servidor SMTP corresponde. Isso define a opção cURL CURLOPT_SSL_VERIFYHOST. |
| Autenticação | Selecione o nível de autenticação: Nenhum - nenhuma opção cURL é definida Nome de usuário e senha - implica "AUTH=*" deixando a escolha do mecanismo de autenticação para o cURL OAuth - autenticação OAuth A autenticação OAuth não é suportada para o provedor de e-mail Office365 relay. |
| Nome de usuário | Nome de usuário para usar na autenticação. Isso define o valor de CURLOPT_USERNAME. Macros de usuário suportadas. |
| Senha | Senha para usar na autenticação. Isso define o valor de CURLOPT_PASSWORD. Macros de usuário suportadas. O valor inserido aqui é exportado como está ao exportar a configuração do tipo de mídia. Para evitar expor credenciais confidenciais em arquivos exportados, use uma macro de usuário (por exemplo, {$EMAIL_SMTP_PASSWORD}) em vez de uma senha literal — a referência da macro será exportada enquanto o valor secreto deve ser (re)configurado no sistema de destino. |
| Tokens OAuth | Clique em Configurar para definir os parâmetros para recuperar tokens OAuth em uma nova janela. Este campo só está disponível se "OAuth" for selecionado no campo Autenticação. |
| Formato da mensagem | Selecione o formato da mensagem: HTML - enviar como HTML Texto simples - enviar como texto simples |
Para habilitar a autenticação SMTP, o servidor Zabbix deve ser compilado com a opção de compilação --with-libcurl, que requer o libcurl (veja os requisitos do servidor para detalhes da versão).
Veja também parâmetros comuns de tipo de mídia para detalhes sobre como configurar mensagens padrão e opções de processamento de alertas.
Tokens OAuth
Os seguintes parâmetros são necessários para recuperar tokens OAuth:
| Parâmetro | Descrição |
|---|---|
| Redirection endpoint | Insira a URL do frontend do Zabbix para onde o serviço OAuth irá redirecionar a autorização OAuth (usando o formato https://<zabbix-frontend-url>/zabbix.php?action=oauth.authorize).É definido automaticamente para um novo tipo de mídia de e-mail quando a URL do frontend está definida. |
| Client ID | Insira o identificador exclusivo do aplicativo cliente registrado no servidor de autorização OAuth. |
| Client secret | Insira o segredo privado do aplicativo cliente registrado no servidor de autorização OAuth. |
| Authorization endpoint | Insira a URL do servidor de autorização OAuth para solicitar a autorização do usuário. |
| Authorization parameters | Insira os parâmetros para o endpoint de autorização. |
| Authorization code | Insira o código de autorização: Automático - o código será recuperado automaticamente por meio de uma página de redirecionamento Manual - insira o código manualmente se a recuperação automática falhar |
| Token endpoint | Insira a URL do servidor de autorização OAuth para trocar o código de autorização por tokens de acesso e atualização. |
| Token parameters | Insira os parâmetros para o token de acesso. |
A recuperação de tokens OAuth possui recursos automatizados para os provedores de e-mail Gmail, Gmail relay e Office365. É necessário apenas fornecer os valores dos parâmetros Redirection endpoint, Client ID e Client secret. O Zabbix preencherá automaticamente os outros valores necessários (veja Padrões de URL OAuth por provedor).
Recuperação do token de acesso e atualização do OAuth
Após o envio dos parâmetros OAuth:
Uma janela pop-up do navegador é aberta, direcionando o usuário para o ponto de extremidade de autorização.
O usuário autoriza o Zabbix no serviço OAuth.
O serviço OAuth redireciona o usuário para a ação do frontend do Zabbix
oauth.authorizecom o código de autorização e o valor do escopo.Em resposta, o Zabbix fará uma solicitação ao ponto de extremidade do token para trocar o código de autorização por tokens de acesso e atualização.
Testando
Para testar se um tipo de mídia de e-mail configurado funciona corretamente:
- Localize o e-mail relevante na lista de tipos de mídia.
- Clique em Testar na última coluna da lista (uma janela de teste será aberta).
- Insira um endereço de destinatário em Enviar para, o corpo da mensagem e, opcionalmente, o assunto.
- Clique em Testar para enviar uma mensagem de teste.
Uma mensagem de sucesso ou falha será exibida na mesma janela:
Mídia do usuário
Depois que o tipo de mídia de e-mail estiver configurado, vá para a seção Usuários > Usuários e edite o perfil do usuário para atribuir a mídia de e-mail ao usuário. As etapas para configurar a mídia do usuário, comuns a todos os tipos de mídia, estão descritas na página Tipos de mídia.