ServiceNow 身份验证

UiPath 支持 ServiceNow 的以下身份验证类型：

身份验证类型	描述	理想适用于
基本（用户名/密码）	通过 HTTPS 基本身份验证，使用 ServiceNow 用户直接登录。	简单的非 OAuth 设置非常适合快速 POC
OAuth 2.0 授权代码	用户登录到 ServiceNow 并向在 ServiceNow 中配置的 OAuth 客户端授予访问权限。	生产中需要强有力的监管和轻松撤销的用户委派场景。
OAuth 2.0 密码授予	服务帐户用户名/密码以及用于令牌交换的 OAuth 客户端凭据。	需要 OAuth 但无法进行交互式登录的服务到服务集成。

基本（用户名/密码）

连接字段

字段	描述
网站 URL	完整的 ServiceNow 实例 URL，例如https://your-instance.service-now.com 。。
用户名	ServiceNow 集成用户名。【
密码	集成用户的密码。秒必填。

常见问题

4XX 错误

• 验证实例 URL、用户名和密码；确保帐户处于活动状态，并且未被 IP/登录策略锁定或阻止。
• 检查用户是否可以读取sys_db_object 、 sys_dictionary并确保对目标表拥有必要的 ACL（读取/插入/更新/删除）。
• 确保您的 ServiceNow 实例未处于休眠状态。

OAuth 2.0 授权代码

此方法通过发出访问令牌来授予 UiPath 访问权限，而不需要将用户名和密码作为连接字段。

备注：

• 只有 ServiceNow Stanford 及更高版本支持 OAuth 2.0 授权代码授予流程。
• 应用程序的回调 URL 应为https://{baseURL}/provisioning_/callback （例如，对于 Automation Cloud，为https://cloud.uipath.com/provisioning_/callback ）。有关更多详细信息，请参阅设置 OAuth 。
• 对于华盛顿州和更早版本，请使用应用程序注册表中的为外部客户端创建 OAuth API 端点选项。以这种方式配置的现有 OAuth 2.0 应用程序可以继续工作。
• 对于苏黎世和澳大利亚，ServiceNow 已弃用“为外部客户端创建 OAuth API 端点”选项，取而代之的是计算机身份控制台中新的简化“入站集成”配置。请参阅为苏黎世和澳大利亚设置 OAuth（入站集成）以获取指导。

连接字段

字段	描述
网站 URL	完整的 ServiceNow 实例 URL（例如https://your-instance.service-now.com ）。。
客户端 ID	来自 ServiceNow应用程序注册表OAuth 客户端的客户端 ID。UiPath 使用。
客户端密码	来自同一 OAuth 客户端的客户端密码。

常见问题

• 重定向 URL 不匹配或无效重定向错误

  确认在 ServiceNow OAuth 客户端中配置的重定向 URL 与 UiPath 中显示的回调 URL（架构、主机、路径和斜杠）完全匹配。

• 已在 ServiceNow 中通过身份验证：显示“接受/拒绝”页面，而不是登录屏幕

  当浏览器已有活动的 ServiceNow 会话时，此行为是正常的。在这种情况下，ServiceNow 会跳过登录屏幕，直接显示 OAuth 同意（接受/拒绝）页面。

  • 如果这是正确的帐户，请单击“接受”以完成连接。
  • 如果您需要使用其他帐户，请在另一个浏览器选项卡中注销 ServiceNow，或在无痕/隐私窗口中重试该流程，然后使用目标用户登录。

  启用 SSO 时

  在某些 SSO 设置中，登录屏幕和“接受/拒绝同意”页面都不会显示。ServiceNow 假定当前已通过身份验证的用户并继续创建连接，这可能会由于缺少权限而失败。

  在这种情况下，请使用无痕/私有窗口，以确保可以通过正确的用户和所需权限进行身份验证。

• 登录和同意成功，但连接创建失败

  授权用户缺少对连接器使用的一个或多个表格的 ACL。授予元数据（ sys_db_object 、 sys_dictionary ）读取权限，并向相关业务表读取/写入 ACL，然后重新测试。

• 以前连接可以使用，但现在由于身份验证或令牌错误而失败

  访问令牌或刷新令牌可能已过期或被撤销（例如，在更改密码或 OAuth 客户端之后）。在 UiPath 中重新打开连接并重新授权。如果问题仍然存在，请检查是否修改或删除了 ServiceNow OAuth 客户端。

OAuth 2.0 密码

连接字段

字段	描述
网站 URL	完整的 ServiceNow 实例 URL。
用户名	ServiceNow 服务帐户用户名。
密码	该服务帐户的密码。
客户端 ID	ServiceNow OAuth 客户端中的客户端 ID。#
客户端密码	来自同一 OAuth 客户端的客户端密码。

设置 OAuth

备注：

以下过程适用于 ServiceNow 的“华盛顿”、“横滨”和更早版本。如果您在苏黎世或澳大利亚，请参阅为苏黎世和澳大利亚设置 OAuth（入站集成） 。

完成 ServiceNow 文档中的设置 OAuth步骤。

虽然所有 ServiceNow 平台区域中记录的步骤可能相同，但建议您按照特定区域的步骤操作，以防存在差异。

作为参考，以下过程说明了如何为我们的示例设置 OAuth。

1. 登录到您的 ServiceNow 实例（例如https://<span>dev74293.service-now.com/login</span> ）

2. 转到“系统定义”> “插件” ，并验证 OAuth 插件的“状态”是否设置为“活动” 。

   

