自動化された Gmail/Office365 メディアタイプ

概要

GmailやOffice365のユーザーは、メディアタイプの設定における自動化機能の恩恵を受けることができます。

設定

メールメディアタイプの設定にある Email provider フィールドでは、Gmail と Office 365 用に事前設定されたオプションを選択できます。

Gmail/Office365 関連のオプションを選択する場合、動作するメディアタイプを作成するために必要なのは、送信者のメールアドレスとパスワードの入力だけです。

メールアドレスとパスワードを入力すると、Zabbix は Gmail/Office365 メディアタイプに必要なすべての設定に、実際の値または推奨値を自動的に入力できます。対象となる設定は、SMTP server、SMTP server port、SMTP helo、Connection security です。 この自動化により、これらのフィールドは表示されません。ただし、メディアタイプの一覧で SMTP サーバーとメールの詳細を確認できます(Details 列を参照)。

また、次の点にも注意してください。

  • リレーオプションでは、パスワードは必要ありません。
  • Office365 リレーでは、指定したメールアドレスのドメイン名が SMTP サーバーに動的に入力されます(example-com.mail.protection.outlook.com の "example.com" が実際の値に置き換えられます)。

OAuthトークン

Gmail、Gmailリレー、およびOffice365のメールプロバイダーでは、OAuthトークンの取得が自動化されています。

OAuthのアクセスおよびリフレッシュトークンを取得するために、リダイレクトエンドポイント、クライアントID、クライアントシークレットという限られたパラメータのみを指定する必要があります。 Zabbixは、その他の必要な値を自動的に入力します(プロバイダー別のOAuth URLのデフォルト値を参照)。

これらのプロバイダーでOAuth認証を設定する場合、Generic SMTPフォームを使用することもできます。

Office365では、ユーザーまたは共有メールボックス単位、あるいはテナント全体でSmtpClientAuthenticationを有効にする必要があります(デフォルト設定では有効になっていません)。

プロバイダーごとのOAuth URLのデフォルト

以下の表は、Zabbixで使用されるプロバイダーごとのデフォルトのOAuth URL値とパラメーターを示しています。

パラメーター Gmail Office365 Generic SMTP
認可エンドポイント https://accounts.google.com/o/oauth2/v2/auth https://login.microsoftonline.com/common/oauth2/v2.0/authorize デフォルトなし
scope https://mail.google.com https://outlook.office.com/SMTP.Send, offline_access デフォルトなし
access_type offline 未使用 デフォルトなし
prompt consent 未使用 デフォルトなし
redirect_uri Redirection endpointフィールドの値が自動的にコードで追加されます。Authorization endpointパラメーターには記載されません。
state OAuthトークンで更新されるメディアを識別する一意のハッシュが自動的にコードで追加されます。Authorization endpointパラメーターには記載されません。
トークンエンドポイント https://oauth2.googleapis.com/token https://login.microsoftonline.com/common/oauth2/v2.0/token デフォルトなし
grant_type authorization_code authorization_code デフォルトなし
redirect_uri Redirection endpointフィールドの値が自動的にコードで追加されます。Token endpointパラメーターには記載されません。
state OAuthトークンで更新されるメディアを識別する一意のハッシュが自動的にコードで追加されます。Token endpointパラメーターには記載されません。

Office365の個人アカウントの回避策

Office365の個人アカウントは、リダイレクトURLのクエリ文字列をサポートしていません。

この問題を回避するために、Apacheウェブサーバーの管理者は、以下のリライトルールを.htaccessファイルに追加できます。

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

これにより、以下のような簡略化されたリダイレクトURLが使用できるようになります。

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

これにより、クエリパラメータ付きのURLの代わりにOffice365の個人アカウントとの互換性が確保されます。