Microsoft Outlook 365 の認証

概要

Integration Service で Microsoft Graph ベースのコネクタのいずれかへのコネクションを作成する際に、以下の認証オプションから選択できます。

• OAuth 2.0 認可コード – Microsoft アカウントの資格情報を使用して UiPath パブリック アプリケーションに接続します。また、必要に応じて、共有メールボックスに接続します。
• OAuth 2.0 クライアント資格情報 – サービス アカウントを使用し、必要に応じて共有メールボックスに接続します。
• 独自の OAuth 2.0 アプリ (BYOA ) を使用する – 作成したプライベート アプリケーションに接続し、必要に応じて共有メールボックスに接続します。

注:

さまざまな認証の種類について詳しくは、「 Microsoft 365 アクティビティへの接続方法」をご覧ください。

サインイン プロセス中にエラーが発生した場合は、Microsoft Outlook 365 の管理者に連絡することをお勧めします。詳細については、 Office 365 Outlook コネクタのドキュメントをご覧ください。

管理者の同意

注:

このセクションは、[ OAuth 2.0 認可コード ] および [独自の OAuth 2.0 アプリ (BYOA) を使用する ] の認証オプションにのみ適用されます。

多くの組織では、外部アプリケーションへのコネクションを作成する前に管理者の同意が必要です。管理者の同意ワークフローでは、コネクションを確立する前に、管理者が特定のユーザーまたはグループへのアプリの登録を承認する必要があります。詳しくは、Microsoft のドキュメント「 Overview of admin consent workflow 」および「 User and admin consent in Microsoft Entra ID 」をご覧ください。

注:

Integration Service は、コネクションを作成するユーザーを偽装します。 ユーザーの資格情報を使用して、指定のアプリケーション内のリソースと同じリソースすべてへのアクセスを可能にします。 コネクションを共有すると、そのコネクションを有する Microsoft SharePoint または OneDrive に加えられた変更はすべて、そのユーザーに代わって行われます。

OAuth 2.0 の認可コード

スコープ

コネクションを作成し、すべてのアクティビティを機能させるために必要なスコープは、 User.Read、 User.Read.All、 Mail.Read、 Mail.Read.Shared、 Mail.ReadWrite、 Mail.ReadWrite.Shared、 Mail.Send、 Mail.Send.Shared、 MailboxSettings.ReadWrite、 Calendars.Read、 Calendars.Read.Shared、 Calendars.ReadWrite、 Calendars.ReadWrite.Shared、 profile、 openid、 email、または offline_access。

Microsoft Outlook 365 のコネクションを追加する

お使いの Microsoft Outlook 365 インスタンスへのコネクションを作成するには、次の手順を実行します。

1. 左側のレールから [Integration Service] を選択します。
2. [コネクタ] のリストから [Microsoft Outlook 365] を選択するか、検索バーを使用してコネクタを検索します。
3. [ Microsoft Outlook 365 に接続] を選択します。
4. これで、コネクションのページにリダイレクトされます。
5. 認証の種類として [OAuth 2.0 認可コード ] を選択します。
6. ドロップダウン リストから環境を選択します。 [Office 365 (既定)]、[ 米国政府機関 L4 - 公共部門向け] ドメイン、[ 米国政府機関 L5 - 公共部門] ドメイン、または [中国] から選択します。注: 環境について詳しくは、「 Microsoft Graph and Graph Explorer service root endpoints」をご覧ください。
7. 必要に応じて、[ 共有メールボックス ] フィールドに共有メールボックスを入力します。注: すべての Outlook アクティビティは、接続すると共有メールボックスを継承します。
8. [接続] を選択します。
9. Microsoft のメール アドレスとパスワードで認証します。

OAuth アプリケーションの更新トークン

OAuth アプリケーションの更新トークンは、Microsoft によっていつでも無効にされたり、取り消されたりされます。これは、タイムアウトや失効など、さまざまな理由で発生する可能性があります。 詳細については、Microsoft の公式ドキュメントをご覧ください。

注:

トークンを無効にするとコネクションが失敗し、コネクションを修正しないとオートメーションを実行できません。

OAuth アプリケーションを作成する際は、Microsoft のベスト プラクティスに従ってください。 OAuth 2.0 アプリケーションの作成方法の詳細については、Microsoft のドキュメントをご覧ください。

この問題は、OneDrive & SharePoint コネクタだけでなく、Outlook や Teams など、すべての Microsoft Graph ベースのコネクタに影響します。

OAuth 2.0 クライアント資格情報

スコープ

コネクションの作成に必要な最小限のスコープは、 Mail.Read、 User.Read.All 、または User.Readです。

Microsoft Outlook 365 のコネクションを追加する

お使いの Microsoft Outlook 365 インスタンスへのコネクションを作成するには、次の手順を実行します。

