ServiceNow 数据连接器

若要设置 ServiceNow CMDB 集成,需要提供 ServiceNow 实例的主机名和有效凭据。 连接器使用用户名和密码对基本身份验证进行身份验证,以便进行只读访问。

注意

建议创建一个专用用户,以便在曝光管理中与数据连接器配合使用。

ServiceNow 配置

  1. 查找 ServiceNow 实例的主机名。 例如,“contoso.service-now.com”。  
  2. 创建新的 ServiceNow 用户:
    1. 按照 此处 的步骤创建新用户。
    2. 请将 用户名 (用户 ID) 和密码 保留,以供将来使用。
    3. 如果没有密码字段,请提交表单以创建用户。 之后,选择新用户时,将收到 “设置密码” 选项。
    4. 创建用户时,检查“仅访问 Web 服务”框,以便用户将专用于此集成。
  3. cmdb_read 角色分配给已创建的用户。 可 在此处找到详细说明。

注意

ServiceNow 连接器仅支持基本身份验证。 稍后将提供 OAuth 身份验证。

在公开管理中建立 ServiceNow 连接

若要在公开管理中与 ServiceNow 建立连接,请执行以下步骤:

  1. 从“公开管理”导航中打开 “数据连接器 ”,然后在“ServiceNow CMDB”磁贴中选择“ 连接 ”。
  2. 输入 ServiceNow 配置) (创建的 ServiceNow 实例详细信息凭据 ,然后选择“ 连接”。

检索到的数据

公开管理当前检索设备上的数据、其业务应用程序关联和业务关键性。 还会检索有助于识别设备的其他数据,例如网络适配器信息和 OS 数据。

根据评估 ServiceNow CI 中的“sys_updated_on”字段,仅检索过去 90 天内处于活动状态的设备。

以下字段通过连接器引入:

类别 Properties
Devices -操作系统
- osVersion
- osServicePack
- cpuType
-类别
- assetTag
-虚拟
- serviceNowCriticality
- usedFor
- networkAdapters (在下面查看详细信息)
- lastLoggedOnUser
- mostFrequentUser
- sysClassName
- uPrimaryBusinessApplication (在下面查看详细信息)
网络适配器 -名字
- sysId
- macAddress
- ipAddress
- ipDefaultGateway
业务应用程序 - sysId
-数
- uCriticality
- businessCriticality

连接器疑难解答

下面是配置 ServiceNow 连接器时可能出现的一些常见问题,以及如何解决这些问题的建议。

错误类型 故障排除操作
“无法解析远程服务器名称”错误消息 验证 ServiceNow 实例主机名。 在此处详细了解对 ServiceNow 的 身份验证:身份验证 (servicenow.com)
错误代码 401:授权失败 授权失败表示凭据可能不正确,或者没有足够的权限来访问 ServiceNow 数据。 检查凭据,确保凭据正确且有效。 此外,检查凭据具有所需的权限。 有关如何确保分配cmdb_read角色的详细信息,请参阅 ServiceNow 配置部分 。 此失败的另一个可能原因是 ServiceNow 实例配置为仅接受来自有限 IP 地址范围的连接。 在这种情况下,请参阅此处将正确的 IP 集添加到允许列表的指南: 允许列表 IP 地址
错误代码 403: 访问禁止错误 此错误表示提供的凭据缺少运行请求的 API 所需的权限。 使用 配置部分中所述的适当权限更新凭据,并确保它们至少分配了cmdb_read角色。
错误代码 404: 找不到错误 此错误指示找不到可访问请求的终结点。 验证 ServiceNow 实例主机名是否正确。
错误代码 429 “请求过多” 系统定期从配置的外部提供程序拉取数据,这些提供程序对并发请求数可能有限制。 建议为连接器创建专用用户或帐户,以避免达到此限制。
错误 URL 错误消息 此错误指示找不到可访问请求的终结点。 验证 ServiceNow 实例主机名是否正确。
“临时断开连接”或“临时失败”错误 如果出现此错误消息时没有其他任何信息,请验证连接器配置 (主机名和凭据) 。 如果这些问题有效,并且问题无法自行解决,请联系支持人员。
在引入的数据中看不到某些 ServiceNow CMDB API 或资产 有关 ServiceNow CMDB 连接器预期检索的数据的说明,请参阅 检索 的数据。 如果仍然缺少数据,请联系支持人员。
看不到从 ServiceNow CMDB 引入的任何数据 查看连接状态,确保没有错误。 验证 ServiceNow CMDB 中是否存在与我们正在检索的数据对应的有效条目。 运行示例高级搜寻查询,以检查是否可以在公开关系图表中找到任何 ServiceNow 资产。如果仍找不到 ServiceNow CMDB 数据,请联系支持人员。
需要将 ServiceNow 允许的 IP 配置为启用公开管理连接器才能访问 ServiceNow 在此处阅读如何将要添加到允许列表的 IP 集: 允许列表 IP 地址

后续步骤

从数据连接器获取价值