Microsoft Outlook 365 身份验证

概述

在 Integration Service 中，当您创建与某个基于 Microsoft Graph 的连接器的连接时，您可以在以下身份验证选项之间进行选择：

• OAuth 2.0 授权代码– 使用您的 Microsoft 帐户凭据连接到 UiPath 公共应用程序，并可选择连接到您的共享邮箱。
• OAuth 2.0 客户端凭据– 使用服务帐户，并选择连接到您的共享邮箱。
• 自带 OAuth 2.0 应用程序– 连接到您创建的私有应用程序，也可以选择连接到您的共享邮箱。

注意：有关不同身份验证类型的更多详细信息，请查看如何连接到 Microsoft 365 活动。

如果您在登录过程中遇到任何错误，建议您联系 Microsoft Outlook 365 管理员。有关更多信息，请参阅Office 365 Outlook 连接器文档。

管理员同意

注意：本节仅适用于“OAuth 2.0 授权代码”和“自带 OAuth 2.0 应用程序身份验证”选项。

在创建与外部应用程序的连接之前，许多组织都需要管理员的同意。管理员同意工作流要求在建立连接之前，需要管理员批准特定用户或组的应用注册。有关更多详细信息，请查看 Microsoft 文档中的管理员同意工作流概述以及Microsoft Entra ID 中的用户和管理员同意。

注意： Integration Service 会模拟创建连接的用户。用户的凭据可用于访问其在给定应用程序中拥有的所有相同资源。如果共享连接，则系统会代表该连接使用该连接对 Microsoft SharePoint 或 OneDrive 进行所有更改。

OAuth 2.0 授权代码

作用域

连接器请求以下权限或作用域： Mail.Read 、 Mail.Read.Shared 、 Mail.ReadWrite 、 Mail.ReadWrite.Shared 、 Mail.Send 、 Mail.Send.Shared 、 MailboxSettings.ReadWrite 、 Calendars.Read 、 Calendars.Read.Shared 、 Calendars.ReadWrite 、 Calendars.ReadWrite.Shared 、 profile 、 openid 、 email 、 offline_access 、 User.Read.All或User.Read 。

添加 Microsoft Outlook 365 连接

要创建与 Microsoft Outlook 365 实例的连接，请执行以下步骤：

1. 从左侧栏中选择“Integration Service”。
2. 从“连接器”列表中，选择“Microsoft Outlook 365” ，或使用搜索栏查找连接器。
3. 选择“连接到 Microsoft Outlook 365” 。
4. 您现在已重定向到连接页面。
5. 选择“OAuth 2.0 授权代码”身份验证类型。
6. 从下拉列表中选择环境： “Office 365”（默认） 、 “美国政府 L4 - 公共部门域”、 “美国政府 L5 - 公共部门域” 或“中国” 。
   注意：有关环境的更多详细信息，请查看Microsoft Graph 和 Graph Explorer 服务根端点。
7. （可选）在“共享邮箱”字段中输入您的共享邮箱。
   注意：连接后，所有 Outlook 活动将继承共享邮箱。
8. 选择“连接”。
9. 使用您的 Microsoft 电子邮件地址和密码进行身份验证。

OAuth 应用程序的刷新令牌

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

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

创建 OAuth 应用程序时，请确保遵循 Microsoft 的最佳实践。 有关如何创建 Microsoft OAuth 应用程序的完整详细信息，请参阅 Microsoft文档。

此问题不仅会影响 OneDrive 和 SharePoint 连接器，还会影响所有基于 Microsoft Graph 的连接器，例如 Outlook 或 Teams。

OAuth 2.0 客户端凭据

作用域

创建连接所需的最小作用域如下： Mail.Read 、 User.Read.All或User.Read 。

添加 Microsoft Outlook 365 连接

要创建与 Microsoft Outlook 365 实例的连接，请执行以下步骤：

1. 从左侧栏中选择“Integration Service”。
2. 从“连接器”列表中，选择“Microsoft Outlook 365” ，或使用搜索栏查找连接器。
3. 选择“连接到 Microsoft Outlook 365” 。
4. 您现在已重定向到连接页面。
5. 点击齿轮图标，选择“OAuth 2.0 客户端凭据”身份验证类型。
6. 填写必填字段“客户端 ID” 、 “客户端密码” ，以及（可选）填写字段“租户 ID” 、 “环境” 、 “共享邮箱”和“帐户” 。
   备注：

   • 此身份验证类型仅适用于应用程序权限，并且不需要模拟用户。如果不输入任何“帐户” ，则连接的作用类似于服务帐户，但不会模拟任何用户。当您输入帐户时，它表示模拟用户的帐户。
   • 该帐户对于 Outlook 和日历触发器和活动是必需的。
7. 选择“连接”。

自带 OAuth 2.0 应用程序

概述

要了解如何创建应用程序，请转到 Microsoft 官方文档并按照其中描述的步骤操作：使用 Microsoft 身份平台注册应用程序。

注意：这是一项高级功能，需要目标应用程序中的管理员权限。 与您的 IT 管理员合作，成功设置您的应用程序。

要求

创建自己的应用程序以与 Integration Service 一起使用时，您必须考虑以下要求：

1. 您必须将应用程序配置为多租户或单租户应用程序。
2. 您必须配置Web应用程序。
3. 您必须配置网页重定向 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 连接器的连接。

作用域

• 创建连接所需的最小作用域： openid 、 offline_access 、 Mail.Read 。
• Outlook 触发器所需的最小作用域列表:
  • 对于共享邮箱触发器： openid 、 offline_access 、 Mail.Read 、 Mail.Read.Shared 。
  • 对于日历上的事件： Calendars.Read 。
  • 对于共享日历上的事件： Calendars.Read.Shared 。

添加 Microsoft Outlook 365 连接

要创建与 Microsoft Outlook 365 实例的连接，请执行以下步骤：

1. 从左侧栏中选择“Integration Service”。
2. 从“连接器”列表中，选择“Microsoft Outlook 365” ，或使用搜索栏查找连接器。
3. 选择“连接到 Microsoft Outlook 365” 。
4. 您现在已重定向到连接页面。
5. 选择“自带 OAuth 2.0 应用程序”身份验证类型。
6. 填写必填字段： 客户端 ID 和 客户端密码 ，以及与不同活动、 租户 ID 、 环境 和 共享邮箱 交互（可选）的 作用域 。
   备注：

   • 有关更多详细信息，请查看活动文档，以了解它们需要的作用域。
   • 如果您使用多租户应用程序，请保留租户 ID的默认值 ( common )。
   • 如果您使用单租户应用程序，请从 Azure 检索租户 ID。有关更多详细信息，请查看如何查找您的 Microsoft Entra 租户 ID 。

OAuth 应用程序的刷新令牌

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

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

创建 OAuth 应用程序时，请确保遵循 Microsoft 的最佳实践。 有关如何创建 Microsoft OAuth 应用程序的完整详细信息，请参阅 Microsoft文档。

此问题不仅会影响 OneDrive 和 SharePoint 连接器，还会影响所有基于 Microsoft Graph 的连接器，例如 Outlook 或 Teams。