身份验证

此页面列出了使用 Microsoft 365 活动包时可能遇到的身份验证问题。

我应该在 Microsoft 365 作用域活动中使用哪种身份验证类型

概述

首先，请确保查看以下资源：

1. 阅读与Microsoft 365 作用域活动相关的文档，其中包括有关可用身份验证类型的信息。
2. 要了解如何在 Azure AD 中注册自定义应用程序并设置图形 API 权限，请参阅设置页面。
3. 技术参考页面上提供了来自 Microsoft 365 活动的 Graph API 调用列表。
4. 要了解如何使用 UiPathStudioO365App 获取 InteractiveToken（即 OAuthApplication=UiPath），请参阅：
   • Microsoft Azure Marketplace 上的UiPathStudio0365App
   • 为 Outlook 365 自动化配置 Azure AD。
5. 请参阅 Microsoft 365 和 Google Workspace 卡 - API 权限和作用域页面上的使用应用程序卡所需的 API 权限。

作用域到特定邮箱

使用此身份验证类型时，应用程序可以访问租户中的所有邮箱。 这是因为应用程序 API 权限 Mail.Read 表示“读取所有邮箱中的邮件”，而 Mail.ReadWrite 表示“读取和写入所有邮箱中的邮件”。

可以将应用程序权限的作用域限制为特定邮箱，以便应用程序只能访问指定的邮箱：将应用程序权限作用域限制为特定的 Exchange Online 邮箱。

作用域到特定站点

使用 Sites.Selected 应用程序权限允许应用程序仅访问特定的 SharePoint 网站集，而不是全部。

使用用户名和密码进行身份验证失败

缺少参数：client_assertion 或 client_secret

问题：使用用户名和密码进行身份验证失败。显示的错误消息：

重要提示： “配置问题正在阻止身份验证 - 有关详细信息，请查看来自服务器的错误消息。 您可以在应用程序注册门户中修改配置。 请参阅 https://aka.ms/msal-net-invalid-client 有关详细信息。 原始异常：AADSTS7000218：请求正文必须包含以下参数：“client_assertion”或“client_secret”。”

解决方案：确保已注册的应用程序启用了“允许公共客户端流”配置字段。

应用程序未配置为多租户应用程序

问题：您收到以下错误消息：

重要提示： “应用程序 [...] 未配置为多租户应用程序。 2018 年 10 月 15 日之后创建的此类应用程序不支持使用 /common 端点。 使用特定于租户的端点，或将应用程序配置为多租户。”

解决方案：

• 设置“ 租户 ”参数的值。
• 将应用程序配置为多租户。

身份验证有效，但用户无法读取共享邮箱中的电子邮件

问题：在 Microsoft 365 活动中使用共享帐户时，可以在用户的个人帐户上检索邮件，但尝试从共享帐户读取电子邮件时，会显示“拒绝访问”错误。

解决方案：检查应用程序是否设置了 Mail.Read.Shared API 权限（委派）。 此权限允许应用程序读取用户可以访问的邮件，包括他们自己的邮件和共享的邮件。

错误：用户或管理员尚未同意使用该应用程序

问题：您收到以下错误消息：

重要提示： “用户或管理员尚未同意使用 ID 为 [...] 的应用程序 [...]。”

解决方案：确保按照以下步骤授予管理员权限。

集成 Windows 身份验证 (IWA) 在 v1.4.0 和 v1.5.0 中不起作用

问题：集成的 Windows 身份验证 (IWA) 可在 UiPath.MicrosoftOffice.365.Activities v1.3.1 中运行，但在 UiPath.MicrosoftOffice.365.Activities v1.4.0 和 v1.5.0 中不起作用。

解决方案：使用 UiPath.MicrosoftOffice.365.Activities 1.6.0 版本。

v1.4.0 和 v1.5.0 中的 ApplicationIdAndSecret 身份验证

问题：使用 UiPath.MicrosoftOffice.365.Activities v1.4.0 或 v1.5.0 时，即使已正确设置必需参数“应用程序 ID”和“应用程序密码”，“作用域”活动也会失败。

如果未设置 租户 参数，您可能会收到以下错误之一：

重要提示：

• “令牌不包含权限，或权限无法理解。”（多租户）
• “在目录 'microsoft.com' 中找不到标识符为 [...] 的应用程序。 如果租户管理员尚未安装应用程序，也未获得租户中任何用户的同意，则可能会发生这种情况。 您可能已将身份验证请求发送给了错误的租户。” （单租户）

解决方案：为“租户”参数设置一个值。

另一种选择是升级到 UiPath.MicrosoftOffice.365.Activities 版本 >= 1.6.0。 从 v1.6.0 开始， “租户 ”是必需参数。

Microsoft 365 作用域内的图形 API 请求

您可以在 Microsoft 365 作用域活动中发出图形 API 请求。 在“ 调用代码” 活动中使用“ 父级作用域” 对象时，可以实现此目的。

注意： 这适用于 Windows 旧版 .NET 4.6.1 项目。 对于 Windows .NET5 项目，此操作失败（错误消息“无法加载文件或程序集‘Microsoft.Graph，版本 = 3.32.0.0’”）。

请参阅下面的 Studio v2021.10 (Windows-Legacy) 和 UiPath.MicrosoftOffice.365.Activities v1.11.1 示例：

下载示例