概要
Management Console の OAuth のアプリケーション設定にて、OAuth アプリケーションを Microsoft
Azure 2.0 で作成する場合、アプリケーションにユーザーを追加すると、「テナント」と呼ばれる追加のパラメータが表示されます。テナント ID をこのパラメータに入力することにより、シングルテナント アプリケーションを操作できるようになります。v11.4 は、管理コンソールのトリガーを使用して、Microsoft Office 365 電子メールでの認証に OAuth をサポートします。
詳細(設定例：Microsoft Office 365 の電子メールトリガーに OAuth 認証)
| 目次 | セクション |
| １．Microsoft Azure に Web アプリを登録します | |
| ２．Microsoft Azure で API 権限を有効にします | |
| ３．MC に Microsoft Azure AD 2.0 の OAuth アプリケーションを作成します | |
| ４．OAuth ユーザーを追加します | |
| ５．電子メールアカウントを設定します | |
| ６．電子メールトリガーを設定します |
１．Microsoft Azure に Web アプリを登録します
①Office365 のメールアカウントで Microsoft Azure ポータルにログインします。
②「Microsoft Entra ID」を選択します。
③「アプリの登録」を選択します。
④「新規登録」をクリックします。
⑤下記のように設定し、「登録」ボタンをクリックします。
・名前：任意
・リダイレクト：「web」を選択し、url に「"mc の url"+"/OAuthCallback"」を入力します。
リダイレクトURLを確認するために、MCのリポジトリ > OAuthから新しいアプリケーションを作成する際に、作成用のダイアログにリダイレクトURLが表示されます。
| MCのアクセスプロトコル | 注意点 | 例 |
| HTTP |
localhostでMCのTomcatサーバー内で行う必要があります。MCのTomcatサーバーのブラウザーを立ち上げ、MC画面にアクセスし、OAuthアプリケーションを作成します。 該当ブラウザーでMicrosoft Azure ポータルにログオンする必要もあります。 |
http://localhost:8080/mc/OAuthCallback |
| HTTPS | MCをHTTPS化している場合、MCのTomcatサーバーのホスト名での指定が可能になります。そして、本ナレッジの操作は「MCのTomcatサーバー」に限定されません。MCにアクセスできる端末であれば本作業は行えます。 |
https://mc.tomcat.machine:8443/mc/OAuthCallback |
以下はHTTP/localhostで入力した結果になります。
⑥「証明書とシークレット」を選択し、新規ボタンをクリックします。
⑦「説明」を入力し、「有効期限」を選択で、「追加」ボタンをクリックします。
⑧シークレット値は二度と表示されないため、コピーボタンを選択して、コピーして保存してください。これはあとの oauth 設定のコンシューマ シークレットに設定します。
２．Microsoft Azure で API 権限を有効にします
①API のアクセス許可を選択し、アクセス許可の追加ボタンをクリックします。
②[Microsoft Graph]をクリックします。
③委任されたアクセス許可を選択します。
④API アクセスの許可の要求に offline_access をチェックします。
⑤API アクセスの許可の要求に IMAP の「IMAP.AccessAsUser.All」をチェックし、「アクセス許可の追加」をクリックします。
３．MC に Microsoft Azure AD 2.0 の OAuth アプリケーションを作成します
①MC＞リボジトリ＞Oauth を選択し、アプリケーション追加ボタンをクリックします。
②以下通りに新しいアプリケーションの項目を設定し、「OK」ボタンをクリックします。
（１）プロジェクト選択
（２）名前設定（任意）
（３）サービスプロバイダを「Microsoft Azure AD 2.0」を選択
（４）コンシューマキーは、登録したアプリの「概要」の「アプリケーション(クライアント)」で設定
（５）コンシューマシークレットは、上記１－⑦で保存したシークレットの値で設定
（６）デフォルトのまま
（７）スコープは「https://outlook.office.com/IMAP.AccessAsUser.All offline_access」に設定
（８）コミット メッセージ（任意）
４．OAuth ユーザーを追加します
①MC＞リボジトリ＞Oauth を選択し、ユーザー追加ボタンをクリックします。
②アプリケーションとユーザー名の項目を設定し、「次へ」ボタンをクリックします。
（１）３.で追加したアプリケーションを選択
（２）Azure のユーザーアカウントを入力
（３）テナントは、登録したアプリの「概要」の「ディレクトリ(テナント)ID」で設定
③認証リングをクリックします。
④Azure のログイン情報を入力し、要求されているアクセス許可を「組織の代理として同意する」をチェックし「承諾」ボタンをクリックします。
⑤「このウインドウを閉じ」をクリックします
⑥「次へ」ボタンをクリックします。
⑦アクセストークンが表示され、「終了」ボタンをクリックします。
５．電子メールアカウントを設定します
①MC＞設定＞電子メールアカウントを選択し、追加ボタンをクリックします
②新しい電子メールアカウントを作成のアカウントタイプを Microsoft365 に選択します。
③新しい電子メールアカウントを作成の項目を設定し、「テスト」ボタンを押すでチェックされるとアカウントが認証され、保存ボタンを押します。
（１）名前（任意）
（２）説明（任意）
（３）プロジェクトに割り当てにプロジェクトを選択
（４）Oauth を使用にチェック
（５）Oauth ユーザーは、作成した Oauth ユーザーを選択
（６）Azure にログインするユーザーID
６．電子メールトリガーを設定します
①MC＞リボジトリ＞電子メールトリガーを選択し、追加ボタンをクリックします。
②電子メールトリガーマッピングを作成に項目設定し、「OK」ボタンをクリックします。
（１）トリガー名（任意）
（２）プロジェクトを選択
（３）５で作成した電子メールアカウントを選択
（４）実行するロボットを選択
（５）受信メールのフォルダを選択
今回の設定で、電子メールトリガーは、office365 のメール受信に Oauth 認証できるようになりました。例の設定は、指定したメール受信フォルダ（６-②-(5)）にメールは受信したら、指定したロボット（６-②-(4)）が実行されます。