Table of Contents
1 自動化されたGmail/Office365メディアタイプ
概要
GmailやOffice365のユーザーは、メディアタイプの設定における自動化機能の恩恵を受けることができます。
設定
メールメディアタイプのメールプロバイダーフィールドでは、GmailとOffice 365の事前設定されたオプションを選択できます。
Gmail/Office365関連のオプションを選択すると、送信者のメールアドレス/パスワードを入力するだけで、動作するメディアタイプを作成できます。
メールアドレス/パスワードが入力されると、ZabbixはGmail/Office365メディアタイプに必要なすべての設定（SMTPサーバー、SMTPサーバーポート、SMTP helo、接続のセキュリティ）を自動的に実際の/推奨値で入力できるようになります。この自動化により、これらのフィールドは表示されませんが、メディアタイプリストの詳細列でSMTPサーバーやメールの詳細を確認できます。
また、以下にも注意してください。
- リレーオプションの場合、パスワードは不要です。
- Office365リレーの場合、指定されたメールアドレスのドメイン名がSMTPサーバーを動的に入力するために使用されます（つまり、
example-com.mail.protection.outlook.comの"example.com"を実際の値に置き換えます）。
OAuthトークン
OAuthトークンの取得は、Gmail、Gmailリレー、Office365のメールプロバイダーに対して自動化されています。
OAuthのアクセストークンおよびリフレッシュトークンの取得には、Redirection endpoint、Client ID、Client secretという限られたパラメータのみを指定する必要があります。Zabbixは他の必要な値を自動的に入力します（プロバイダー別のOAuth URLデフォルト値を参照）。
これらのプロバイダーに対してOAuth認証を設定する場合、Generic SMTPフォームを使用することも可能です。
SmtpClientAuthenticationは、Office365でユーザー/共有メールボックスごと、またはテナント全体で有効にする必要があります（デフォルト設定では有効になっていません）。
プロバイダーごとの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ファイルに追加できます。
これにより、以下のような簡略化されたリダイレクトURLが使用できるようになります。
これにより、クエリパラメータ付きのURLの代わりにOffice365の個人アカウントとの互換性が確保されます。