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 na mesma conversa de e-mail.
Configuração
Para configurar email como o tipo de mídia:
- Acesse Alerts > Media types.
- Clique em Create media type (ou clique em Email na lista de tipos de mídia predefinidos).
A aba Media type contém atributos gerais do tipo de mídia:
Todos os campos obrigatórios são marcados com um asterisco vermelho.
A senha é exportada em texto claro ao exportar a configuração do tipo de mídia email.
Os parâmetros a seguir são específicos para o tipo de mídia email:
| Parameter | Description |
|---|---|
| Email provider | Selecione o provedor de email: Generic SMTP, Gmail, Gmail relay, Office365 ou Office365 relay. Se você selecionar as opções relacionadas ao Gmail/Office365, será necessário fornecer apenas o endereço de email do remetente e a senha; opções como SMTP server, SMTP server port, SMTP helo e Connection security serão preenchidas automaticamente pelo Zabbix. Veja também: Automated Gmail/Office365 media types. |
| SMTP server | Defina um servidor SMTP para processar mensagens de saída. Este campo está disponível se Generic SMTP estiver selecionado como provedor de email. |
| SMTP server port | Defina a porta do servidor SMTP para processar mensagens de saída. Este campo está disponível se Generic SMTP estiver selecionado como provedor de email. |
| O endereço informado aqui será usado como endereço From das mensagens enviadas. É compatível adicionar um nome de exibição do remetente (como "Zabbix_info" em Zabbix_info zabbix\@company.com na captura de tela acima) junto com o endereço de email real. Há algumas restrições sobre nomes de exibição em emails do Zabbix em comparação com o que é permitido pela RFC 5322, conforme ilustrado pelos exemplos: Exemplos válidos: zabbix\@company.com (apenas endereço de email, sem necessidade de usar colchetes angulares) Zabbix_info zabbix\@company.com (nome de exibição e endereço de email entre colchetes angulares) ∑Ω-monitoring zabbix\@company.com (caracteres UTF-8 no nome de exibição) Exemplos inválidos: Zabbix HQ zabbix\@company.com (nome de exibição presente, mas sem colchetes angulares ao redor do endereço de email) "Zabbix\@\<H(comment)Q\>" zabbix\@company.com (embora válido pela RFC 5322, pares entre aspas e comentários não são suportados em emails do Zabbix) |
|
| SMTP helo | Defina um valor correto para o SMTP helo, normalmente um nome de domínio. Se estiver vazio, o nome de domínio do email será enviado (ou seja, o que vem após @ no campo Email). Se não for possível obter o nome de domínio, um aviso em nível de depuração será registrado e o hostname do server será enviado como domínio para o comando HELO.Este campo está disponível se Generic SMTP estiver selecionado como provedor de email. |
| Connection security | Selecione o nível de segurança da conexão: None - não use a opção CURLOPT_USE_SSL STARTTLS - use a opção CURLOPT_USE_SSL com o valor CURLUSESSL_ALL SSL/TLS - o uso de CURLOPT_USE_SSL é opcional |
| SSL verify peer | Marque a caixa de seleção para verificar o certificado SSL do servidor SMTP. O valor da diretiva de configuração do server "SSLCALocation" deve ser colocado em CURLOPT_CAPATH para validação do certificado. Isso define a opção cURL CURLOPT_SSL_VERIFYPEER. |
| SSL verify host | 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. |
| Authentication | Selecione o nível de autenticação: None - nenhuma opção cURL é definida Username and password - 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 email Office365 relay. |
| Username | Nome de usuário a ser usado na autenticação. Isso define o valor de CURLOPT_USERNAME. User macros suportados. |
| Password | Senha a ser usada na autenticação. Isso define o valor de CURLOPT_PASSWORD. User macros suportados. O valor informado aqui é exportado como está quando a configuração do tipo de mídia é exportada. Para evitar expor credenciais sensíveis em arquivos exportados, use um user macro (por exemplo {$EMAIL_SMTP_PASSWORD}) em vez de uma senha literal — a referência ao macro será exportada, enquanto o valor secreto deve ser (re)configurado no sistema de destino. |
| OAuth tokens | Clique em Configure para definir parâmetros para recuperar OAuth tokens em uma nova janela. Este campo só está disponível se "OAuth" estiver selecionado no campo Authentication. |
| Message format | Selecione o formato da mensagem: HTML - enviar como HTML Plain text - enviar como texto simples |
Para habilitar a autenticação SMTP, o server Zabbix deve ser compilado com a opção de compilação --with-libcurl, que requer libcurl (veja os requisitos do server para detalhes sobre a versão).
Veja também common media type parameters 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 (consulte Padrões de URL OAuth por provedor).
Recuperação do token de acesso e atualização do OAuth
Após enviar os parâmetros do 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.
Teste
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 Test na última coluna da lista (uma janela de teste será aberta).
- Informe um endereço de destinatário em Send to, o corpo da mensagem e, opcionalmente, o assunto.
- Clique em Test para enviar uma mensagem de teste.
Uma mensagem de sucesso ou falha do teste 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.