Microsoft OneDrive と SharePoint の認証

クライアント証明書、OAuth 2.0 クライアント資格情報、または Automation Suite でサポートされているその他の方法を使用して、UiPath を Microsoft OneDrive および SharePoint に接続します。

概要

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

• クライアント証明書の認証 – クライアント シークレットではなくクライアント証明書を使用して接続します。
• OAuth 2.0 クライアント資格情報 – サービス アカウントを使用します。
• 独自の OAuth 2.0 アプリ (BYOA) を使用する – 作成したプライベート アプリケーションに接続します。

Microsoft Azure にアプリを登録する際は、以下の認証方法に対応するアクセス許可の種類を使用してください。

認証の種類	Microsoft のアクセス許可の種類
クライアント証明書の認証	アプリケーション
OAuth 2.0 クライアント資格情報	アプリケーション
独自の OAuth 2.0 アプリ (BYOA) を使用する	委任されたアクセス許可

管理者の同意

注:

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

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

注:

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

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

スコープ

コネクタでコネクションを作成するには、 User.Read.All または User.Read、 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 - Microsoft Azure アプリケーション登録の [概要] セクションの ID です。
   • 証明書のパスワード - 証明書の作成時に設定したパスワードです。
   • OAuth Base64 クライアント証明書 - クライアント証明書は .pfx ファイル形式で生成されます。Base64 エンコード形式に変換してこのフィールドに入力する必要があります。
   • テナント ID - Microsoft Azure アプリケーション登録の [概要] セクションに表示される、アプリの Microsoft Azure テナント ID です。
   • 環境 - 任意で、ドロップダウン リストから環境を選択します。
     • Office 365 (既定)
     • 米国政府 L4 - 公共部門ドメイン
     • 米国政府 L5 - 公共部門ドメイン
     • 中国すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関 ] または [中国 ] にのみ切り替えます。環境について詳しくは、「 Microsoft Graph and Graph Explorer service root endpoints」をご覧ください。
   • アカウント - システムが接続で使用するアカウントまたは共有メールボックスのユーザー プリンシパル名 (UPN) を入力します。これは、接続を確立するために必要です。
6. [接続] を選択します。
7. Microsoft のメール アドレスとパスワードで認証します。

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. 必要な資格情報を入力します。クライアント ID とクライアント シークレット、テナント ID、およびさまざまなアクティビティを操作するために必要なスコープを指定する必要があります。必要なスコープについては、アクティビティのドキュメントをご覧ください。マルチテナント アプリケーションを使用する場合は、[ テナント ID ] の既定値 (common) のままにします。シングルテナント アプリケーションを使用している場合は、Azure からテナント ID を取得します。「 Microsoft Entra テナント ID の確認方法」をご覧ください。

独自の 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://{yourDomain}/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 – 残りのすべてのイベントタイプ。

コネクタが機能するには、すべてのアクティビティが機能するために、次の完全なスコープ セットが必要です: 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. 必要な資格情報を入力します。クライアント 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 ベースのコネクタに影響します。