Documentation
Table of Contents
1 Tipos de mídia automatizados do Gmail/Office365
Visão geral
Usuários do Gmail ou Office365 podem se beneficiar de recursos automatizados na configuração do tipo de mídia.
Configuração
O campo Provedor de e-mail na configuração do tipo de mídia de e-mail permite selecionar opções pré-configuradas para Gmail e Office 365.
Ao selecionar as opções relacionadas ao Gmail/Office365, é necessário apenas fornecer o endereço de e-mail/senha do remetente para criar um tipo de mídia funcional.
Assim que o endereço de e-mail/senha for fornecido, o Zabbix será capaz de preencher automaticamente todas as configurações necessárias para os tipos de mídia Gmail/Office365 com os valores reais/recomendados, ou seja, Servidor SMTP, Porta do servidor SMTP, SMTP helo e Segurança da conexão. Devido a essa automação, esses campos nem são exibidos, no entanto, é possível ver os detalhes do servidor SMTP e do e-mail na lista de tipos de mídia (veja a coluna Detalhes).
Observe também que:
- A senha não é necessária para as opções de relay.
- Para o relay do Office365, o nome de domínio do endereço de e-mail fornecido será usado para preencher dinamicamente o servidor SMTP (ou seja, substituir "example.com" em
example-com.mail.protection.outlook.compelo valor real).
Tokens OAuth
A obtenção de tokens OAuth possui recursos automatizados para os provedores de e-mail Gmail, Gmail relay e Office365.
É necessário fornecer apenas um conjunto limitado de parâmetros para a obtenção do token de acesso e do token de atualização do OAuth - Redirection endpoint, Client ID e Client secret. O Zabbix preencherá automaticamente os outros valores necessários (consulte Padrões de URL OAuth por provedor).
Observe que também é possível usar o formulário SMTP genérico para configurar a autorização OAuth para esses provedores.
O SmtpClientAuthentication deve ser habilitado por usuário/caixa de correio compartilhada ou para todo o tenant no Office365 (não habilitado por padrão).
URLs OAuth padrão por provedor
A tabela a seguir lista os valores e parâmetros padrão de URLs OAuth por provedor que são usados pelo Zabbix.
| Parâmetro | Gmail | Office365 | SMTP genérico | |
|---|---|---|---|---|
| Ponto de extremidade de autorização | https://accounts.google.com/o/oauth2/v2/auth |
https://login.microsoftonline.com/common/oauth2/v2.0/authorize |
Sem padrão | |
| scope | https://mail.google.com |
https://outlook.office.com/SMTP.Send, offline_access |
Sem padrão | |
| access_type | offline |
Não usado | Sem padrão | |
| prompt | consent |
Não usado | Sem padrão | |
| redirect_uri | O valor do campo Ponto de extremidade de redirecionamento é adicionado automaticamente pelo código. Não listado nos parâmetros de Ponto de extremidade de autorização. | |||
| state | Hash exclusivo para identificar a mídia sendo atualizada com o token OAuth é adicionado automaticamente pelo código. Não listado nos parâmetros de Ponto de extremidade de autorização. | |||
| Ponto de extremidade do token | https://oauth2.googleapis.com/token |
https://login.microsoftonline.com/common/oauth2/v2.0/token |
Sem padrão | |
| grant_type | authorization_code |
authorization_code |
Sem padrão | |
| redirect_uri | O valor do campo Ponto de extremidade de redirecionamento é adicionado automaticamente pelo código. Não listado nos parâmetros de Ponto de extremidade do token. | |||
| state | Hash exclusivo para identificar a mídia sendo atualizada com o token OAuth é adicionado automaticamente pelo código. Não listado nos parâmetros de Ponto de extremidade do token. | |||
Solução alternativa do Office365 para contas pessoais
As contas pessoais do Office365 não suportam strings de consulta na URL de redirecionamento.
Para contornar esse problema, o administrador do servidor Apache pode adicionar a seguinte regra de reescrita ao arquivo .htaccess:
Isso permite o uso de uma URL de redirecionamento simplificada como:
em vez de uma URL com parâmetros de consulta, garantindo a compatibilidade com contas pessoais do Office365.