交互式令牌

概述

• 运行：作为用户。
• 场景：Attended 自动化。
• 委派权限。

注意：这与 Integration Service 中支持的身份验证方法相同，即通过公共 UiPath 应用程序或私有自定义应用程序（自带应用程序方法）进行身份验证。

详细信息

• 交互式令牌身份验证类型可用于有人值守的自动化，以及在需要多重身份验证 (MFA) 时使用。 这是默认选项，也是我们在示例中使用的选项。 如果您有兴趣试用活动包，此选项易于配置，并且适用于个人帐户（使用指南中“注册应用程序”部分第 7 步中记录的默认重定向 URI）。

• 您可以选择注册和使用自己的 Azure 应用程序（即，OAuthApplication = UiPath）或 UiPath 提供的应用程序（OAuthApplication =“自定义”）：
  • UiPath 公共应用注册：使用 UiPath 公共应用的优点是您无需配置或维护应用程序注意：UiPath 不存储任何用户数据。 身份验证令牌仅保存在您的计算机或 Orchestrator 存储桶中。 请参阅“UiPath 公共应用注册” 。
  • 自定义应用注册：使用自己的自定义应用程序的优点是，您可以更精细地管理、自定义和分配组织内的权限。 请参阅如何为 Microsoft 365 作用域连接创建应用程序。
• 创建自定义应用程序时，您必须选择应用程序类型。 对于交互式令牌身份验证，请使用移动/桌面应用程序（使用OAuth 2.0 授权代码流程）。
• 当您使用此身份验证类型首次运行 Microsoft 365 活动时，系统会通过同意对话框提示您授权对资源的访问权限（您在注册应用程序时授予的权限）。 请参阅代表用户获取访问权限。
• 一个组织可以拥有多个应用程序（客户端）ID。 每个应用程序（客户端）ID 都包含其自己的权限和身份验证要求。 例如，您和您的同事都可以在公司的 Azure Active Directory 中使用不同的权限注册 Microsoft 365 应用程序。 您的应用程序可以配置为仅授权与文件交互的权限，而同事的应用程序配置为授权与文件、邮件和日历交互的权限。

• 如果您在Microsoft 365作用域中选择此身份验证类型，请将“用户名” 和“密码” 字段留空。 如果您使用的是单租户应用程序，请配置“租户”字段。 如果您使用的是多租户应用程序（UiPath 公共应用程序是多租户），则可以将“租户” 字段留空。

交互式令牌的作用域

当您将活动添加到Microsoft 365 作用域时，系统会自动检测其所需的作用域。 您还可以选择允许更多或更少的作用域。 如果选择的作用域较少，则某些活动功能可能无法正常工作。 有关更多信息，请参阅使用活动作用域。

UiPath 公共应用注册

已使用以下信息注册 UiPath 公共应用程序：

• 名称：UiPath Studio O365 应用程序
• 客户端 ID ： f2f43f65-16a6-4319-91b6-d2a342a88744
• 作用域：Calendars.Read、Calendars.Read.Shared、Calendars.ReadWrite、Calendars.ReadWrite.Shared、 Chat.ReadWrite、电子邮件、EWS.AccessAsUser.All、Files.Read、Files.Read.All、Files.ReadWrite、文件。 ReadWrite.All、Group.Read.All、Group.ReadWrite.All、Mail.Read、Mail.Read.Shared、Mail.ReadWrite、Mail.ReadWrite.Shared、Mail.Send、Mail.Send.Shared、offline_access、openid， Presence.Read、Presence.Read.All、配置文件、Sites.Read.All、Sites.ReadWrite.All、User.Read、User.Read.All。

如何为 Microsoft 365 作用域连接创建应用程序

要启用 Microsoft 365 传统活动，您的应用程序必须与 Microsoft 身份平台集成，并获配正确的 Microsoft Graph API 权限。

要集成应用程序、分配权限并开始构建自动化项目，请完成以下步骤：

1. 注册您的应用程序。
2. 添加 API 权限。
3. 构建项目。

注册 Microsoft 365 应用程序后，Azure Active Directory 会分配您在Microsoft 365 作用域活动中输入的唯一应用程序（客户端）ID，以及您分配权限的服务（例如，文件、邮件、日历）。

注册您的应用程序

提示：快速入门：向 Microsoft 身份平台注册应用程序中的 Microsoft 文档详细介绍了此流程。请注意，自首次记录这些步骤以来，Microsoft 用户界面可能已发生变化。

1. 使用您的个人、工作或学校 Microsoft 365 帐户登录 Azure 门户。
2. 在左侧导航面板中，单击“ Azure Active Directory”。
3. Azure Active Directory 页面打开后，单击“ 应用程序注册” 。

4. 单击顶部导航栏中的“ + 新注册 ”。

5. 输入应用程序的 名称 （例如，“Office365App”）。

6. 在“支持的帐户类型”下，选择适用于您的选项。有关选择何种选项的更多信息，请参阅谁可以登录您的应用程序？：

   • 仅限此组织目录中的帐户 - 如果您的目标受众是组织内部的帐户，请使用此选项。这表示单租户应用程序。
   • 任何组织目录中的帐户（任何 Azure AD 目录 - 多租户）- 如果您的目标受众是企业或教育客户，请使用此选项。这表示多租户应用程序。
   • 任何组织目录中的帐户和 Microsoft 个人帐户（例如 Skype, Xbox）- 使用此选项定位最广泛的 Microsoft 身份。这表示多租户应用程序。
