ServiceNow 数据连接器
若要设置 ServiceNow CMDB 集成,需要提供 ServiceNow 实例的主机名和有效凭据。 连接器使用用户名和密码对基本身份验证进行身份验证,以便进行只读访问。
注意
建议创建一个专用用户,以便在曝光管理中与数据连接器配合使用。
ServiceNow 配置
- 查找 ServiceNow 实例的主机名。 例如,“contoso.service-now.com”。
- 创建新的 ServiceNow 用户:
- 按照 此处 的步骤创建新用户。
- 请将 用户名 (用户 ID) 和密码 保留,以供将来使用。
- 如果没有密码字段,请提交表单以创建用户。 之后,选择新用户时,将收到 “设置密码” 选项。
- 创建用户时,检查“仅访问 Web 服务”框,以便用户将专用于此集成。
- 将 cmdb_read 角色分配给已创建的用户。 可 在此处找到详细说明。
注意
ServiceNow 连接器仅支持基本身份验证。 稍后将提供 OAuth 身份验证。
在公开管理中建立 ServiceNow 连接
若要在公开管理中与 ServiceNow 建立连接,请执行以下步骤:
- 从“公开管理”导航中打开 “数据连接器 ”,然后在“ServiceNow CMDB”磁贴中选择“ 连接 ”。
- 输入 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 地址 |