Microsoft 团队作用域

Microsoft Teams 活动使用 Microsoft Identity Platform ，通过 Microsoft 作用域 活动在 UiPath 和 Microsoft Teams 应用程序之间建立经过身份验证的连接。 此连接使机器人能够调用 Microsoft Graph API，代表您读取和写入资源。

要建立经过身份验证的连接，请首先在 Azure Active Directory 中注册 Microsoft Teams 应用程序（使用您的个人、工作和/或学校 Microsoft Office 365 帐户）。 注册应用程序时，您需要分配 Microsoft Graph API 权限 ，以指定机器人可以代表您访问的资源。

注册 Microsoft Teams 应用程序后，Azure Active Directory 会分配您在 Microsoft Teams 作用域 活动中输入的唯一应用程序（客户端）ID。 应用程序 ID 用于收集有关已注册应用程序的必要信息，以启动身份验证。

注意： 要了解有关注册应用程序和分配权限的更多信息，请参阅 设置 指南。 本指南分步指导您配置 Microsoft Teams 应用程序以实现自动化。

工作方式

以下步骤和消息序列图是活动从设计时（即活动依赖项和输入/输出属性）到运行时如何工作的示例。

1. 完成 设置 步骤。
2. 将“ Microsoft Teams 作用域”活动添加到您的项目中。

3. 为 身份验证、输入和 无人值守（如果适用）属性输入值。

   
   

   

   
   

有人值守自动化与无人值守自动化

Microsoft Teams 作用域 活动具有三种不同的身份验证流程（身份验证类型），在将活动添加到项目时，可以从中选择。 您的选择取决于您计划运行的自动化模式的类型（无人值守或有人值守）以及应用程序身份验证要求（如果不确定哪些身份验证要求适用于您的应用程序，请咨询管理员）。

身份验证类型	有人值守	无人值守
交互式令牌	X
集成的 Windows 身份验证	X	X
用户名和密码	X	X

重要提示： 无人值守的自动化不支持多重身份验证。 如果您的应用程序需要多重身份验证，则只能使用“交互式令牌”身份验证类型运行有人值守自动化。

交互式令牌

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

首次使用此身份验证类型运行 Microsoft Teams 作用域 活动时，系统会提示您通过 同意 对话框授权对资源（您在注册应用程序时授予的权限）的访问权限。

如果选择此选项，则“用户名”、“密码”和“租户”属性应留空。

此身份验证类型遵循 OAuth 2.0 授权代码流。

Windows 集成身份验证

集成 Windows 身份验证身份验证类型可用于有人值守自动化和无人值守自动化。 此选项可应用于在加入 Windows 域或 Azure Active Directory 的计算机上运行的 Windows 托管应用程序。

仅当已将注册的应用程序配置为支持 集成 Windows 身份验证时，才应选择此选项（更多信息可在 GitHub上找到）。

如果选择此选项，则“用户名”、“密码”和“租户”属性应留空。

用户名和密码

用户 名和密码身份验证类型可用于有人值守（不需要多重身份验证时）和无人值守自动化。

尽管 Microsoft 不建议这样做，但您可以在公共客户端应用程序中使用此身份验证类型。 使用此身份验证类型会对您的应用程序施加限制。 例如，使用此流程的应用程序将无法登录需要执行多重身份验证（条件访问）的用户。 它也不会使您的应用程序从单点登录中受益。 使用用户名/密码进行身份验证违反新式身份验证的原则，并且仅出于旧版原因而提供（更多信息请参见 GitHub ）。

如果选择此选项，则“ 用户 名” 和“ 密码 ” 属性是必需的，而“ 租户 ” 属性对于单租户应用程序是可选的（对于多租户应用程序是必需的）。

注意： 选择“用户 名和密码 身份验证 类型”时，“ 应用程序 ID”属性为必填项。您可以使用个人帐户、工作帐户和/或学校帐户注册 Microsoft Office 365 应用程序。

属性

将此活动添加到 UiPath Studio 中的项目时，会指定以下属性的值。

常见

显示名称

活动的显示名称。

属性	详细信息
类型	String
必填	是
默认值	Microsoft 团队作用域
允许的值	输入 String 或 String 变量。
注意	不适用

身份验证

应用程序 ID

在 安装过程中注册应用程序时，Azure Active Directory 分配的唯一应用程序（客户端）ID。

属性	详细信息
类型	String
必填	是
默认值	空白
允许的值	输入 String 或 String 变量。
注意	应用程序（客户端）ID 表示 Microsoft Teams 应用程序的实例。 单个组织的 Microsoft Office 365 帐户可以有多个应用程序（客户端）ID。 每个应用程序（客户端）ID 都包含其自己的权限和身份验证要求。 例如，您和您的同事都可以在公司的 Azure Active Directory 中注册 Microsoft Teams 应用程序，并生成您自己的应用程序（客户端）ID。

身份验证类型

已注册的应用程序所需的身份验证类型。

属性	详细信息
类型	下拉选择
必填	是
默认值	交互式令牌
允许的值	选择以下三个选项之一： 交互式令牌 集成 Windows 身份验证 用户名和密码
注意	有关这些选项以及要选择的选项的更多信息，请参阅上面的“无人值守和有人值守的自动化”部分。

租户

在 .dll 期间注册应用程序时，Azure Active Directory 分配的唯一目录（租户）ID

属性	详细信息
类型	String
必填	否（多租户应用程序需要）
默认值	空白
允许的值	输入 String 或 String 变量。
注意	目录（租户）ID 可以在已注册应用程序的概述页面中找到（在应用程序（客户端）ID 下）。

交互式令牌

OAuth 应用程序

指示要使用的应用程序 (客户端)。

属性	详细信息
类型	enum
必填	否
默认值	自定义
允许的值	自定义、UiPath
注意	如果选择了“UiPath”，则忽略应用程序 ID 和租户。

用户名和密码（无人值守）

这些属性仅在您运行无人值守自动化时适用。 指定这些属性的值时，请确保将 身份验证 类型属性设置为 用户名和密码。 有关详细信息，请参阅上面的“用户名和密码”部分。

密码

您的 Microsoft Office 365 帐户密码。

属性	详细信息
类型	String
必填	否（如果 身份验证 类型为“用户名和密码”，则为必填项）
默认值	空白
允许的值	输入 String 或 String 变量。
注意	不适用

安全密码

您的 Microsoft Office 365 帐户密码。

属性	详细信息
类型	SecureString
必填	否（如果 AuthenticationType 为 UsernameAndPassword ，则为必填项）并且 Password 为 null。
默认值	空白
允许的值	输入 SecureString 或 SecureString 变量。
注意	不适用

用户名

您的 Microsoft Office 365 帐户的用户名。

属性	详细信息
类型	String
必填	否（如果 身份验证 类型为“用户名和密码”，则为必填项）
默认值	空白
允许的值	输入 String 或 String 变量。
注意	不适用