Microsoft OneDrive と SharePoint の認証

概要

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

• Client Certificate Authentication – connects using a client certificate instead of a client secret.
• OAuth 2.0 認可コード – UiPath のパブリック アプリケーションに接続します。
• OAuth 2.0 Client credentials - connects using a service account.
• 独自の 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 に加えられた変更はすべて、そのユーザーに代わって行われます。

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

スコープ

The connector requires the following minimum scopes to create a connection: Files.Read.

The connector requires the following full set of scopes for all activities to function: 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.

To add more granular permissions, refer to the activities documentation.

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

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

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint, or use the search bar to find the connector.
3. Select Connect to Microsoft OneDrive and SharePoint, which redirects you to the connection page.
4. Select the Client Certificate Authentication authentication type.
5. 次のフィールドを設定します。

   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.

   • Password for the certificate - The password you set during the certificate creation.

   • OAuth base64 client certificate - The client certificate is generated in a .pfx file format, which you must convert to Base64-encoded format and provide it in this field.

   • Tenant ID - You can find the Microsoft Azure tenant ID for an app in the Overview section of your Microsoft Azure application registration.

   • Environment - Optionally, select an environment from the dropdown list:

     • Office 365 (既定)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     注:

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

   • Account - Enter the user principal name (UPN) of the account or shared mailbox that the system should use in the connection. This is required for the connection to be established.

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

OAuth 2.0 の認可コード

スコープ

The connector requires the following minimum scopes to create a connection: openid, offline_access, email, and Files.Read.

The connector requires the following full set of scopes for all activities to function: 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.

To add more granular permissions, refer to the activities documentation.

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

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

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. 認証の種類として [OAuth 2.0 認可コード ] を選択します。
5. 次のように設定します。
   • Scope - Optionally, add or remove permissions for your connector.
   • Environment - Optionally, select an environment from the dropdown list:
     • Office 365 (既定)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     注:

     環境について詳しくは、「 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 クライアント資格情報

スコープ

The connector requires the following minimum scopes to create a connection: Files.Read.

The connector requires the following full set of scopes for all activities to function: 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.

To add more granular permissions, refer to the activities documentation.

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

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

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. 認証の種類として [ OAuth 2.0 クライアント資格情報 ] を選択します。
5. 次のように設定します。

   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.

   • Client Secret - The client secret from the Certificates & secrets section of your Microsoft Azure application.

   • Tenant ID - The Microsoft Azure tenant ID for an app from the Overview section.

   • Environment - Optionally, select an environment from the dropdown list:

     • Office 365 (既定)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     注:

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

   • Account - Provide the account used to impersonate a user.

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 コネクタへのコネクションを作成します。

スコープ

• The connector requires the following minimum scopes to create a connection: openid, offline_access, email, and Files.Read.
• OneDrive triggers require the following minimum scopes:
  • For events on SharePoint sites: openid, offline_access, and User.Read.All or User.Read and Sites.Read.All.
  • For events on groups and calendars: Group.Read.All
  • For all the remaining event types: Files.Read.All

The connector requires the following full set of scopes for all activities to function: 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.

To add more granular permissions, refer to the activities documentation.

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

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

1. In Automation Cloud, select Integration Service from the rail menu.
2. From the Connectors list, select Microsoft OneDrive and SharePoint. You can also use the search bar to narrow down the connector.
3. Select the Connect to Microsoft OneDrive and SharePoint button, which redirects you to the connection page.
4. 認証の種類として [ Bring your own OAuth 2.0 app ] を選択します。
5. 次のように設定します。
   • Client ID - You can find the ID in the Overview section of your Microsoft Azure application registration.
   • Client Secret - The client secret from the Certificates & secrets section of your Microsoft Azure application.
   • Scope - Optionally, add or remove permissions for your connector.
   • Tenant ID - The Microsoft Azure tenant ID for an app from the Overview section.
     注:

     • If you use a multi-tenant application, keep the default value common.
     • If you use a single-tenant application, retrieve the tenant ID from Azure. For more details, check How to find your Microsoft Entra tenant ID.
   • Environment - Optionally, select an environment from the dropdown list:
     • Office 365 (既定)
     • US Government L4 - Public Sector domain
     • US Government L5 - Public Sector domain
     • China Select Office 365 (default) for all regions, and only switch to Government or China for cloud deployments.
     注:

     環境について詳しくは、「 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 ベースのコネクタに影響します。