身份验证故障排除

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

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

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

1. 阅读与Microsoft 365 作用域活动相关的文档，其中包括有关可用身份验证类型的信息。

2. 要了解如何在 Azure AD 中注册自定义应用程序并设置图形 API 权限，请参阅自定义 OAuth 应用程序注册 - 自带应用程序 (BYOA)指南。

3. 技术参考页面上提供了来自 Microsoft 365 活动的 Graph API 调用列表。

4. 要了解有关将 UiPathStudio0365App 用于交互式令牌（即OAuthApplication = UiPath ），请检查：

   • Microsoft Azure 市场上的UiPathStudio 或 365 应用程序
   • 为 Outlook 365 自动化配置 Azure AD 。

5. 在 Microsoft 365 和 Google Workspace 卡 - API 权限和作用域 页面上查看 使用应用程序 卡所需的 API 权限。

作用域到特定邮箱

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

可以将应用程序权限作用域到特定邮箱，因此应用程序只能访问指定的邮箱：将应用程序权限作用域到特定的 Exchange Online 邮箱（将应用程序的权限限制到特定的 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-Legacy .NET 4.6.1 项目。Windows .NET5 项目失败（错误消息“无法加载文件或程序集 'Microsoft.Graph，Version=3.32.0.0'”）。

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

下载示例