Você está visualizando a documentação da versão de desenvolvimento, ela pode estar incompleta.
Junte-se ao nosso projeto de tradução e ajude a traduzir a documentação do Zabbix em sua língua nativa.

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 mesmo 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.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.