所有页面
由 GitBook 提供支持
1 / 1

Loading...

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.

  1. 前往 ,然后点击 Claroty xDome 卡片上的 连接 。

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

  3. 填写连接字段:

字段
类型
备注
  1. 点击 测试连接 以确认 Dispel 能够通过身份验证。保存前请先解决报告的任何错误。

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

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

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

  1. 选择一个 设施.

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

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

Dispel 会将 xDome 的设备导入映射的 Wicket,并显示导入的设备数量。导入的设备会与手动添加的设备一同显示在映射的 Wicket 中,并附带相应的 xDome 漏洞发现信息。

  • Dispel 会按计划自动定期重新同步,因此新发现的设备、已更改的信息和新的发现项都会自动更新,无需你采取任何操作。

  • 要立即获取最新清单,请打开集成并选择 刷新.

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

每次同步时都会刷新漏洞发现结果;xDome 不再报告的发现结果会自动移除。

每个集成都显示一个状态,方便您随时了解其运行情况:

状态
含义

单独的 健康状态徽标 (已连接、性能下降、无法访问)反映 Dispel 当前能否访问 xDome API。

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

错误
通常含义及解决方法

API URL

配置

与你所在区域对应的 xDome API 主机,例如 https://api.claroty.com 或 https://eu.api.claroty.com.

API 令牌

凭据

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

包含已退役设备

配置

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

未初始化

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

正在初始化

正在运行首次同步。

就绪

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

需要刷新

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

正在刷新

正在进行同步。

身份验证失败

API 令牌已被拒绝。请确认 xDome 中的 API 用户处于启用状态,且令牌仍然有效——令牌只会显示一次;如果已丢失,请生成新令牌。

无法访问端点

Dispel 无法访问 xDome。请确认 API URL 使用了正确的区域专属主机(例如 https://api.claroty.com 或 https://eu.api.claroty.com).

连接超时

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

设置 → 集成
设置 → 集成

API 令牌只会显示一次。 xDome 只会在生成令牌时显示它。请立即复制;如果丢失,请重新生成一个。

令牌的权限范围决定了 Dispel 能看到哪些内容。 Dispel 会导入 API 用户获准读取的资产,因此请授予该 API 用户对相应站点的访问权限,以便将这些站点的设备导入 Dispel。

连接 Claroty xDome

你的凭据会经过加密。 API 令牌会以加密形式静态存储,保存后不会再次显示。之后编辑时,将令牌字段留空即可保留已存储的值。

将租户映射到 Wicket

保持资产清单最新

连接状态

故障排除

常见问题

在哪里创建 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 支持多个集成,因此您可以并行连接多个租户。为每个租户设置不同的 显示名称 以便区分。

有待处理的更改

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

正在应用

正在根据已保存的映射导入设备。

失败

上次操作失败——请参阅错误处理指南。