> 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/dragos.md).

# Dragos

连接 Dragos Platform（SiteStore），将发现的 OT 资产拉取到 Dispel 中，把 Dragos 传感器映射到 Wicket，并使设备数据和漏洞发现保持同步。

## 概览

Dragos 集成可让 Dispel 拉取 Dragos 平台已发现的 OT 资产，并将它们作为 Dispel 设备导入。你连接到你的 Dragos **SiteStore** 一次性将每个 Dragos 传感器映射到一个 Dispel 设施和 Wicket，随后 Dispel 会导入匹配的设备，并在定期同步中保持其最新。

Dragos 是一个 **资产发现** 集成。Dispel 只从 Dragos 读取数据——从不向平台写回。

在 Dragos 中， **传感器** 是监控你的工业网络的采集点。Dispel 将每个 Dragos 传感器视为一个 **站点** ，你将其映射到一个 Dispel Wicket，这样资产就会按传感器落到正确的位置。

#### Dispel 导入的内容

* 发现的资产（名称、IP 地址、MAC 地址、制造商/型号、操作系统、设备类型）作为 Dispel 设备。
* 每个资产所观察到的网络协议和端口。
* 指向 Dragos 中该资产的链接，存储在设备上。
* **漏洞发现** 针对每个导入的设备——涵盖硬件/固件和软件/操作系统问题——在每次同步时刷新。

{% hint style="info" %}
**在哪里找到它。** 以组织管理员身份登录并打开 **设置 → 集成**。Dragos 会出现在 **资产发现 / 网络可见性** 部分中。点击 **连接** Dragos 卡片上开始。
{% endhint %}

## 开始。

你需要从你的 Dragos SiteStore 获取以下信息：

* 一个 **API 密钥** —— 它的 **API Key ID** （标识符）以及 **API Key Secret**。在 SiteStore 中进行配置。
* 该 **SiteStore URL** 你的部署实例的——例如 `https://customer.dragos.cloud`.

{% hint style="warning" %}
**API Key Secret 仅显示一次。** 当你配置密钥时，Dragos 只会显示一次该机密。请当时复制下来——如果丢失了，就重新配置一个新密钥。还要将 Dispel 的 **白名单 IP** （在连接表单中显示）添加到你的防火墙允许列表中，这样 Dispel 就能访问 SiteStore，尤其是在本地部署时。
{% endhint %}

## 连接 Dragos

1. 前往 **设置 → 集成** 并点击 **连接** 在 Dragos 卡片上。
2. 可选地设置一个 **显示名称** 用于将此集成与其他集成区分开来（你可以连接多个 SiteStore）。
3. 填写连接字段：

| 字段                 | 类型 | 备注                                 |
| ------------------ | -- | ---------------------------------- |
| **SiteStore URL**  | 配置 | 你的 Dragos SiteStore 实例的基础 URL。     |
| **API Key ID**     | 凭据 | 来自你的 Dragos SiteStore 的 API 密钥标识符。 |
| **API Key Secret** | 凭据 | 与该密钥关联的机密。以加密方式存储，且之后绝不会再次显示。      |

4. 点击 **测试连接** 以确认 Dispel 能够对 SiteStore 进行身份验证。请在保存前修复任何报告的错误。
5. 点击 **保存**。Dispel 会保存该集成，并立即运行初始同步以发现你的传感器。

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

## 将传感器映射到 Wickets

初始同步完成后，打开该集成以找到 **站点映射** 部分。每个 Dragos 传感器都会显示为一个站点，你可以在这里决定哪些传感器会成为 Dispel 设备，以及它们的落点。

> 将每个厂商站点映射到一个 Dispel 设施和 wicket。来自已映射站点的设备将同步到 Dispel。

对于你想导入的每个传感器：

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

Dispel 会逐个处理每个已映射的传感器——你会看到每个站点的进度从等待、获取、同步到完成——然后报告导入了多少设备（例如， **“已导入 12 台设备”** 或新设备与已导入设备的明细）。导入的设备会与您手动添加的任何设备一起显示在已映射的 Wicket 中。

## 保持清单最新

* Dispel **会自动重新同步** 按周期计划运行，因此新发现的资产和变更的详细信息会自动被拾取，无需您进行任何操作。
* 若要立即拉取最新清单，请打开该集成并选择 **刷新**.
* 若要更改连接详情或轮换凭据，请编辑该集成并使用 **保存并同步**。将凭据字段留空可保留当前密文。

## 漏洞发现

Dragos 会报告其监控资产的已知漏洞。每次成功同步后，Dispel 会拉取你已导入设备的漏洞发现——涵盖硬件/固件和软件/操作系统问题——并将它们附加到这些设备上，这样你无需离开 Dispel 就能查看设备的已知问题。发现结果会在每次同步时刷新，已解决的发现会自动移除。

## 连接状态

每个集成都显示一个状态，因此您始终知道其当前情况：

| 状态        | 含义                  |
| --------- | ------------------- |
| **未初始化**  | 已保存，但尚未运行首次同步。      |
| **初始化中**  | 正在运行首次同步并发现传感器。     |
| **就绪**    | 已连接并同步；映射已应用。       |
| **需要刷新**  | 有新的厂商数据可用；运行刷新以拉取它。 |
| **刷新中**   | 同步正在进行中。            |
| **待处理更改** | 映射更改已保存，但尚未应用。      |
| **应用中**   | 正在导入您已保存映射对应的设备。    |
| **失败**    | 上一次操作失败——请查看错误说明。   |

单独的 **健康徽标** （已连接、性能下降、无法访问）反映了 Dispel 当前是否能够访问 Dragos API。

## 故障排除

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

| 错误         | 通常表示什么以及如何修复                                                         |
| ---------- | -------------------------------------------------------------------- |
| **身份验证失败** | API Key ID/Secret 被拒绝。该密钥可能已轮换、过期或被撤销——请重新配置一个新的，并更新该集成。             |
| **端点不可达**  | Dispel 无法访问 SiteStore。请验证 SiteStore URL，并确认防火墙已将 Dispel 的 IP 加入允许列表。 |
| **连接超时**   | SiteStore 响应时间过长——通常是网络延迟或防火墙规则导致。                                   |
| **受速率限制**  | Dragos 对请求进行了限流。下一次计划同步应会成功。                                         |
| **配置错误**   | SiteStore URL 看起来不正确。请重新检查连接设置。                                      |

## 常见问题

<details>

<summary>我可以连接多个 Dragos SiteStore 吗？</summary>

可以。Dragos 支持多个集成，因此你可以并排连接多个 SiteStore 实例。为每个实例指定一个不同的 **显示名称** 以便区分它们。

</details>

<details>

<summary>Dragos 中的“site”是什么？</summary>

Dispel 将 Dragos **传感器** 映射到站点。监控你的网络的每个传感器都会出现在站点映射列表中，因此你可以将来自不同传感器的资产路由到不同的设施和 Wickets。

</details>

<details>

<summary>我丢失了 API Key Secret。该怎么办？</summary>

Dragos 只会在配置时显示一次该机密。如果你不再拥有它，请在 SiteStore 中配置一个新的 API 密钥，并用新的 ID 和机密更新该集成。

</details>

<details>

<summary>连接 Dragos 会改变 SiteStore 中的任何内容吗？</summary>

不会。Dispel 只从 Dragos 读取数据。它从不在 Dragos 端创建、修改或删除数据。

</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/dragos.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.