7. 在“重定向 URI（可选）”下，输入 URI 地址（如果适用）。Microsoft 身份验证库 (MSAL.NET) 使用默认重定向 URI：https://login.microsoftonline.com/common/oauth2/nativeclient。使用“交互式令牌”身份验证类型时，此值可能适用。
   • 您的选择取决于您的身份验证类型。有关此主题的更多信息，请参阅如何连接到 Microsoft 365 活动。
   • 在我们的示例中，组织支持多租户身份验证，并且只能使用需要重定向 URI 的“交互式令牌”身份验证类型。
     • 如果您使用交互式令牌和默认的 Microsoft 重定向 URI，则必须添加类型为“移动和桌面应用程序”的平台。有关更多信息，请参阅 Microsoft 文档中的配置平台设置。
     • 如果您的身份验证类型为“集成 Windows 身份验证 (IWA)”或“用户名和密码”，则无需为应用程序注册重定向 URI。这些流程会往返于 Microsoft 身份平台 v2.0 端点，并且您的应用程序不会在任何特定 URI 上回调。
   • 在面向 .NET 5.0 的 UiPath Studio 项目中使用 Microsoft 365 时，将 http://localhost 添加到自定义应用程序的重定向 URI 中。

     有关详细信息，请参阅 Microsoft 标识平台文档中的 桌面应用程序注册 。

8. 选择“注册”。下图提供了示例配置。

   注意： 此设置只是一个示例。 请按照文档中所述的步骤操作，并根据组织的策略进行选择。
   
   

   

   
   

操作完毕！ 现在，我们向已注册的应用程序添加 API 权限。

添加 API 权限

1. 在已注册的应用程序页面（ Azure 门户 > Azure Active Directory > 应用注册 > Office365App ）中，在左侧导航面板中选择“ API 权限”。
2. “API 权限”页面打开后，单击“ + 添加权限 ”（这将打开“ 请求 API 权限 ”窗口）。
3. 在“ 选择 API” 下，单击“ Microsoft API ”（默认情况下可能处于打开状态）。

4. 在“ 常用 Microsoft API”下，单击“ Microsoft Graph”。

5. 在“您的应用程序需要什么类型的权限？”下，单击“委派权限”或“应用程序权限”以显示权限列表。如果使用“应用程序 ID 和密码”或“应用程序 ID 和证书”身份验证类型，请选择“应用程序权限”。“Microsoft 365 作用域”活动中可用的其他身份验证类型需要“委派权限”。

   有关权限类型的更多信息，请参阅 Microsoft Azure 文档中的 配置客户端应用程序以访问 Web API 。

6. 使用搜索栏或向下滚动按字母顺序排列的列表，然后选择以下权限：

   注意：这些权限并不都是必需的。提供的列表表示运行所有 Microsoft 365 活动所需的完整权限集。您可以根据特定用例限制权限。查看活动文档页面，了解其需要哪些权限。

   • 日历

     • 日历. 读取
     • Calendars.ReadWrite

   • 文件

     • 文件。读取
     • 文件读取全部
     • Files.ReadWrite
     • Files.ReadWrite.All

   • 网站

     • 站点。只读。全部
     • Sites.ReadWrite.All

   • 邮件

     • 邮件读取
     • 邮件读写
     • 邮件.发送
   • 用户
     • User.Read

   • 共享（访问与用户共享但并非用户所有的资源所需的作用域。）

     • 邮件读取共享
     • 邮件读写共享
     • 邮件.发送.共享
     • Calendars.Read.Shared
     • Calendars.ReadWrite.Shared

   • 选择“添加权限”以返回到 API 权限列表。

     
     

     

     
     

7. 确保您的 API 权限包括您添加的“日历”、“文件”、“用户”和“邮件”权限。

   
   

   

   
   

在桌面版 Studio 中构建项目

1. 创建一个新的自动化项目。

   1. 打开 UiPath Studio。

   2. 在“新建项目”下，单击“流程”。这将打开一个“新建空白流程”窗口。

   3. 输入项目 名称、 位置和 说明。

   4. 选择“ 兼容性”。 默认情况下选择“Windows”。

   5. 单击“创建”。

2. 安装 UiPath.MicrosoftOffice365.Activities 包。

   1. 从“设计”功能区中，选择“管理包”。
   2. 在“ 所有包”下的“ 搜索” 栏中，输入 Office 365 或 Microsoft。
   3. 选择所需的包版本，然后选择“安装”。
   4. 单击保存按钮。
   有关 UiPath Studio 包的更多信息，请参阅 Studio 指南中的 管理包 。

操作完毕！现在，您已完成设置，可以开始将 Microsoft 365 活动添加到项目中。

后续步骤

如需动手学习体验并快速开始使用这些活动，请参阅 快速入门 指南。 这些指南提供分步说明，以帮助您创建不同活动的工作示例，以便您可以验证与已注册应用程序的连接并熟悉输入/输出属性。

要了解有关 Microsoft 365 活动（包括示例属性输入/输出）的更多信息，请参阅传统活动以获取完整的列表以及指向活动详细页面的链接。