Microsoft OneDrive と SharePoint の認証

概要

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

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

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

管理者の同意

手記： このセクションは、[ 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 の認可コード

スコープ

コネクタが要求するアクセス許可またはスコープは、 offline_access、 Files.Read、 Files.Read.All、 Files.ReadWrite、 Files.ReadWrite.All、 Sites.Read.All Sites.ReadWrite.All、 Group.Read.All、 Group.ReadWrite.All、 profile、 openid、 email、 User.Read.All または User.Readです。

Microsoft OneDrive と SharePoint のコネクションを追加する

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

1. 左側のレールから [Integration Service] を選択します。
2. [ コネクタ ] のリストから [Microsoft OneDrive および SharePoint] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Microsoft OneDrive および SharePoint に接続 ] ボタンを選択します。
4. これで、コネクションのページにリダイレクトされます。
5. 認証の種類として [ OAuth 2.0 認可コード ] を選択します。
6. [ スコープ ] フィールドに必要な権限を追加します。
7. ドロップダウン リストから環境を選択します。Office 365 (既定)、US Government L4 - Public Sector ドメイン、US Government L5 - Public Sector ドメイン、または China から選択します。
   手記： 環境について詳しくは、「 Microsoft Graph」および「Graph Explorer サービスのルート エンドポイント」をご覧ください。
8. [ 接続 ] を選択し、Microsoft のメール アドレスとパスワードで認証します。

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

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

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

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

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

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

スコープ

コネクションを作成するための最小スコープ: User.Read.All または User.Read、 Files.Read。

Microsoft OneDrive と SharePoint のコネクションを追加する

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

1. 左側のレールから [Integration Service] を選択します。
2. [ コネクタ ] のリストから [Microsoft OneDrive および SharePoint] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Microsoft OneDrive および SharePoint に接続 ] ボタンを選択します。
4. これで、コネクションのページにリダイレクトされます。
5. 認証の種類として [ OAuth 2.0 クライアント資格情報 ] を選択します。
6. [ クライアント ID]、[ クライアント シークレット]、[ テナント ID]、[ ロボット グループ]、[ アカウント ] の各フィールドに入力して設定します (ユーザーの偽装に使用するアカウントを指定します)。
7. [接続] を選択します。

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

概要

アプリケーションの作成方法については、Microsoft の公式ドキュメント「 Register an application with the Microsoft ID platform」をご覧ください。

注: これは高度な機能であり、対象のアプリケーションの管理者権限が必要です。 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、 User.Read.All または User.Read、 Files.Readのいずれかです。
• OneDrive のトリガーに必要なスコープの最小限のリスト:
  • openid、 offline_access、 User.Read.All または User.Read、 Sites.Read.All – SharePoint サイトでのイベント用。
  • Group.Read.All – グループおよびカレンダーのイベント用です。
  • Files.Read.All – 残りのすべてのイベントタイプ。

Microsoft OneDrive と SharePoint のコネクションを追加する

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

1. 左側のレールから [Integration Service] を選択します。
2. [ コネクタ ] のリストから [Microsoft OneDrive および SharePoint] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Microsoft OneDrive および SharePoint に接続 ] ボタンを選択します。
4. これで、コネクションのページにリダイレクトされます。
5. 認証の種類として [ 独自の OAuth 2.0 アプリ (BYOA) を使用する] を選択します。
6. [ クライアント ID]、[ クライアント シークレット]、[ スコープ]、[ テナント ID]、[ ロボット グループ] の各フィールドに入力して設定します。
   注:

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

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

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

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

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

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