For the complete documentation index, see llms.txt. This page is also available as Markdown.

Claroty xDome

通过其云 API 连接 Claroty xDome,将已发现的 OT、IoT 和 IIoT 设备拉入 Dispel——补充漏洞发现——映射到一个 Wicket。

概述

Claroty xDome 集成让 Dispel 提取 xDome 已发现的 OT、IoT 和 IIoT 资产,并将它们作为 Dispel 设备导入,同时附带 xDome 的漏洞发现结果。你只需一次连接 xDome 租户,将其映射到一个 Dispel 设施和一个 Wicket,Dispel 就会导入匹配的设备,并在后续的定期同步中保持其最新状态。

Claroty xDome 是一种云资产发现集成。Dispel 使用 API 令牌通过 xDome API 进行身份验证,并且只读取其中的数据。由于 xDome 租户代表单一环境,Dispel 会将其视为一个站点,并将其映射到单个 Wicket——无需逐个处理站点列表。

Dispel 导入的内容

  • xDome 已发现的设备,会与你现有的 Dispel 设备匹配;没有匹配项的则作为新设备导入。

  • xDome 的漏洞发现结果(基于 CVE,带有 CVSS v3 分数)会作为发现项附加到匹配的设备上,因此你无需离开 Dispel 就能查看设备已知的问题。

在哪里找到它。 以组织管理员身份登录并打开 设置 → 集成。Claroty xDome 显示在 资产发现 / 网络可见性 部分中。点击 连接 点击 Claroty xDome 卡片开始。

开始之前

你需要从 xDome 获取以下内容:

  • 一个 API 令牌。在 xDome 中,前往 设置 → 管理设置 → 用户管理,创建一个 API 用户,然后为其生成令牌。

  • 你的区域专属 xDome API 主机 ——例如 https://api.claroty.com 或 https://eu.api.claroty.com.

令牌的权限范围决定了 Dispel 能看到什么。 Dispel 会导入 API 用户被允许读取的资产,因此请为 API 用户授予你希望在 Dispel 中看到其设备的站点访问权限。

连接 Claroty xDome

  1. 前往 设置 → 集成 并点击 连接 在 Claroty xDome 卡片上。

  2. 可选地设置一个 显示名称 以便将此集成与其他集成区分开来(你可以连接多个实例)。

  3. 填写连接字段:

字段
类型
说明

API URL

配置

你的区域专属 xDome API 主机,例如 https://api.claroty.com 或 https://eu.api.claroty.com.

API 令牌

凭据

在 xDome 中为 API 用户生成的令牌。它会被加密存储,之后不会再次显示。

包含已退役设备

配置

可选。开启后,Dispel 也会导入 xDome 标记为已退役的设备。默认关闭。

  1. 点击 测试连接 以确认 Dispel 可以进行身份验证。在保存之前修复任何报告的错误。

  2. 点击 保存。Dispel 会保存该集成并立即运行初始同步。

您的凭据已加密。 API 令牌在静态存储时会被加密,并且在你保存后不会再次显示。之后编辑时,请将令牌字段留空以保留当前存储值。

将租户映射到 Wicket

初始同步完成后,打开该集成以找到 站点映射 部分。Claroty xDome 显示为代表你的租户的单个站点。

将每个供应商站点映射到一个 Dispel 设施和一个 Wicket。来自已映射站点的设备将同步到 Dispel 中。

  1. 选择一个 设施.

  2. 选择一个 Wicket。如果该设施只有一个 Wicket,Dispel 会为您自动选择。

  3. 点击 保存映射并导入.

Dispel 会将 xDome 的设备导入到映射的 Wicket 中,然后报告已导入的设备数量。导入的设备会与您手动添加的设备一起显示在映射的 Wicket 中,并附带其 xDome 漏洞发现结果。

保持库存最新

  • Dispel 会按固定周期自动重新同步,因此新发现的设备、变更的详情和新的发现结果都会在无需你进行任何操作的情况下被拾取。

  • 若要立即拉取最新库存,请打开该集成并选择 刷新.

  • 要更改连接详情或轮换令牌,请编辑集成并使用 保存并同步。将令牌字段留空以保留当前令牌。

漏洞发现结果会在每次同步时刷新,而 xDome 不再报告的发现项会自动消失。

连接状态

每个集成都会显示一个状态,因此您始终知道它所处的阶段:

状态
含义

未初始化

已保存,但首次同步尚未运行。

初始化中

正在运行首次同步。

就绪

已连接并同步;映射已应用。

需要刷新

有新的供应商数据可用;请运行刷新以拉取数据。

刷新中

同步正在进行中。

待处理更改

映射更改已保存但尚未应用。

应用中

正在为您已保存的映射导入设备。

失败

上一次操作失败——请查看错误说明。

单独的 健康徽章 (已连接、性能下降、无法访问)表示 Dispel 当前是否能够访问 xDome API。

故障排查

如果同步或测试连接失败,Dispel 会对错误进行分类并建议修复方法:

错误
通常表示什么以及如何修复

身份验证失败

API 令牌被拒绝。请确认 API 用户在 xDome 中处于活动状态,并且令牌仍然有效——它只会显示一次,因此如果丢失了就生成一个新的。

端点不可达

Dispel 无法连接到 xDome。请验证 API URL 是否为你正确的区域专属主机(例如 https://api.claroty.com 或 https://eu.api.claroty.com).

连接超时

xDome 响应超时——通常是暂时性的网络问题;请重试。

常见问题

我在哪里创建 API 令牌?

在 xDome 中,前往 设置 → 管理设置 → 用户管理,创建一个 API 用户,并为其生成令牌。令牌只会显示一次,因此在离开页面前请先复制保存。

我应该使用哪个 API URL?

你的区域专属 xDome API 主机,例如 https://api.claroty.com 或 https://eu.api.claroty.com。请使用你 xDome 租户所在区域的主机。

Claroty xDome 会将哪些发现结果带入 Dispel?

xDome 的漏洞发现结果——基于 CVE,并带有 CVSS v3 分数——会附加到匹配的设备上。发现结果会在每次同步时刷新,而 xDome 不再报告的任何内容会自动消失。

Dispel 会更改 xDome 中的任何内容吗?

不会。该集成是只读的。Dispel 会拉取库存和发现结果,但绝不会在 xDome 中创建、修改或删除数据。

我可以连接多个 xDome 租户吗?

可以。Claroty xDome 支持多个集成,因此你可以并排连接多个租户。为每个租户分配一个不同的 显示名称 ,以便区分它们。

最后更新于

这有帮助吗?