3. 转到“系统 OAuth” > “应用程序注册表” ，然后选择“新建” 。

   • 当被问及什么类型的 OAuth 应用程序？ ，选择“为外部客户端创建 OAuth API 端点” 。

     

4. 输入应用程序的名称（例如UiPathQuickstart ），然后选择“提交” （如果成功，系统会将您重定向回“应用程序注册表”列表）。

   

5. 在“应用程序注册表”列表中，找到您的新应用程序，然后选择“名称”以打开详细信息页面。

6. 选择客户端密码旁边的锁形图标，以显示值。

7. Take note of the Client Id and Client Secret values.

8. 在其相应字段中输入以下重定向 URL： https://{baseURL}/provisioning_/callback （例如，表示 Automation Cloud，输入https://cloud.uipath.com/provisioning_/callback ）。

   

为苏黎世和澳大利亚设置 OAuth（入站集成）

对于澳大利亚苏黎世和更高版本，ServiceNow 已将“为外部客户端创建 OAuth API 端点”选项替换为通过计算机身份控制台配置的简化“入站集成”流程。

按照 ServiceNow 文档中的配置 OAuth 授权代码授予步骤创建入站集成。

配置入站集成时，请将重定向（回调）URL 设置为： https://{baseURL}/provisioning_/callback （例如，对于 Automation Cloud，设置为https://cloud.uipath.com/provisioning_/callback ）。

备注：

• 如果您希望默认情况下应用用户的访问控制和 API 策略，请取消选中“仅允许访问选定作用域中的 API” 。
• 如果启用“仅允许访问选定作用域中的 API”并分配作用域，则需要Tables API作用域才能使集成正常工作。

OAuth2.0 的令牌生命周期授权代码

在创建连接期间，UiPath 会将用户重定向到 ServiceNow；用户登录并批准 OAuth 客户端。UiPath 交换访问令牌和刷新令牌的授权代码，并安全地存储它们。访问令牌是短暂的； UiPath 会自动使用刷新令牌获取新的访问令牌，直到刷新令牌过期或同意被撤销。如果已在 ServiceNow 中删除 OAuth 客户端或撤销令牌，则必须重新授权 UiPath 连接。

ServiceNow 角色和权限

下表列出了创建连接和使用 ServiceNow 连接器所需的最低角色和权限。这些要求适用于所有身份验证类型。

ServiceNow 表格	操作	访问原因
表格 ( sys_db_object )	读取	“表格”模块/表格充当存储库，其中保存与 ServiceNow 实例中的每个表格相对应的行。它用于编译表格列表，以便执行操作或触发事件。在使用“选择对象”下拉列表进行 CRUD 活动时，加载所有表格是必要项。文档图像
字典 ( sys_dictionary )	读取	此表包含 ServiceNow 实例中特定表的相应列的数据。 选择表格执行操作时，必须使用此表格才能加载输入和输出字段。
选项 ( sys_choice )	读取	“选择” 表格包含选项列表中显示的选项的值，以及在我们策划的活动中查找的选项的值。 否则，活动中的设计时查找将无法加载。
用户 (sys_user)	读取	“选择” 表格包含选项列表中显示的选项的翻译文本，以及在我们策划的活动中查找的选项的翻译文本。否则，活动中的设计时用户查找将无法加载。

此外，用户还必须拥有对集成场景所必需的表格的访问控制权限。例如，如果您打算建立能够执行典型 ITIL 技术支持操作（例如，打开、更新和关闭故障、问题、更改和配置管理项目）的集成用户，则应分配itil角色。

创建自定义角色

某些基本系统角色（例如admin已包含这些表的访问控制。但是，如果您不想分配基本系统角色，并且旨在仅提供使用 ServiceNow 连接器所需的基本访问控制，则可以考虑创建具有必要访问权限的自定义角色。

要仅向特定表格或默认基本系统角色未涵盖的表格授予访问权限，我们建议创建自定义角色并根据需要分配适当的访问控制。

您必须为新角色提供下表中列出的访问控制，才能使用 ServiceNow 连接器/活动。例如，没有管理员权限的用户需要personalize_dictionary角色才能访问sys_dictionary表。

表格	类型	操作
表格 ( sys_db_object )	录制	读取
字典 ( sys_dictionary )	录制	读取
选项 ( sys_choice )	录制	读取
用户 (sys_user)	录制	读取
字段类 (sys_glide_object)	录制	读取

备注：

编辑或创建访问控制是具有security\_admin角色的用户的专属功能。如果您有任何不确定的情况，建议咨询 ServiceNow 管理员。您可以在提升权限的角色中找到其他信息。

为开展活动或触发器执行，您还需要提供其他访问控制。

例如，如果您的特定场景涉及使用 ServiceNow 事件启动工作流或创建 ServiceNow 事件，则需要授予以下访问控制权限。

表格	类型	操作
Incident	录制	读取
Incident	录制	写入

添加 ServiceNow 连接

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

1. 从产品启动器中选择“Orchestrator”。
2. 选择一个文件夹，然后导航到“连接”选项卡。
3. 选择“添加连接”。
4. 要打开连接创建页面，请从列表中选择连接器。您可以使用搜索栏查找连接器。
5. 选择您的首选身份验证类型，然后输入所需的凭据。
6. Select Connect.
7. 接下来，输入 ServiceNow 用户名和密码。该应用程序请求您允许连接到 ServiceNow 帐户并与记录交互。选择“允许” 。

有关创建与 ServiceNow 连接的更多信息，请参阅“ServiceNow 产品文档” 。