> For the complete documentation index, see [llms.txt](https://docs.dispel.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dispel.com/documentation/documentation-zh/ji-cheng-yu-guan-li/integrations/asset-discovery/claroty-xdome.md).

# 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 就能查看设备的已知问题。

{% hint style="info" %}
**在哪里找到它。** 以组织管理员身份登录并打开 [**设置 → 集成**](https://app.dispel.com/settings/integrations)。Claroty xDome 显示在 **资产发现 / 网络可视性** 部分。点击 **连接** Claroty xDome 卡片上开始。
{% endhint %}

## 开始前准备

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

* 一个 **API 令牌**。在 xDome 中，前往 **设置 → 管理员设置 → 用户管理**，创建一个 API 用户，然后为其生成一个令牌。
* 你所在区域特定的 **xDome API 主机** ——例如 `https://api.claroty.com` 或 `https://eu.api.claroty.com`.

{% hint style="warning" %}
**API 令牌只会显示一次。** xDome 只会在你生成令牌时显示该令牌。请当场复制；如果丢失了，请重新生成一个。
{% endhint %}

{% hint style="info" %}
**令牌的权限决定了 Dispel 能看到什么。** Dispel 会导入 API 用户被授权读取的资产，因此请赋予该 API 用户对你希望在 Dispel 中显示的站点的访问权限。
{% endhint %}

## 连接 Claroty xDome

1. 前往 [**设置 → 集成**](https://app.dispel.com/settings/integrations) 并点击 **连接** 在 Claroty xDome 卡片上。
2. 可选地设置一个 **显示名称** 用于将此集成与其他集成区分开来（你可以连接多个实例）。
3. 填写连接字段：

| 字段          | 类型 | 备注                                                                                 |
| ----------- | -- | ---------------------------------------------------------------------------------- |
| **API URL** | 配置 | 你所在区域特定的 xDome API 主机，例如 `https://api.claroty.com` 或 `https://eu.api.claroty.com`. |
| **API 令牌**  | 凭据 | 在 xDome 中为 API 用户生成的令牌。已加密存储，且之后不会再次显示。                                            |
| **包含已退役设备** | 配置 | 可选。开启后，Dispel 还会导入 xDome 标记为已退役的设备。默认关闭。                                           |

4. 点击 **测试连接** 以确认 Dispel 能够通过身份验证。保存前请修复任何报告的错误。
5. 点击 **保存**。Dispel 会保存该集成并立即运行初始同步。

{% hint style="info" %}
**你的凭据已加密。** API 令牌在静态存储时会被加密，并且在你保存后不会再次显示。之后编辑时，请将令牌字段留空以保留当前存储的值。
{% endhint %}

## 将租户映射到 Wicket

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

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

1. 选择一个 **设施**.
2. 选择一个 **wicket**。如果该设施只有一个 Wicket，Dispel 会自动为你选中它。
3. 点击 **保存映射并导入**.

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

## 保持你的资产清单最新

* Dispel 会按设定的周期自动重新同步，因此新发现的设备、变更的详细信息和新的发现会自动获取，无需你进行任何操作。
* 如需立即拉取最新资产清单，请打开该集成并选择 **刷新**.
* 要更改连接详情或轮换令牌，请编辑该集成并使用 **保存并同步**。将令牌字段留空以保留当前令牌。

漏洞发现会在每次同步时刷新，而 xDome 不再报告的发现会自动移除。

## 连接状态

每个集成都会显示一个状态，让你始终知道当前进展：

| 状态        | 含义                   |
| --------- | -------------------- |
| **未初始化**  | 已保存，但首次同步尚未运行。       |
| **初始化中**  | 正在运行首次同步。            |
| **就绪**    | 已连接并同步；映射已应用。        |
| **需要刷新**  | 有新的供应商数据可用；运行刷新以拉取它。 |
| **刷新中**   | 同步正在进行中。             |
| **待处理更改** | 映射更改已保存，但尚未应用。       |
| **应用中**   | 正在按你保存的映射导入设备。       |
| **失败**    | 上一次操作失败——请参见错误提示。    |

单独的 **健康状态徽章** （已连接、降级、不可达）表示 Dispel 当前是否能够访问 xDome API。

## 故障排除

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

| 错误         | 通常表示什么以及如何修复                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------ |
| **身份验证失败** | API 令牌被拒绝。请确认 xDome 中的 API 用户处于活动状态，并且令牌是最新的——它只会显示一次，因此如果丢失了，请重新生成一个。                                       |
| **端点不可达**  | Dispel 无法连接到 xDome。请验证 API URL 是否为正确的、与区域对应的主机（例如 `https://api.claroty.com` 或 `https://eu.api.claroty.com`). |
| **连接超时**   | xDome 响应时间过长——通常是暂时性的网络问题；请重试。                                                                               |

## 常见问题

<details>

<summary>我在哪里创建 API 令牌？</summary>

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

</details>

<details>

<summary>我应该使用哪个 API URL？</summary>

你所在区域特定的 xDome API 主机，例如 `https://api.claroty.com` 或 `https://eu.api.claroty.com`。请使用与你的 xDome 租户所在区域相对应的主机。

</details>

<details>

<summary>Claroty xDome 会将哪些发现带入 Dispel？</summary>

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

</details>

<details>

<summary>Dispel 会在 xDome 中更改任何内容吗？</summary>

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

</details>

<details>

<summary>我可以连接多个 xDome 租户吗？</summary>

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

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.dispel.com/documentation/documentation-zh/ji-cheng-yu-guan-li/integrations/asset-discovery/claroty-xdome.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.