Microsoft Outlook 365 身份验证

概述

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

• 客户端证书身份验证– 使用客户端证书而非客户端密码进行连接。
• OAuth 2.0 客户端凭据– 使用服务帐户，并选择连接到您的共享邮箱。
• 自带 OAuth 2.0 应用程序– 连接到您创建的私有应用程序，也可以选择连接到您的共享邮箱。

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

管理员同意

注意：本部分仅适用于“自带 OAuth 2.0 应用程序身份验证”选项。

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

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

客户端证书身份验证

作用域

连接器至少需要以下作用域才能创建连接： Mail.Read 、 User.Read.All或User.Read 。

连接器需要以下作用域，以便所有活动正常运行： User.Read 、 User.Read.All 、 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 。

要添加更细化的权限，请参阅活动文档。

添加 Microsoft Outlook 365 连接

要创建与 Microsoft Outlook 365 实例的连接，请按照以下步骤操作：

1. 在 Automation Cloud 中，从边栏菜单中选择“Integration Service” 。
2. 从“连接器”列表中，选择“Microsoft Outlook 365” ，或使用搜索栏查找连接器。
3. 选择“连接到 Microsoft Outlook 365” ，这会将您重定向到连接页面。
4. 选择客户端证书身份验证类型。
5. 配置以下内容：
   • 客户端 ID - Microsoft Azure 应用程序注册的“概述”部分中的 ID。
   • 证书密码- 在创建证书期间设置的密码。
   • OAuth base64 客户端证书- 客户端证书以.pfx文件格式生成，您必须将其转换为 Base64 编码格式并在此字段中提供。
   • 租户 ID - Microsoft Azure 应用程序注册时“概述”部分中应用程序的 Microsoft Azure 租户 ID。
   • “环境” - 从下拉列表中选择环境：
     • Office 365（默认）
     • 美国政府 L4 - 公共部门域
     • 美国政府 L5 - 公共部门域
     • 中国

       为所有区域选择“Office 365”（默认） ，并仅将云部署切换为“政府”或“中国” 。有关环境的更多详细信息，请查看Microsoft Graph 和 Graph Explorer 服务根端点。

   • 帐户- 输入系统应在连接中使用的帐户或共享邮箱的用户主体名称 (UPN)。这是建立连接的必要条件。
6. 选择“连接”。
7. 使用您的 Microsoft 电子邮件地址和密码进行身份验证。

OAuth 2.0 客户端凭据

作用域

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

连接器需要以下作用域，以便所有活动正常运行： User.Read 、 User.Read.All 、 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 。

要添加更细化的权限，请参阅活动文档。

添加 Microsoft Outlook 365 连接

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

1. 在 Automation Cloud 中，从边栏菜单中选择“Integration Service” 。
2. 从“连接器”列表中，选择“Microsoft Outlook 365” ，或使用搜索栏查找连接器。
3. 选择“连接到 Microsoft Outlook 365” ，这会将您重定向到连接页面。
4. 输入所需的凭据。
   备注：

   • 您必须提供以下信息：客户端 ID、客户端密码、租户 ID 以及与不同活动交互时可能需要的作用域。有关更多详细信息，请查看上一个“作用域”部分。
   • 如果您使用的是多租户应用程序，请保留“租户 ID”字段的默认值common 。
   • 如果您使用的是单租户应用程序，请从 Azure 检索租户 ID。有关更多详细信息，请查看如何查找您的 Microsoft Entra 租户 ID 。
5. 选择“连接”。
6. 使用您的 Microsoft 电子邮件地址和密码进行身份验证。

自带 OAuth 2.0 应用程序

概述

要了解如何创建应用程序，请参阅 Microsoft 官方文档并按照其中所述步骤操作：向 Microsoft 身份平台注册应用程序（使用 Microsoft Automation Cloud 中的平台注册） 。

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

要求

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

1. 您必须将应用程序配置为多租户或单租户应用程序。
2. 您必须配置Web应用程序。
3. 您必须配置网页重定向 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和Mail.Read 。
• Outlook 触发器需要的最小作用域如下：
  • 对于共享邮箱触发器： openid 、 offline_access 、 Mail.Read 、 Mail.Read.Shared 。
  • 对于日历上的事件： Calendars.Read 。
  • 对于共享日历上的事件： Calendars.Read.Shared 。

连接器需要以下作用域，以便所有活动正常运行： User.Read 、 User.Read.All 、 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 。

要添加更细化的权限，请参阅活动文档。

添加 Microsoft Outlook 365 连接

要创建与 Microsoft Outlook 365 实例的连接，请按照以下步骤操作：

1. 在 Automation Cloud 中，从边栏菜单中选择“Integration Service” 。
2. 从“连接器”列表中，选择“Microsoft Outlook 365” ，或使用搜索栏查找连接器。
3. 选择“连接到 Microsoft Outlook 365” ，这会将您重定向到连接页面。
4. 选择“自带 OAuth 2.0 应用程序”身份验证类型。
5. 配置以下内容：
   • 客户端 ID - Microsoft Azure 应用程序注册“概述”部分中的客户端 ID。
   • 客户端密码- Microsoft Azure 应用程序的“证书和密码”部分中的客户端密码。
   • 租户 ID - “概述”部分中显示的应用程序的 Microsoft Azure 租户 ID。
     备注：

     • 如果您使用多租户应用程序，请保留默认值common 。
     • 如果您使用单租户应用程序，请从 Azure 检索租户 ID。有关更多详细信息，请查看如何查找您的 Microsoft Entra 租户 ID 。
   • “环境” - 从下拉列表中选择环境：
     • Office 365（默认）
     • 美国政府 L4 - 公共部门域
     • 美国政府 L5 - 公共部门域
     • 中国

       为所有区域选择“Office 365”（默认） ，并仅将云部署切换为“政府”或“中国” 。有关环境的更多详细信息，请查看Microsoft Graph 和 Graph Explorer 服务根端点。

   • 帐户- 表示用于模拟用户的帐户。指定要在连接中使用的帐户或共享邮箱的用户主体名称 (UPN)。这是建立连接的必要条件。
6. 选择“连接”。
7. 使用您的 Microsoft 电子邮件地址和密码进行身份验证。

OAuth 应用程序的刷新令牌

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

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

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

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