Questetra BPM Suite には、Microsoft 365 の各サービスと連携する自動工程が用意されています。これらを使うには、HTTP 認証設定で OAuth2 トークンを取得します。その際、Microsoft 365 側の事情でつまずくことがあります。
この記事では、Microsoft 365 と連携する自動工程に共通する手順と前提を説明します。個々の自動工程の設定方法については、それぞれのブログ記事やモデリング要素のページをご覧ください。
HTTP 認証設定の追加とトークンの取得
自動工程の設定項目「OAuth2 設定」の［設定はこちらから］をクリックします。
［追加］をクリックし、「名前」に適当な名前を入力して［保存］をクリックします。 どのアカウントに紐づく設定か判別できるように「{Microsoft 365 のアカウント名} で接続」などとしておくのがおすすめです。
［トークンの取得］をクリックすると、Microsoft 365 アカウントへのサインイン画面が表示されます。
Microsoft 365 のアカウント（メールアドレス）とパスワードを入力し、サインインします。「サインインの状態を維持しますか？」の選択は、はい / いいえ のどちらでも問題ありません。
認証が成功すると Questetra の画面に戻り、「トークンの有無」欄に「o (リフレッシュトークン)」と表示されます。
「管理者の承認が必要」と表示されて先に進めない場合は、次の「管理者の同意が必要になる場合」をご覧ください。ブラウザに Microsoft 365 のセッションが残っているとサインイン画面が表示されないため、意図しないアカウントのトークンが取得されることがあります。「トークンを取得するアカウントに注意」もあわせてご覧ください。
管理者の同意が必要になる場合
トークンの取得時に「管理者の承認が必要」と表示され、先に進めないことがあります。これは Microsoft Entra（旧 Azure Active Directory）側で、一般のユーザーが自分の判断でアプリにアクセスを許可することを制限している場合に起こります。
- Microsoft Entra の既定の設定では、ユーザーが自分の判断で同意できる権限は、影響が小さいとみなされるものに限られます
- Microsoft 365 と連携する自動工程が要求する権限（「アプリケーション ID」の表のスコープ）は、これに該当しません
- この設定はテナントの管理者が変更できるため、制限の有無はテナントごとに異なります。同じ自動工程でも、テナントによって「管理者の承認が必要」が表示されたりされなかったりします
この場合は、Microsoft Entra の管理者に、対象アプリへの同意を依頼してください。管理者が一度同意すれば、以後は一般のユーザーでもトークンを取得できるようになります。
管理者の同意は「このアプリがこの権限を使ってよい」というテナントの記録を作るもので、トークンそのものは発行されません。同意を与える人と、トークンを取得する人は別で構いません。
アプリケーション ID
管理者に同意を依頼するときは、対象アプリを特定するための表示名とアプリケーション ID（クライアント ID）をあわせてお伝えください。Microsoft Entra 管理センターの［エンタープライズ アプリケーション］には多数のアプリが並ぶため、名前だけでは取り違えが起こり得ます。
なお、自動工程の設定項目「OAuth2 設定」で選択する HTTP 認証設定のラベルと、Microsoft Entra 上のアプリケーション名は一致しません。対応は次のとおりです。
| HTTP 認証設定のラベル | Microsoft Entra 上の表示名 | アプリケーション ID | スコープ |
|---|---|---|---|
| Microsoft 365 Outlook for Business | Questetra BPM Suite with Outlook | 1fe73638-82e2-41e4-80d4-2526e839ee8d | Mail.ReadWrite / offline_access |
| Microsoft 365 OneDrive for Business | Questetra BPM Suite | 05a49362-1657-449e-83db-bf005433c132 | Files.ReadWrite.All / offline_access |
| Microsoft Lists | Questetra BPM Suite with Lists | 5ae6318f-81f8-4eef-bb4c-30976c978c1e | Sites.ReadWrite.All / offline_access |
| Microsoft Teams | Questetra BPM Suite with Teams | bf6e7a2e-7c45-4174-a916-c012f52bd9f0 | ChannelMessage.Send / offline_access |
「Microsoft 365 Excel for Business」の自動工程は、「Microsoft 365 OneDrive for Business」の HTTP 認証設定を使用します。
表示名は Microsoft Entra 上で変更できるため、確実に特定するにはアプリケーション ID をご利用ください。
トークンを取得するアカウントに注意
自動工程が操作する対象は、トークンを取得したアカウントのメールボックスやファイルです。たとえば「開始: Microsoft 365 Outlook for Business: メール受信時」は、トークンを取得したアカウントに届くメールを監視します。
ここで注意が必要なのは、ブラウザに別の Microsoft アカウントのセッションが残っている場合です。［トークンの取得］をクリックしてもサインイン画面が表示されず、そのアカウントのトークンが取得されます。同意画面もアカウントの選択画面も出ないため、気づきにくい状態になります。
意図したアカウントで取得するために、シークレットウィンドウ（プライベートウィンドウ）での操作をおすすめします。
自動工程が期待どおりに動作しない場合は、どのアカウントのトークンで動いているかを確認してください。Microsoft Entra 管理センターの［エンタープライズ アプリケーション］で対象アプリの［サインイン ログ］を開くと、サインインしたユーザー名が確認できます。
