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 に加えられた変更はすべて、そのユーザーに代わって行われます。

クライアント証明書の認証

スコープ

コネクタでコネクションを作成するには、最小限のスコープ Files.Readが必要です。

コネクタが機能するには、すべてのアクティビティが機能するために、次の完全なスコープ セットが必要です: 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. Automation Cloud で、レール メニューから [ Integration Service ] を選択します。
2. [コネクタ] のリストから [Microsoft OneDrive と SharePoint] を選択するか、検索バーを使用してコネクタを検索します。
3. [ Microsoft OneDrive および SharePoint に接続] を選択すると、接続ページにリダイレクトされます。
4. 認証の種類として [ クライアント証明書認証 ] を選択します。
5. 次のフィールドを設定します。

   • クライアント ID - ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。

   • 証明書のパスワード - 証明書の作成時に設定したパスワードです。

   • OAuth Base64 クライアント証明書 - クライアント証明書は .pfx 形式で生成されますBase64 エンコード形式に変換し、このフィールドに入力する必要があります。

   • テナント ID - アプリの Microsoft Azure テナント ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。

   • 環境 - 任意で、ドロップダウン リストから環境を選択します。

     • Office 365 (既定)
     • 米国政府 L4 - 公共部門ドメイン
     • 米国政府 L5 - 公共部門ドメイン
     • 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
     注:

     環境について詳しくは、「 Microsoft Graph and Graph Explorer service root endpoints」をご覧ください。

   • アカウント - システムが接続で使用するアカウントまたは共有メールボックスのユーザー プリンシパル名 (UPN) を入力します。これは、接続を確立するために必要です。

6. [接続] を選択します。
7. Microsoft のメール アドレスとパスワードで認証します。

OAuth 2.0 の認可コード

スコープ

コネクタでコネクションを作成するには、 openid、 offline_access、 email、 Files.Readの最小限のスコープが必要です。

コネクタが機能するには、すべてのアクティビティが機能するために、次の完全なスコープ セットが必要です: 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. Automation Cloud で、レール メニューから [ Integration Service ] を選択します。
2. [コネクタ] のリストから [Microsoft OneDrive および SharePoint] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Microsoft OneDrive および SharePoint に接続 ] ボタンを選択すると、接続ページにリダイレクトされます。
4. 認証の種類として [OAuth 2.0 認可コード ] を選択します。
5. 次のように設定します。
   • スコープ - 必要に応じて、コネクタの権限を追加または削除します。
   • 環境 - 任意で、ドロップダウン リストから環境を選択します。
     • Office 365 (既定)
     • 米国政府 L4 - 公共部門ドメイン
     • 米国政府 L5 - 公共部門ドメイン
     • 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
     注:

     環境について詳しくは、「 Microsoft Graph and Graph Explorer service root endpoints」をご覧ください。

6. [接続] を選択します。
7. Microsoft のメール アドレスとパスワードで認証します。

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

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

注:

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

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

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

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

スコープ

コネクタでコネクションを作成するには、最小限のスコープ Files.Readが必要です。

コネクタが機能するには、すべてのアクティビティが機能するために、次の完全なスコープ セットが必要です: 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. Automation Cloud で、レール メニューから [ Integration Service ] を選択します。
2. [コネクタ] のリストから [Microsoft OneDrive および SharePoint] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Microsoft OneDrive および SharePoint に接続 ] ボタンを選択すると、接続ページにリダイレクトされます。
4. 認証の種類として [ OAuth 2.0 クライアント資格情報 ] を選択します。
5. 次のように設定します。

   • クライアント ID - ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。

   • クライアント シークレット - Microsoft Azure アプリケーションの [証明書とシークレット] セクションのクライアント シークレットです。

   • テナント ID - [概要] セクションのアプリの Microsoft Azure テナント ID です。

   • 環境 - 任意で、ドロップダウン リストから環境を選択します。

     • Office 365 (既定)
     • 米国政府 L4 - 公共部門ドメイン
     • 米国政府 L5 - 公共部門ドメイン
     • 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
     注:

     環境について詳しくは、「 Microsoft Graph and Graph Explorer service root endpoints」をご覧ください。

   • アカウント - ユーザーの偽装に使用するアカウントを指定します。

6. [接続] を選択します。

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

概要

アプリケーションの作成方法については、Microsoft の公式ドキュメント「 Register an application with the Microsoft identity 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、 email、 Files.Readの最小限のスコープが必要です。
• OneDrive のトリガーには、以下の最小スコープが必要です。
  • SharePoint サイトのイベントの場合: openid、 offline_access、 User.Read.All 、または User.Read と Sites.Read.All。
  • グループおよびカレンダーのイベントの場合: Group.Read.All
  • 残りのすべてのイベントの種類の場合: Files.Read.All

コネクタが機能するには、すべてのアクティビティが機能するために、次の完全なスコープ セットが必要です: 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. Automation Cloud で、レール メニューから [ Integration Service ] を選択します。
2. [コネクタ] のリストから [Microsoft OneDrive および SharePoint] を選択します。検索バーで検索して、表示されるコネクタの数を絞ることもできます。
3. [ Microsoft OneDrive および SharePoint に接続 ] ボタンを選択すると、接続ページにリダイレクトされます。
4. 認証の種類として [ Bring your own OAuth 2.0 app ] を選択します。
5. 次のように設定します。
   • クライアント ID - ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。
   • クライアント シークレット - Microsoft Azure アプリケーションの [証明書とシークレット] セクションのクライアント シークレットです。
   • スコープ - 必要に応じて、コネクタの権限を追加または削除します。
   • テナント ID - [概要] セクションのアプリの Microsoft Azure テナント ID です。
     注:

     • マルチテナント アプリケーションを使用する場合は、既定値を common のままにします。
     • シングルテナント アプリケーションを使用する場合は、Azure からテナント ID を取得します。詳しくは、「 Microsoft Entra テナント ID の確認方法」をご覧ください。
   • 環境 - 任意で、ドロップダウン リストから環境を選択します。
     • Office 365 (既定)
     • 米国政府 L4 - 公共部門ドメイン
     • 米国政府 L5 - 公共部門ドメイン
     • 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
     注:

     環境について詳しくは、「 Microsoft Graph and Graph Explorer service root endpoints」をご覧ください。

6. [接続] を選択します。

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

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

注:

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

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

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