Microsoft Dynamics 365 CRM 身份验证

使用 OAuth 2.0 将 UiPath 连接到 Microsoft Dynamics 365 CRM，以便对自动化工作流中的 CRM 数据进行 API 级访问。

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 连接时，您可以在两种身份验证类型之间进行选择：

• 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. Select Connect.

4. 系统会将您重定向到 Microsoft 的登录和同意屏幕进行身份验证。

   此方法无需在 Azure AD 中进行额外设置，适合大多数用户。

自带您自己的 OAuth 2.0 应用程序

如果您的组织需要对 Azure AD 应用注册、作用域或合规性策略进行集中控制，请使用此选项。

当您在连接屏幕中选择“自带 OAuth 2.0 应用程序”时，您必须提供以下详细信息：

• 客户端 ID
• 客户端密码
• 租户 URL

重要提示：

必须与连接屏幕上显示的完全相同，将回调/重定向 URI https://{baseURL}/provisioning_/callback （例如https://cloud.uipath.com/provisioning_/callback ）添加到“网页类型的重定向 URI”下的 Azure AD 应用程序注册设置中。

此回调 URL 由 UiPath 预配置，无法在 Integration Service 用户界面中修改。

何时使用自定义应用程序

如果出现以下情况，请使用此选项：

• 您的组织需要由管理员管理的 Azure AD 应用注册。
• 您需要对应用程序权限和作用域进行精细控制。
• 您必须遵循 OAuth 应用程序的内部安全策略。

备注：

• 您请求的应用程序权限在您的租户中可能需要管理员同意。
• 必须为自定义应用配置 Dynamics CRM 的委派权限。

必填字段的说明

字段	描述
客户端 ID	Azure AD 应用程序 ID（仅在使用自己的应用程序时才需要）。
客户端密码	您为 Azure AD 应用程序生成的密码（自定义应用程序为必要项）。
租户 URL	您的 Dynamics 365 CRM 实例 URL（适用于两个选项）。
回调 URL	使用自定义应用程序时显示的预填充值；您必须在 Azure AD 中注册此 URL。

检索您的凭据

要查找您的租户 URL，请联系您的 Microsoft Dynamics 管理员。

如果您有权访问并使用单个全局租户，请按照以下步骤操作：

1. 转到https://portal.azure.com 。

2. 选择“Azure Active Directory”（Azure Active Directory组）。

3. 转到“管理”部分下的“属性” 。

4. 您的租户是租户 ID ，例如： sample083151e4.api.crm10.dynamics.com 。

   备注：

   Any mistake in the Tenant URL prevents you from authenticating and creating a connection.

如果要创建自己的私有 OAuth 2.0 应用程序，请按照 Microsoft Dynamics 365 文档中所述的步骤操作：

• 快速入门：向 Microsoft 身份平台注册应用程序
• 教程：使用 Microsoft Entra ID 注册应用程序

权限和同意

为了正常运行， Dynamics 365 CRM 连接需要以下 OAuth 作用域：

• user_impersonation
• offline_access
• User.Read

您可以使用该连接在 UiPath Studio 中启用Microsoft Dynamics 365 CRM 活动，以构建用于管理帐户、潜在客户、商机、事件和其他 CRM 功能的自动化。以下是可以实现的各种基于权限的用例：

作用域/权限	Use case	活动/事件
user_impersonation (必填)	需要user_impersonation作用域，才能在身份验证流程中发出请求，以使用 Azure 管理 API。 模拟用于代表另一个 Microsoft Dataosmos 用户执行业务逻辑（代码），以使用该模拟用户的适当角色和基于对象的安全性来提供所需的功能或服务。 这是必要操作，因为各种客户端和服务可以代表 Dataosmos 用户调用 Dataosmos Web 服务，例如，在工作流或自定义 ISV 解决方案中。	不适用
offline_access (必填)	在身份验证请求端点中接收刷新令牌需要offline_access 。 在没有offline_access作用域的 OAuth 2.0 授权代码流程中兑换授权代码时，您将不会从/token端点收到刷新令牌。	不适用
User.Read (必填)	允许用户登录到应用程序，并允许应用程序读取已登录用户的个人资料。 它还允许应用程序读取已登录用户的基本公司信息。	不适用

根据您公司的 Azure AD 策略，可能需要管理员是否同意（仅适用于 Azure AD）。

OAuth 应用程序的刷新令牌

Microsoft 可以随时使或撤销 OAuth 应用程序的刷新令牌。发生这种情况的原因可能有很多，例如超时和撤销。有关详细信息，请参阅 Microsoft 官方文档。

备注：

令牌失效会导致连接失败，并且在不修复连接的情况下，自动化将无法运行。

此问题会影响所有基于 Microsoft Graph 的连接器。

创建 OAuth 应用程序时，请务必遵循 Microsoft 的最佳实践。有关如何创建 Microsoft OAuth 应用程序的完整详细信息，请查看 Microsoft文档。

添加 Microsoft Dynamics 365 连接

1. 从产品启动器中选择“Orchestrator”。

2. 选择一个文件夹，然后导航到“连接”选项卡。

3. 选择“添加连接”。

4. 要打开连接创建页面，请从列表中选择连接器。您可以使用搜索栏查找连接器。

5. 您可以选择两种身份验证类型：“OAuth 2.0 授权代码”或“自带 OAuth 2.0 应用程序”。

6. 输入所需的凭据，然后选择“连接” 。

   在可用的情况下，选择字段旁边的菜单，然后选择“使用凭据资产”或“使用 Orchestrator 资产”以引用 Orchestrator 资产，而不是直接输入值。有关更多信息，请参阅使用凭据资产进行连接。

有关 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 配置，则可能导致连接失败。