1. 左側のレールから [Integration Service] を選択します。
2. [コネクタ] のリストから [Microsoft Outlook 365] を選択するか、検索バーを使用してコネクタを検索します。
3. [ Microsoft Outlook 365 に接続] を選択します。
4. これで、コネクションのページにリダイレクトされます。
5. 歯車アイコンから、認証の種類として [OAuth 2.0 クライアント資格情報 ] を選択します。
6. 必須フィールド [クライアント ID]、[ クライアント シークレット]、[ アカウント ] に入力し、必要に応じて [テナント ID]、[ 環境]、[ 共有メールボックス] フィールドに入力します。[アカウント ] は、ユーザーの偽装に使用されるアカウントを表します。
7. [接続] を選択します。

独自の OAuth 2.0 アプリ (BYOA) を使用する

概要

アプリケーションの作成方法については、Microsoft の公式ドキュメントにアクセスし、「Microsoft ID プラットフォームにアプリケーションを登録する」に記載された手順に従ってください。

注:

これは高度な機能であり、対象のアプリケーションの管理者権限が必要です。IT 管理者と協力して、アプリケーションを正常にセットアップしてください。

要件

Integration Service で使用する独自のアプリケーションを作成する場合は、次の要件を考慮する必要があります。

1. アプリケーションは、 マルチテナント アプリケーションまたは シングル テナント アプリケーションとして設定する必要があります。
2. Web アプリケーションを構成する必要があります。
3. Web リダイレクト URI を構成する必要があります。OAuth 2.0 アプリケーションのリダイレクト URI (またはコールバック URL) は、コネクション作成時の認証画面で入力されます ( 「https://cloud.uipath.com/provisioning\\_/callback」)。
4. 委任されたアクセス許可を設定する必要があります。詳しくは、Microsoft の公式ドキュメントの 「権限 」をご覧ください。
5. アプリケーションのクライアント シークレットを生成します。

重要:

プライベート OAuth アプリケーションを使用するメリットは、実際のニーズに応じてアクセス許可をカスタマイズできることです。Microsoft 365 のアクティビティ パッケージ内の各アクティビティに必要なスコープについて詳しくは、「 スコープを使用する 」および アクティビティ のドキュメントをご覧ください。コネクタは Microsoft Graph API を使用します。すべての権限について詳しくは、 Microsoft Graph のアクセス許可に関するこちらの ページをご覧ください。

アプリケーションを作成したら、クライアント ID とクライアント シークレットを使用して、Microsoft コネクタへのコネクションを作成します。

スコープ

• コネクションの作成に必要な最小限のスコープ: openid、 offline_access、 Mail.Read。
• Outlook トリガーに必要なスコープの最小限のリストは以下のとおりです。
  • 共有メールボックス トリガーの場合: openid、 offline_access、 Mail.Read、 Mail.Read.Shared。
  • カレンダーの予定の場合: Calendars.Read
  • 共有カレンダーのイベントの場合: Calendars.Read.Shared

Microsoft Outlook 365 のコネクションを追加する

お使いの Microsoft Outlook 365 インスタンスへのコネクションを作成するには、次の手順を実行します。

1. 左側のレールから [Integration Service] を選択します。
2. [コネクタ] のリストから [Microsoft Outlook 365] を選択するか、検索バーを使用してコネクタを検索します。
3. [ Microsoft Outlook 365 に接続] を選択します。
4. これで、コネクションのページにリダイレクトされます。
5. 認証の種類として [ Bring your own OAuth 2.0 app ] を選択します。
6. 必須フィールドに入力します。 [クライアント ID ] と [クライアント シークレット]、および必要に応じて、さまざまなアクティビティを操作するために必要な スコープ、[ テナント ID]、[ 環境]、[ 共有メールボックス] を入力します。
   注:

   • 詳しくは 、アクティビティのドキュメント を参照して、必要なスコープを確認してください。
   • マルチテナント アプリケーションを使用する場合は、[ テナント ID ] の既定値 (common) のままにします。
   • シングル テナント アプリケーションを使用する場合は、Azure からテナント ID を取得します。詳しくは、「 Microsoft Entra テナント ID の確認方法」をご覧ください。

OAuth アプリケーションの更新トークン

OAuth アプリケーションの更新トークンは、Microsoft によっていつでも無効にされたり、取り消されたりされます。これは、タイムアウトや失効など、さまざまな理由で発生する可能性があります。 詳細については、Microsoft の公式ドキュメントをご覧ください。

注:

トークンを無効にするとコネクションが失敗し、コネクションを修正しないとオートメーションを実行できません。

OAuth アプリケーションを作成する際は、Microsoft のベスト プラクティスに従ってください。 OAuth 2.0 アプリケーションの作成方法の詳細については、Microsoft のドキュメントをご覧ください。

この問題は、OneDrive & SharePoint コネクタだけでなく、Outlook や Teams など、すべての Microsoft Graph ベースのコネクタに影響します。