- スタート アップ ガイド
- 通知
- ライセンス
- トラブルシューティング
- コーディング エージェント
- コネクタ ビルダー
- Act! 365
- ActiveCampaign
- Active Directory - プレビュー
- Adobe Acrobat Sign
- Adobe PDF Services
- Agent 2 Agent - プレビュー
- Amazon Bedrock
- Amazon Connect
- Amazon Polly
- Amazon SES
- Amazon Transcribe
- Amazon Web Services
- Anthropic Claude
- Asana
- AWeber
- Azure AI Document Intelligence
- Azure Defender for Cloud
- Azure Maps
- BambooHR
- Box
- Brevo
- Calendly
- Campaign Monitor
- Cisco Webex Teams
- Citrix Hypervisor
- Citrix ShareFile
- Clearbit
- Confluence Cloud
- Constant Contact
- Coupa
- CrewAI – プレビュー
- Customer.io
- Database Hub
- Databricks - Preview
- Databricks エージェント
- Datadog
- DeepSeek
- Deputy
- Discord - プレビュー
- DocuSign
- Drip
- Dropbox
- Dropbox Business
- Egnyte
- Epic FHIR (エピック FHIR) - プレビュー
- Eventbrite
- Exchangerates
- Exchange Server - プレビュー
- Expensify
- Facebook
- Freshbooks
- Freshdesk
- Freshsales
- FreshService
- Getresponse
- GitHub
- Gmail
- Google Cloud Platform
- Google ドキュメント
- Google ドライブ
- Google フォーム - プレビュー
- Google マップ
- Google スプレッドシート
- Google Speech-to-Text
- Google Text-to-Speech
- Google ToDo リスト - プレビュー
- Google Vertex
- Google Vision
- Google Workspace
- GoToWebinar
- Greenhouse
- Hootsuite
- HTTP
- HTTP Webhook
- HubSpot CRM
- Hubspot Marketing
- HyperV - プレビュー
- IcertisIcertis
- iContact
- Insightly CRM
- Intercom
- Jina.ai
- Jira
- Keap
- Klaviyo
- LinkedIn
- メール
- Mailchimp
- Mailgun
- Mailjet
- MailerLite
- Marketo
- MCP
- Microsoft 365
- Microsoft Azure
- Microsoft Azure Active Directory
- Microsoft Azure AI Foundry
- Microsoft Azure OpenAI
- Microsoft Azure Sentinel
- Microsoft Dynamics 365 CRM
- Microsoft OneDrive & SharePoint
- Microsoft OneDrive & SharePoint コネクタについて
- Microsoft OneDrive と SharePoint の認証
- Microsoft OneDrive & Sharepoint のイベント
- Microsoft Outlook 365
- Microsoft Power Automate
- Microsoft Sentiment
- Microsoft Sentinel 脅威インテリジェンス
- Microsoft Teams
- Microsoft Translator
- Microsoft Vision
- Miro
- NetIQ eDirectory
- NVIDIA NIM
- Okta
- OpenAI
- OpenAI V1 準拠の LLM
- Oracle Eloqua
- Oracle NetSuite
- PagerDuty
- Paypal
- PDFMonkey
- Perplexity
- Pinecone
- Pipedrive
- QuickBooks Online
- Quip
- Salesforce
- Salesforce Agentforce & Flows
- Salesforce Marketing Cloud
- SAP BAPI
- SAP Cloud for Customer
- SAP Concur
- SAP OData
- SendGrid
- ServiceNow
- Shopify
- Slack
- SmartRecruiters
- Smartsheet
- Snowflake
- Snowflake Cortex
- Stripe
- Sugar Enterprise
- Sugar Professional
- Sugar Sell
- Sugar Serve
- System Center - プレビュー
- TangoCard
- Todoist
- Trello
- Twilio
- TypeSafe (タイプセーフ) - プレビュー
- UiPath Apps (プレビュー)
- UiPath Data Fabric
- UiPath Test Manager
- UiPath GenAI アクティビティ
- UiPath Orchestrator
- X(旧ツイッター)
- Xero
- watsonx.ai
- WhatsApp Business
- WooCommerce
- Workable
- Workday
- Workday REST
- VMware ESXi vSphere
- YouTube
- Zendesk
- Zoho Campaigns
- Zoho Desk
- Zoho Mail
- Zoom
- ZoomInfo
Microsoft OneDrive と SharePoint の認証
クライアント証明書認証、OAuth 2.0 認可コード (PKCE の有無にかかわらず)、またはその他の Microsoft Graph ベースのオプションを使用して、UiPath を Microsoft OneDrive および SharePoint に接続します。
概要
Integration Service で Microsoft Graph ベースのコネクタのいずれかへのコネクションを作成する際に、以下の認証オプションから選択できます。
- クライアント証明書の認証 – クライアント シークレットではなくクライアント証明書を使用して接続します。
- OAuth 2.0 認可コード – UiPath のパブリック アプリケーションに接続します。
- OAuth 2.0 クライアント資格情報 - サービス アカウントを使用して接続します。
- 独自の OAuth 2.0 アプリ (BYOA) を使用する – 作成したプライベート アプリケーションに接続します。
- PKCE を使用した OAuth 2.0 認可コード – クライアント シークレットを使用せずに、作成したプライベート アプリケーションに接続します。
Microsoft Azure にアプリを登録する際は、以下の認証方法に対応するアクセス許可の種類を使用してください。
| 認証の種類 | Microsoft のアクセス許可の種類 |
|---|---|
| クライアント証明書の認証 | アプリケーション |
| OAuth 2.0 の認可コード | 委任されたアクセス許可 |
| OAuth 2.0 クライアント資格情報 | アプリケーション |
| 独自の OAuth 2.0 アプリ (BYOA) を使用する | 委任されたアクセス許可 |
| PKCE を使用した OAuth 2.0 認可コード | 委任されたアクセス許可 |
さまざまな認証の種類について詳しくは、「 Microsoft 365 アクティビティへの接続方法 」 ガイドをご覧ください。
管理者の同意
このセクションは、[ OAuth 2.0 認可コード]、[ 独自の OAuth 2.0 アプリを使用]、[ OAuth 2.0 認可コードと PKCE 認証オプション] にのみ適用されます。
多くの組織では、ユーザーが外部アプリケーションに接続する前に管理者の同意が必要です。管理者の同意ワークフローでは、コネクションを確立する前に、管理者が特定のユーザーまたはグループのアプリの登録を承認する必要があります。
組織が管理者の同意を適用している場合、コネクションの作成時に、アプリが組織内のリソースにアクセスするために権限を必要とし、そのアクセス権を付与できるのは管理者のみであることを示すエラーが発生することがあります。このエラーは製品の問題ではなく、Azure 管理者による対応が必要です。
背景情報については、Microsoft のドキュメント「 Overview of admin consent workflow 」および「 User and admin consent in Microsoft Entra ID 」をご覧ください。
管理者の承認をリクエストする
このエラーが発生した場合は、Microsoft のサインイン画面から直接承認要求を送信します。
- 承認 が必要 画面で、アクセスを要求する理由 フィールドに業務上の妥当性を入力します。
- [承認をリクエスト] を選択します。
管理者はリクエストをメールで受信し、Microsoft Entra 管理センターで確認することができます。
要求を承認する (管理者)
前提条件
- Microsoft Entra ID で全体管理者、アプリケーション管理者、またはクラウド アプリケーション管理者のロールを持っている。
保留中の管理者の同意リクエストを承認するには:
- Microsoft Entra 管理センターにサインインします。
- [Entra ID]、[Enterprise アプリ] の順に移動します。
- [ アクティビティ] の左側のナビゲーションで、[ 管理者の同意リクエスト] を選択します。
- [ マイ ペンディング] タブを選択し、リストから保留中のリクエストを選択します。
- アプリケーションが要求しているアクセス許可を確認します。
- [ 権限を確認] を選択して リクエスト中の権限を表示し、[ 同意] を選択して同意します。
- 却下するには、[ 拒否] を選択し、正当な理由を入力します。
要求を送信したユーザーには、決定が通知されます。
承認プロセスについて詳しくは、Microsoft ドキュメントの「 Review admin consent requests (管理者の同意リクエストを確認する )」をご覧ください。
Integration Service は、コネクションを作成するユーザーを偽装します。ユーザーの資格情報を使用して、指定のアプリケーション内のリソースと同じリソースすべてへのアクセスを可能にします。コネクションを共有すると、そのコネクションで行われる変更はすべて、そのユーザーに代わって行われます。
コネクション ユーザーを認証されたユーザーと同じにする場合は、次のいずれかのオプションを適用します。
- 同意プロセス中に、[ 組織を代表して同意 ] オプションを選択します。
- アプリケーションの登録後に、Microsoft Entra ID の同意設定を更新します。これは、管理者が組織を代表して同意を付与する場合の設定と同意の設定を一致させるために必要です。その後、コネクションを再作成できます。
クライアント証明書の認証
スコープ
コネクタが機能するには、すべてのアクティビティが機能するために、次の完全なスコープ セットが必要です: 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 インスタンスへのコネクションを作成するには、次の手順を実行します。
-
製品ランチャーから [Orchestrator] を選択します。
-
フォルダーを選択して [ コネクション ] タブに移動します。
-
[ コネクションを追加] を選択します。
-
コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。
-
認証の種類として [ クライアント証明書認証 ] を選択します。
-
次のフィールドを設定します。
-
クライアント ID - ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。
-
証明書のパスワード - 証明書の作成時に設定したパスワードです。
-
OAuth Base64 クライアント証明書 - クライアント証明書は .pfx 形式で生成されますBase64 エンコード形式に変換し、このフィールドに入力する必要があります。
-
テナント ID - アプリの Microsoft Azure テナント ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。
-
環境 - 任意で、ドロップダウン リストから環境を選択します。
- Office 365 (既定)
- 米国政府 L4 - 公共部門ドメイン
- 米国政府 L5 - 公共部門ドメイン
- 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
注: -
アカウント - システムが接続で使用するアカウントまたは共有メールボックスのユーザー プリンシパル名 (UPN) を入力します。これは、接続を確立するために必要です。
-
-
[接続] を選択します。
利用可能な場合は、フィールドの横にあるメニューを選択し、[ 資格情報アセットを使用 ] または [ Orchestrator アセットを使用 ] を選択して、値を直接入力するのではなく Orchestrator アセットを参照します。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。
-
Microsoft のメール アドレスとパスワードで認証します。
OAuth 2.0 の認可コード
スコープ
必須のスコープ: openid、email、offline_access、Files.Read
コネクタでコネクションを作成するには、 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 インスタンスへのコネクションを作成するには、次の手順を実行します。
- 製品ランチャーから [Orchestrator] を選択します。
- フォルダーを選択して [ コネクション ] タブに移動します。
- [ コネクションを追加] を選択します。
- コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。
- 認証の種類として [OAuth 2.0 認可コード ] を選択します。
- 次のように設定します。
- スコープ - 必要に応じて、コネクタの権限を追加または削除します。
- 環境 - 任意で、ドロップダウン リストから環境を選択します。
- Office 365 (既定)
- 米国政府 L4 - 公共部門ドメイン
- 米国政府 L5 - 公共部門ドメイン
- 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
注:
- [接続] を選択します。
- Microsoft のメール アドレスとパスワードで認証します。
OAuth アプリケーションの更新トークン
OAuth アプリケーションの更新トークンは、Microsoft によっていつでも無効にされたり、取り消されたりされます。これは、タイムアウトや失効など、さまざまな理由で発生する可能性があります。詳しくは、 Microsoft の公式ドキュメントをご覧ください。
トークンを無効にすると、接続が失敗します。コネクションを修正しないとオートメーションを実行できません。
OAuth アプリケーションを作成する際は、Microsoft のベスト プラクティスに従ってください。OAuth 2.0 アプリケーションの作成方法の詳細については、Microsoft の ドキュメントをご覧ください。
この問題は、OneDrive & SharePoint コネクタだけでなく、Outlook や Teams など、すべての Microsoft Graph ベースのコネクタに影響します。
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。
より詳細な権限を追加するには、 アクティビティのドキュメントをご覧ください。
テナント全体の権限を付与するのではなく、アプリケーションを特定の SharePoint サイトに制限するには、「 特定の SharePoint サイトへのアクセスを制限する」をご覧ください。
Microsoft OneDrive と SharePoint のコネクションを追加する
お使いの Microsoft OneDrive および SharePoint インスタンスへのコネクションを作成するには、次の手順を実行します。
-
製品ランチャーから [Orchestrator] を選択します。
-
フォルダーを選択して [ コネクション ] タブに移動します。
-
[ コネクションを追加] を選択します。
-
コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。
-
認証の種類として [ OAuth 2.0 クライアント資格情報 ] を選択します。
-
次のように設定します。
-
クライアント ID - ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。
-
クライアント シークレット - Microsoft Azure アプリケーションの [証明書とシークレット] セクションのクライアント シークレットです。
-
テナント ID - [概要] セクションのアプリの Microsoft Azure テナント ID です。
-
環境 - 任意で、ドロップダウン リストから環境を選択します。
- Office 365 (既定)
- 米国政府 L4 - 公共部門ドメイン
- 米国政府 L5 - 公共部門ドメイン
- 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
注: -
アカウント - ユーザーの偽装に使用するアカウントを指定します。
-
-
[接続] を選択します。
利用可能な場合は、フィールドの横にあるメニューを選択し、[ 資格情報アセットを使用 ] または [ Orchestrator アセットを使用 ] を選択して、値を直接入力するのではなく Orchestrator アセットを参照します。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。
独自の OAuth 2.0 アプリ (BYOA) を使用する
概要
アプリケーションの作成方法については、Microsoft の公式ドキュメント「 Register an application with the Microsoft identity platform」をご覧ください。
これは高度な機能であり、対象のアプリケーションの管理者権限が必要です。IT 管理者と協力して、アプリケーションを正常にセットアップしてください。
要件
Integration Service で使用する独自のアプリケーションを作成する場合は、次の要件を満たしていることを確認してください。
- アプリケーションを マルチテナント アプリケーションまたは 単一テナント アプリケーションとして設定します。
- Web アプリケーションを構成します。
- Web リダイレクト URI を設定します。OAuth 2.0 アプリケーションのリダイレクト URI (またはコールバック URL) は、コネクション作成時の認証画面で入力されます: https://cloud.uipath.com/provisioning_/callback。
- 委任されたアクセス許可を設定する必要があります。詳しくは、Microsoft の公式ドキュメントの 「権限 」をご覧ください。
- アプリケーションのクライアント シークレットを生成します。
プライベート OAuth アプリケーションを使用するメリットは、実際のニーズに応じてアクセス許可をカスタマイズできることです。Microsoft 365 のアクティビティ パッケージ内の各アクティビティに必要なスコープについて詳しくは、「 スコープを使用する 」および アクティビティ のドキュメントをご覧ください。コネクタは Microsoft Graph API を使用します。すべての権限について詳しくは、 Microsoft Graph のアクセス許可に関するこちらの ページをご覧ください。
アプリケーションを作成したら、そのクライアント ID とクライアント シークレットを使用して、Microsoft コネクタへのコネクションを作成します。
スコープ
- 必須のスコープ:
openid、email、offline_access、Files.Read - コネクタでコネクションを作成するには、
openid、offline_access、email、Files.Readの最小限のスコープが必要です。 - OneDrive のトリガーには、以下の最小スコープが必要です。
- SharePoint サイト上のイベントの場合:
openid、offline_access、User.Read.AllまたはUser.ReadとSites.Read.All。ではなくSites.Selectedを使用するには、「Sites.Read.Allの代わりに を使用するには、「特定の SharePoint サイトへのアクセスを制限する」をご覧ください。 - グループおよびカレンダーのイベントの場合:
Group.Read.All - 残りのすべてのイベントの種類の場合:
Files.Read.All
- SharePoint サイト上のイベントの場合:
コネクタが機能するには、すべてのアクティビティが機能するために、次の完全なスコープ セットが必要です: 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 インスタンスへのコネクションを作成するには、次の手順を実行します。
-
製品ランチャーから [Orchestrator] を選択します。
-
フォルダーを選択して [ コネクション ] タブに移動します。
-
[ コネクションを追加] を選択します。
-
コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。
-
認証の種類として [ Bring your own OAuth 2.0 app ] を選択します。
-
次のように設定します。
- クライアント ID - ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。
- クライアント シークレット - Microsoft Azure アプリケーションの [証明書とシークレット] セクションのクライアント シークレットです。
- スコープ - 必要に応じて、コネクタの権限を追加または削除します。
- テナント ID - [概要] セクションのアプリの Microsoft Azure テナント ID です。
注:
- マルチテナント アプリケーションを使用する場合は、既定値を common のままにします。
- シングルテナント アプリケーションを使用する場合は、Azure からテナント ID を取得します。詳しくは、「 Microsoft Entra テナント ID の確認方法」をご覧ください。
- 環境 - 任意で、ドロップダウン リストから環境を選択します。
- Office 365 (既定)
- 米国政府 L4 - 公共部門ドメイン
- 米国政府 L5 - 公共部門ドメイン
- 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
注:
-
[接続] を選択します。
利用可能な場合は、フィールドの横にあるメニューを選択し、[ 資格情報アセットを使用 ] または [ Orchestrator アセットを使用 ] を選択して、値を直接入力するのではなく Orchestrator アセットを参照します。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。
OAuth アプリケーションの更新トークン
OAuth アプリケーションの更新トークンは、Microsoft によっていつでも無効にされたり、取り消されたりされます。これは、タイムアウトや失効など、さまざまな理由で発生する可能性があります。詳しくは、 Microsoft の公式ドキュメントをご覧ください。
トークンを無効にすると、接続が失敗します。コネクションを修正しないとオートメーションを実行できません。
OAuth アプリケーションを作成する際は、Microsoft のベスト プラクティスに従ってください。OAuth 2.0 アプリケーションの作成方法の詳細については、 Microsoft の公式ドキュメントをご覧ください。
この問題は、OneDrive & SharePoint コネクタだけでなく、Outlook や Teams など、すべての Microsoft Graph ベースのコネクタに影響します。
PKCE を使用した OAuth 2.0 認可コード
概要
PKCE (Proof Key for Code Exchange) 認証 の種類の OAuth 2.0 認可コード は、Microsoft Entra ID に登録したプライベート アプリケーションにクライアント シークレットなしで接続します。アプリケーションにはクライアント シークレットがないため、ローテーションまたは保守するシークレットがありません。
このコネクションでは委任されたアクセス許可が使用されるため、作成時にサインインするユーザーの代わりに動作します。
アプリケーションの作成方法については、Microsoft の公式ドキュメント「 Register an application with the Microsoft identity platform」をご覧ください。
要件
アプリケーションを作成する際は、以下の要件を満たしていることを確認してください。
- アプリケーションを マルチテナント アプリケーションまたは単 一テナント アプリケーションとして設定します。
- モバイルおよびデスクトップ アプリケーション プラットフォームで、アプリケーションをパブリック クライアントとして設定します。
- モバイルおよびデスクトップ アプリケーション プラットフォームへのリダイレクト URI を追加します。アプリケーションのリダイレクト URI (またはコールバック URL) がコネクションの作成ページ (
https://{baseURL}/provisioning_/callbackで表示されます (例: Automation Cloud の場合はhttps://cloud.uipath.com/provisioning_/callback)。 - 委任されたアクセス許可を設定します。詳しくは、Microsoft の公式ドキュメントの 「アクセス許可の種類 」をご覧ください。
クライアント シークレットを生成する必要はありません。アプリケーションを作成したら、そのクライアント ID を使用してコネクションを作成します。
スコープ
- 必須のスコープ:
openid、email、offline_access、Files.Read - OneDrive のトリガーには、以下の最小スコープが必要です。
- SharePoint サイト上のイベントの場合:
openid、offline_access、User.Read.AllまたはUser.ReadとSites.Read.All。ではなくSites.Selectedを使用するには、「Sites.Read.Allの代わりに を使用するには、「特定の SharePoint サイトへのアクセスを制限する」をご覧ください。 - グループおよびカレンダーのイベントの場合:
Group.Read.All - 残りのすべてのイベントの種類の場合:
Files.Read.All
- SharePoint サイト上のイベントの場合:
コネクタが機能するには、すべてのアクティビティが機能するために、次の完全なスコープ セットが必要です: 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 インスタンスへのコネクションを作成するには、次の手順を実行します。
-
製品ランチャーから [Orchestrator] を選択します。
-
フォルダーを選択して [ コネクション ] タブに移動します。
-
[ コネクションを追加] を選択します。
-
コネクション作成ページを開くには、リストからコネクタを選択します。検索バーを使用してコネクタを検索できます。
-
PKCE 認証の種類 の [OAuth 2.0 認可コード ] を選択します。
-
次のように設定します。
- クライアント ID - ID は、Microsoft Azure アプリケーション登録の [概要] セクションで確認できます。
- テナント ID - [概要] セクションのアプリの Microsoft Azure テナント ID です。
注:
- マルチテナント アプリケーションを使用する場合は、既定値を common のままにします。
- シングルテナント アプリケーションを使用する場合は、Azure からテナント ID を取得します。詳しくは、「 Microsoft Entra テナント ID の確認方法」をご覧ください。
- スコープ - 必要に応じて、コネクタの権限を追加または削除します。
- 環境 - 任意で、ドロップダウン リストから環境を選択します。
- Office 365 (既定)
- 米国政府 L4 - 公共部門ドメイン
- 米国政府 L5 - 公共部門ドメイン
- 中国 すべてのリージョンで [Office 365 (既定)] を選択し、クラウドのデプロイには [政府機関] または [中国] にのみ切り替えます。
注:
利用可能な場合は、フィールドの横にあるメニューを選択し、[ 資格情報アセットを使用 ] または [ Orchestrator アセットを使用 ] を選択して、値を直接入力するのではなく Orchestrator アセットを参照します。詳細については、「 コネクションに資格情報アセットを使用する」をご覧ください。
-
[接続] を選択します。
-
Microsoft のメール アドレスとパスワードで認証します。
特定の SharePoint サイトへのアクセスを制限する
組織で Sites.Read.All や Files.Read.Allなどのテナント全体の権限が許可されていない場合は、代わりに Microsoft Graph の Sites.Selected 権限を使用してください。Sites.Selectedを使用すると、アプリケーションは SharePoint 管理者が明示的に許可した SharePoint サイトにのみアクセスできます。
Sites.Selected仕組みについて詳しくは、Microsoft のドキュメント「Overview of selected permissions in OneDrive and SharePoint」をご覧ください。
サポートされている認証の種類
| 認証の種類 | アプリの登録に追加する権限 | その他の必要なスコープ |
|---|---|---|
| OAuth 2.0 クライアント資格情報 | Sites.Selected (お申込み) | なし |
| 独自の OAuth 2.0 アプリ (BYOA) を使用する | Sites.Selected (委任されたアクセス許可) | 必須のスコープは、openid、email、offline_access、Files.Read です。 |
| PKCE を使用した OAuth 2.0 認可コード | Sites.Selected (委任されたアクセス許可) | 必須のスコープは、openid、email、offline_access、Files.Read です。 |
[Bring your own OAuth 2.0 app] と [PKCE を使用した OAuth 2.0 認可コード] を使用すると、コネクションは、アプリケーションとサインインしているユーザーの両方がアクセスできるサイトにのみアクセスできます。
前提条件
- Microsoft Entra ID 管理者が
Sites.Selected権限に対して管理者の同意を与えています。 - SharePoint 管理者が、Microsoft Graph での
POST /sites/{site-id}/permissions要求を通じて、オートメーションで使用される各 SharePoint サイトへのアクセス権をアプリケーションに付与しました。要求の形式と送信に必要なアクセス許可については、Microsoft ドキュメントの「 アクセス許可を作成」 をご覧ください。 - サイトで付与されるロールは、オートメーションの機能と一致します。
readロールは、ファイルの読み取りやイベント トリガーの使用に十分です。ファイルを作成または変更するアクティビティには、writeロールが必要です。
Sites.Selected を使用して SharePoint の場所を選択します
Microsoft Graph は、 Sites.Selected アクセス許可のみを持つアプリケーションにサイトの一覧を返しません。その結果、場所を参照すると SharePoint ドキュメント ライブラリ フォルダーは空になります。可能な場合は、代わりに場所の URL を入力します。
| 場所を選択する場所 | URL エントリが利用可能 |
|---|---|
| 接続していないトリガー (Orchestrator で作成されたイベント トリガー) | 利用可能です。「 接続していないトリガー」をご覧ください。 |
| 接続トリガー (プロセス内のトリガー アクティビティ) | 利用可能です。「 接続トリガー」をご覧ください。 |
| Microsoft 365 ファイル アクティビティ (ワークフロー内) | 利用可能です。詳しくは、「 アクティビティ」をご覧ください。 |
| コンテキスト グラウンディングのインデックス | 利用できません。 |
トリガーには、ドキュメント ライブラリまたはフォルダーの URL を使用します (例: https://example.sharepoint.com/sites/example/Shared%20Documents)。https://example.sharepoint.com/sites/exampleなどのサイト自体の URL を解決できません。
接続していないトリガー
接続していないトリガーの場所の URL を入力するには、次の手順を実行します。
- イベント トリガーの [検索場所 ] フィールドで、フィールドの横にあるメニューを選択して [ URL を入力] を選択します。
- アプリケーションがアクセスできるサイト内のドキュメント ライブラリまたはフォルダーの URL を貼り付けます。
- [ 検証] を選択します。
[ 検証 ] が表示されない場合、別のフィールドに移動したときに URL が解決されます。
URL は、場所のドライブ ID とアイテム ID に置き換えられます。
接続トリガー
プロセスを設計する際に、トリガー アクティビティの [場所] プロパティに同じ [URL を入力 ] オプションが用意されています。
デプロイ済みのプロセスを設定または変更するには、以下の手順を実行します。
- Orchestrator でプロセスを編集します。
- [ パッケージ要件 ] の手順に進みます。
- [Microsoft OneDrive & SharePoint] コネクションの下にある [イベント トリガー ] エントリを展開します。
- [ 検索場所 ] フィールドで、フィールドの横にあるメニューを選択し、[ URL を入力] を選択します。
- アプリケーションがアクセスできるサイト内のドキュメント ライブラリまたはフォルダーの URL を貼り付けます。
- [ 検証] を選択します。
[ 検証 ] が表示されない場合、別のフィールドに移動したときに URL が解決されます。
URL は、場所のドライブ ID とアイテム ID に置き換えられます。
Activities (アクティビティ)
Microsoft 365 ファイル系アクティビティでは、場所を参照しないでください。アプリケーションがアクセスできるサイト内のファイルまたはフォルダーの URL または ID を入力します。URL には、ファイル、フォルダー、またはドキュメント ライブラリの URL を使用できます。
Sites.Selectedは以下のアクティビティでサポートされます。
- ファイルをアップロード
- ファイルをダウンロード
- ファイル/フォルダーをコピー
- フォルダーを作成
- ファイル/フォルダーを削除
- ファイル/フォルダーの名前を変更
- ファイルまたはフォルダーの存在を確認
- ファイル/フォルダーを取得
- ファイルまたはフォルダーのメタデータを取得
- ファイルまたはフォルダーのメタデータを更新
- ファイルをチェックイン/チェックアウト
- 秘密度ラベルを取得
他のファイル系アクティビティでは、 Sites.Selected 権限は提供されません。詳しくは、各アクティビティのページをご覧ください。
Sites.Selected 接続のトラブルシューティング
SharePoint ドキュメント ライブラリ フォルダーが空です
症状: 場所を参照しても SharePoint ドキュメント ライブラリ フォルダーが空であるか、「 現在のパスの下にアイテムはありません 」というメッセージが表示されます。
原因: アプリケーションには Sites.Selected アクセス許可しかないため、Microsoft Graph はサイトを一覧表示しません。これは期待される動作です。
アクション: 「 Select a SharePoint location with Sites.Selected」の説明に従って、場所の URL を入力します。
共有 URL を解決できませんでした (ステータス コード 403)
症状: 場所の URL を入力すると、「 Failed to resolve share URL: Request failed with status code 403 」というエラーが表示されます。
原因: アプリケーションにサイトへのアクセス権が付与されていません。[Bring your own OAuth 2.0 app] または [PKCE を使用した OAuth 2.0 認可コード] を使用すると、サインインしているユーザーがサイトにアクセスできない可能性もあります。
アクション: SharePoint 管理者に、アプリケーションにサイトへのアクセス権を付与するように依頼し、サインインしているユーザーがサイトを開くことができることを確認します。
- 概要
- 管理者の同意
- 管理者の承認をリクエストする
- 要求を承認する (管理者)
- クライアント証明書の認証
- スコープ
- Microsoft OneDrive と SharePoint のコネクションを追加する
- OAuth 2.0 の認可コード
- スコープ
- Microsoft OneDrive と SharePoint のコネクションを追加する
- OAuth アプリケーションの更新トークン
- OAuth 2.0 クライアント資格情報
- スコープ
- Microsoft OneDrive と SharePoint のコネクションを追加する
- 独自の OAuth 2.0 アプリ (BYOA) を使用する
- 概要
- スコープ
- Microsoft OneDrive と SharePoint のコネクションを追加する
- OAuth アプリケーションの更新トークン
- PKCE を使用した OAuth 2.0 認可コード
- 概要
- スコープ
- Microsoft OneDrive と SharePoint のコネクションを追加する
- 特定の SharePoint サイトへのアクセスを制限する
- サポートされている認証の種類
- 前提条件
- Sites.Selected を使用して SharePoint の場所を選択します
- Sites.Selected 接続のトラブルシューティング