Microsoft Dynamics 365 CRM の認証

UiPath Integration Service は、OAuth 2.0 ベースの認証を使用して、Microsoft Dynamics 365 CRM インスタンスへのセキュリティで保護された接続を可能にします。認証が完了すると、オートメーション ワークフローの Dynamics 365 CRM データへの API レベルのアクセスを許可する接続を作成できます。

Microsoft Dynamics 365 CRM にコネクションを追加すると、UiPath 製品は CRM データと対話できます (Dynamics 365 CRM での認証済みユーザーの権限に応じて、レコードの読み取り、書き込み、変更、削除など)。

サポートされている認証の種類

Dynamics 365 CRM のコネクションを作成する際、次の 2 つの認証の種類から選択できます。

• OAuth 2.0 認可コード (既定および推奨)
• 独自の OAuth 2.0 アプリ ( カスタム アプリの登録) を使用する

OAuth 2.0 の認可コード

これは最も単純な認証方法です。このオプションでは、UiPath のマネージド Azure AD アプリケーションを使用して、ユーザーのサインインとトークンの取得を処理します。

1. コネクション作成画面で [ OAuth 2.0 認可コード] を選択します。

2. [テナント URL] ( [https://<yourorg>.crm.dynamics.com] ) を入力します

   注:

   テナント URL の値は、Dynamics 365 CRM の基本ドメインと正確に一致している必要があります。

3. [接続] をクリックします。

4. 認証のために、Microsoft のサインイン画面と同意画面にリダイレクトされます。

   この方法は Azure AD での追加セットアップは不要で、ほとんどのユーザーに適しています。

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

組織が Azure AD アプリの登録、スコープ、またはコンプライアンス ポリシーを一元的に制御する必要がある場合は、このオプションを使用します。

接続画面で [ Bring your own OAuth 2.0 app ] を選択する場合は、以下の詳細情報を指定する必要があります。

• クライアント ID
• クライアント シークレット
• テナント URL

重要:

コールバック/リダイレクト URI https://{baseURL}/provisioning_/callback (例: https://cloud.uipath.com/provisioning_/callback) は、Azure AD のアプリケーションの登録設定の [Web の種類のリダイレクト URI] に、接続画面に表示されているとおりに追加する必要があります。

このコールバック URL は UiPath によって事前に構成されており、Integration Service の UI で変更することはできません。

カスタム アプリを使用する状況

このオプションは、次の場合に使用します。

• 組織では、管理者が管理する Azure AD アプリの登録が必要です。
• アプリの権限と範囲をきめ細かく制御する必要がある。
• OAuth アプリケーションの内部セキュリティ ポリシーに従う必要があります。

注:

• 要求するアプリのアクセス許可については、テナントの管理者の同意が必要な場合があります。
• カスタム アプリは、Dynamics CRM の 委任されたアクセス許可 を使用して構成する必要があります。

必須フィールドの説明

フィールド	説明
クライアント ID	Azure AD アプリケーション ID (独自のアプリを使用する場合にのみ必要)。
クライアント シークレット	Azure AD アプリ用に生成したシークレット (カスタム アプリに必要)。
テナント URL	お使いの Dynamics 365 CRM インスタンスの URL (両方のオプション)。
コールバック URL	カスタム アプリの使用時に表示される、事前に入力された値。この URL を Azure AD に登録する必要があります。

資格情報を取得する

テナント URL を取得するには、Microsoft Dynamics の管理者にお問い合わせください。

単一のグローバル テナントにアクセスして使用する場合は、以下の手順を実行します。

1. [https://portal.azure.com] に移動します。

2. [Azure Active Directory] を選択します。

3. [Manage] セクション下の [Properties] に移動します。

4. [ Tenant ID] がテナントです (例: sample083151e4.api.crm10.dynamics.com)。

   注:

   テナント URL に誤りがある場合は、認証ならびにコネクションの作成はできません。

独自のプライベート OAuth 2.0 アプリケーションを作成する場合は、Microsoft Dynamics 365 のドキュメントに記載されている手順に従います。

• クイック スタート: Microsoft ID プラットフォームにアプリケーションを登録する
• チュートリアル: Microsoft Entra ID にアプリを登録する

権限と同意

Dynamics 365 CRM 接続が正しく機能するには、次の OAuth スコープが必要です。

• user_impersonation
• offline_access
• User.Read

コネクションを使用して、UiPath Studio で Microsoft Dynamics 365 CRM アクティビティ を有効化することで、取引先企業、リード、営業案件、インシデント、その他の CRM 機能を管理するためのオートメーションを構築できます。実現できるさまざまな権限ベースのユース ケースは次のとおりです。

スコープ/権限	ユースケース	アクティビティ/イベント
user_impersonation (必須)	user_impersonation スコープは、Azure 管理 API を使用するために認証フローで要求するために必要です。偽装は、別の Microsoft Dataverse ユーザーに代わってビジネス ロジック (コード) を実行し、偽装されたユーザーの適切なロールとオブジェクト ベースのセキュリティを使用して目的の機能またはサービスを提供するために使用されます。 これは、ワークフローやカスタム ISV ソリューションなど、Dataverse ユーザーに代わってさまざまなクライアントやサービスから Dataverse Web サービスを呼び出すことができるためです。	N/A
offline_access (必須)	offline_access は、認証要求エンドポイントで更新トークンを受信するために必要です。スコープなしで OAuth 2.0 認証コード フローで認証コードを引き換えるとoffline_access/token エンドポイントから更新トークンを受け取りません。	N/A
User.Read (必須)	ユーザーがアプリにサインインできるようにし、サインインしているユーザーのプロフィールをアプリが読み取ることを許可します。 また、サインインしているユーザーの基本的な会社情報を読み取ることもアプリに許可します。	N/A

企業の Azure AD ポリシーによっては、管理者の同意が必要になる場合があります。

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

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

注:

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

この問題は、すべての Microsoft Graph ベースのコネクタに影響します。

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

Microsoft Dynamics 365 コネクションを追加する

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Select Add connection.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. [OAuth 2.0 認可コード] または [独自の OAuth 2.0 アプリ (BYOA) を使用する] の 2 つの認証の種類から選択できます。
6. 必要な資格情報を入力し、[接続] を選択します。

Microsoft Dynamics 365 の詳細については、[Microsoft Dynamics 365 のドキュメント] をご覧ください。

セットアップに関する一般的な問題のトラブルシューティング

• リダイレクト URI が無効 です – Azure AD アプリのリダイレクト URI に登録されているコールバック URL ( https://{baseURL}/provisioning_/callback https://cloud.uipath.com/provisioning_/callbackなど) が正確であることを確認します。
• アクセス許可が付与されていません – Dynamics CRM スコープには管理者の同意が必要な場合があります。
• 間違ったテナント URL – 組織の正確な CRM ベース URL を使用していることを確認してください。
• 更新トークン/同意の問題 – 最初の同意後に Azure AD の設定が変更されると、接続が失敗する可能性があります。