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 email na configuração do tipo de mídia de email permite selecionar opções pré-configuradas para Gmail e Office 365.

Ao selecionar as opções relacionadas ao Gmail/Office365, é necessário fornecer apenas o endereço de email e a senha do remetente para criar um tipo de mídia funcional.

Assim que o endereço de email e a senha forem fornecidos, o Zabbix poderá preencher automaticamente todas as configurações necessárias para os tipos de mídia Gmail/Office365 com os valores reais/recomendados, ou seja, server SMTP, porta do server SMTP, helo SMTP e segurança da conexão. Devido a essa automação, esses campos nem sequer são exibidos. No entanto, é possível ver o server SMTP e os detalhes do email na lista de tipos de mídia (consulte 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 email fornecido será usado para preencher dinamicamente o server SMTP (ou seja, substituir "example.com" em example-com.mail.protection.outlook.com pelo 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 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 está habilitado por padrão).

Padrões de URL OAuth por provedor

A tabela a seguir lista os valores padrão de URL OAuth e parâmetros por provedor que são usados pelo Zabbix.

Parâmetro Gmail Office365 SMTP genérico
Authorization endpoint 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 Redirection endpoint é adicionado pelo código automaticamente. Não listado nos parâmetros de Authorization endpoint.
state Hash exclusivo para identificar a mídia sendo atualizada com o token OAuth é adicionado pelo código automaticamente. Não listado nos parâmetros de Authorization endpoint.
Token endpoint 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 Redirection endpoint é adicionado pelo código automaticamente. Não listado nos parâmetros de Token endpoint.
state Hash exclusivo para identificar a mídia sendo atualizada com o token OAuth é adicionado pelo código automaticamente. Não listado nos parâmetros de Token endpoint.

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:

RewriteEngine On
RewriteRule ^/oauth\.authorize$ /zabbix.php?action=oauth.authorize [QSA,L,PT]

Isso permite o uso de uma URL de redirecionamento simplificada como:

http://server-name/zabbix/oauth.authorize

em vez de uma URL com parâmetros de consulta, garantindo a compatibilidade com contas pessoais do Office365.