Microsoft 团队身份验证

本文档介绍如何使用 OAuth 2.0 通过UiPath Integration Service对 Microsoft Teams 进行身份验证。Microsoft Teams 连接器支持基于用户的 OAuth 身份验证，为自定义 OAuth 应用程序和启用机器人的方案提供了可选支持。

概述

下表总结了支持的身份验证选项及其先决条件。

身份验证场景	描述	先决条件
UiPath 管理的 OAuth（授权代码）	使用由 UiPath 管理的应用程序	Microsoft Teams 帐户，能够授予同意
自带 OAuth 应用程序 (BYOA)	使用客户管理的 Azure AD 应用程序	Azure AD 应用程序、客户端 ID、客户端密码、租户 ID、管理员同意

OAuth 2.0 身份验证

包含机器人

The Include Bot option determines whether the connection includes Microsoft Teams bot-based access in addition to user-delegated OAuth permissions. Selecting this option enables sending messages as Uipath notification with your connection.

设置	行为
否（默认）	仅限用户委派的 OAuth
是	启用 Microsoft Teams 机器人功能

备注：

• 机器人身份验证需要在 Azure 中已注册的 Microsoft Teams 机器人。
• 大多数 Microsoft Teams 活动都不需要机器人支持。
• 仅当您的自动化明确需要机器人功能时，才使用此选项。

自带 OAuth OAuth 应用程序 (BYOA) 配置

如果选择“自带 OAuth 应用程序” ，请按如下方式配置 Azure AD 应用程序。

Azure 应用程序设置

设置	值
OAuth 流程	授权代码
重定向 URL/回调 URL	https://{baseURL}/provisioning_/callback（例如https://cloud.uipath.com/provisioning_/callback表示 Automation Cloud）。
支持的帐户类型	单租户或多租户
API	Microsoft Graph

租户 ID

应用程序类型	租户 ID
Multi-tenant	common
单租户	Azure 租户 ID

备注：

UiPath 支持单租户和多租户应用程序。

作用域和权限

作用域控制 UiPath 可以在 Microsoft Teams 中执行的操作。可以在创建连接期间配置作用域。

必需作用域

以下作用域是必需的，不得删除。它们是成功连接所必需的。

范围	用途
openid	用户身份验证和 ID 令牌生成
offline_access	启用刷新令牌颁发
User.Read	读取已登录用户的个人资料

备注：

删除任何必需作用域将导致连接或运行时身份验证失败。

所有作用域

以下作用域可实现常见的 Microsoft Teams 自动化方案。

范围	Use case	活动或事件
openid	通过使用此权限，应用程序可以子声明的形式接收用户的唯一标识符。 此权限还向应用程序授予访问UserInfo端点的权限。 可以在 Microsoft 身份平台令牌端点使用openid作用域来获取 ID 令牌。 应用程序可以使用这些令牌进行身份验证	不适用
offline_access	用于在身份验证请求端点中接收刷新令牌。在没有 offline\_access 作用域的 OAuth 2.0 授权代码流程中兑换授权代码时，您将不会从 /token 端点收到刷新令牌。	不适用
profile	检索当前用户的配置文件，例如姓名、用户名、电子邮件地址等，以便在创建连接时和在某些活动中将其用作默认/经过身份验证的用户	不适用
email	允许应用程序读取所有用户的主要电子邮件地址，以便发送消息或邀请他们加入频道	发送个人聊天消息、邀请成员加入频道、邀请用户加入团队
User.Read	允许用户登录到应用程序，并允许应用程序读取已登录用户的个人资料。 它还允许应用读取已登录用户的公司基本信息	获取记录 → 我
Team.Create	创建团队以邀请相应的用户并与之互动	插入记录 → Teams
Team.ReadBasic.All	检索要在活动中选择的团队列表，例如发送频道消息等。	创建频道、列出所有频道、发送聊天消息、发送个人聊天消息、邀请成员加入频道、回复频道消息、发送频道消息、按名称获取团队
TeamMember.ReadWrite.All	代表已登录的用户将成员添加到团队检索团队的成员列表	列出所有团队成员，邀请用户加入团队，按名称获取团队，插入记录 → 团队成员，列出所有记录 → 团队成员
Channel.Create	创建频道 (标准/私人)，用于邀请团队中的相应用户并与之互动	创建频道
Channel.ReadBasic.All	检索要在活动 (例如发送频道消息等) 中选择的团队频道列表。	按名称获取频道、邀请成员加入频道、列出所有频道、按名称列出频道、回复频道消息、发送频道消息
ChannelMember.ReadWrite.All	代表已登录的用户将成员添加到频道检索频道中涉及的成员列表	邀请成员加入频道，列出所有记录 → Teams 频道成员
ChannelMessage.Send	在频道中发送消息。 此外，如果需要，还可以回复会话中的消息。	回复频道消息、发送频道消息
ChannelMessage.Read.All	允许应用在用户未登录的情况下阅读 Microsoft Teams 中的所有频道消息也用于在频道中发布消息或频道中提到关键字时触发事件	回复频道消息、列出所有频道消息、列出所有记录 → Teams 频道消息、在频道中发布消息时（未来）、当频道中提及关键字或用户名时（未来）
Chat.ReadWrite	允许应用读取和发送您的一对一对话允许应用读取和发送群聊消息也用于在发布聊天消息时触发事件	“发送组聊天消息”、“发送个人聊天消息”、“列出所有聊天消息”、“列出所有记录”→ “聊天”、发布聊天消息时（未来）
ChatMember.ReadWrite	代表已登录的用户将成员添加到聊天中检索聊天中涉及的成员列表	插入记录 → 聊天成员，列出所有记录 → 聊天成员
Calendars.ReadWrite	创建在线 Teams 会议的 Outlook 日历条目。	创建在线 Teams 会议
OnlineMeetings.ReadWrite	在 Microsoft Teams 中创建在线会议，并代表当前用户检索会议 ID、密码和 URL。	创建在线 Teams 会议
Files.Read.All	检索已上传到 SharePoint 的文件信息，以便在 Teams 频道或聊天中共享该文件	发送频道消息、发送组聊天消息、发送个人聊天消息、回复频道消息

可以添加或删除作用域，以遵循最小权限原则。

OAuth 应用程序的刷新令牌

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

备注：

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

此问题会影响所有基于 Microsoft Graph 的连接器。

创建 OAuth 应用程序时，请务必遵循 Microsoft 的最佳实践。有关如何创建 Microsoft OAuth 应用程序的完整详细信息，请查看 Microsoft文档。

添加 Microsoft Teams 连接

要创建与 Microsoft Teams 实例的连接，您需要执行以下步骤：

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Select Add connection.
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. 您可以选择两种身份验证类型：“OAuth 2.0 授权代码”或“自带 OAuth 2.0 应用程序”。
6. 输入所需的凭据。
7. Select Connect.

有关在 Microsoft Teams 中进行身份验证的更多信息，请参阅 Microsoft身份验证和授权页面。