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

# Nozomi Networks

连接 Nozomi Networks（Vantage 或 Guardian），将您的 OT 和 IoT 资产清单拉取到 Dispel 中，把供应商站点映射到 Wicket，并使设备数据和漏洞发现保持同步。

## 概览

Nozomi Networks 集成让 Dispel 能拉取 Nozomi 在你的网络中发现的 OT 和 IoT 资产清单，并将这些资产作为 Dispel 设备导入。你只需连接一次，把每个 Nozomi 站点映射到一个 Dispel 设施和 Wicket，Dispel 就会导入匹配的设备，并在周期性同步中保持其更新。

Nozomi 是一个 **资产发现** 集成。Dispel 仅读取 Nozomi 中的数据——不会向你的 Nozomi 控制台回写。

一个集成即可支持两种 Nozomi 部署类型，在连接时选择：

* **Vantage** —— Nozomi 的云平台，支持对所有站点进行集中风险管理。
* **Guardian** —— 本地部署的 Nozomi 设备，为单一环境提供全面的资产清单和网络可视性。

#### Dispel 导入的内容

* 检测到的资产（名称、IP 地址、MAC 地址、品牌/型号、操作系统、固件）会作为 Dispel 设备导入。
* 每个资产所观察到的网络协议和端口。
* 指向你 Nozomi 控制台中该资产的链接，以及 Nozomi 的风险评分，存储在设备上。
* **漏洞发现** 适用于每个导入的设备，并在每次同步时刷新。

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

## 开始。

你需要从 Nozomi 控制台获取以下内容：

* 一个 **API 密钥** —— 它的 **密钥名称** （标识符）以及 **密钥令牌** （密文）。请在你的 Nozomi 控制台中生成。
* 该 **API URL** ，取决于你的部署：
  * 对于 Vantage，填写你的租户 URL——例如 `https://customer.vantage.nozominetworks.io`.
  * 对于 Guardian，填写你的设备 URL。

{% hint style="warning" %}
**将 Dispel 的 IP 加入允许列表。** 当您打开连接表单时，Dispel 会显示一个 **白名单 IP** 值。将此地址添加到你的 Nozomi（或网络防火墙）允许列表中，以便 Dispel 可以访问 API——这对于本地部署的 Guardian 设备尤其重要。
{% endhint %}

## 连接 Nozomi

1. 前往 **设置 → 集成** 并点击 **连接** 在 Nozomi 卡片上。
2. 可选地设置一个 **显示名称** 以便将此集成与其他集成区分开来（你可以连接多个 Nozomi）。
3. 选择 **Nozomi API 类型** — **Vantage API** 或 **Guardian API**.
4. 填写连接字段：

| 字段          | 类型 | 备注                                   |
| ----------- | -- | ------------------------------------ |
| **API URL** | 配置 | 你的 Vantage 租户 URL 或 Guardian 设备 URL。 |
| **密钥名称**    | 凭据 | 来自 Nozomi 控制台的 API 密钥标识符。            |
| **密钥令牌**    | 凭据 | 密文 API 密钥令牌。以加密形式存储，且之后不会再次显示。       |

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

{% hint style="info" %}
**您的凭据已加密。** 密钥令牌（以及任何其他机密）在静态存储时会被加密，保存后不会再次显示。之后编辑时，请将凭据字段留空以保留已存储的值。
{% endhint %}

## 将站点映射到 Wicket

初始同步完成后，打开该集成以找到 **站点映射** 部分。这是你决定哪些 Nozomi 站点成为 Dispel 设备以及它们放置位置的地方。

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

对于您要导入的每个站点：

1. 选择一个 **设施**.
2. 选择一个 **Wicket**。如果该设施只有一个 Wicket，Dispel 会为您自动选择。
3. *（可选）* 将导入限制为特定的 **区域**。Nozomi 会使用原生区域为资产添加标签；使用区域选择器仅导入你选择的区域中的资产。留空则导入该站点的所有资产。
4. 点击 **保存映射并导入**.

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

## 保持清单最新

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

## 漏洞发现

Nozomi 会报告其监控资产的已知漏洞。每次成功同步后，Dispel 会拉取你已导入设备的漏洞发现并将其附加到这些设备上，因此你无需离开 Dispel 就能看到设备的已知问题。发现结果会在每次同步时刷新，已解决的发现会自动消失。

## 连接状态

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

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

单独的 **健康徽标** （已连接、性能降级、无法访问）表示 Dispel 当前是否能够访问 Nozomi API。

## 故障排除

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

| 错误         | 通常表示什么以及如何修复                                                        |
| ---------- | ------------------------------------------------------------------- |
| **身份验证失败** | 密钥名称/令牌被拒绝。该密钥可能已轮换、过期或被撤销——请生成新的密钥并更新集成。                           |
| **端点不可达**  | Dispel 无法访问 API。请检查 API URL，并确认 Dispel 的 IP 已在防火墙中加入允许列表。           |
| **连接超时**   | 该设备响应时间过长——通常是网络延迟或防火墙规则所致。本地 Guardian 上较常见。                        |
| **受速率限制**  | Nozomi 限制了请求频率。下一次计划同步应会成功。                                         |
| **配置错误**   | API URL 或 API 类型看起来不对（例如选择了 Vantage 类型却填写了 Guardian URL）。请重新检查连接设置。 |

## 常见问题

<details>

<summary>我可以连接多个 Nozomi 部署吗？</summary>

可以。Nozomi 支持多个集成，因此你可以并排连接多个 Guardian 设备和/或一个 Vantage 租户。为每个连接指定一个不同的 **显示名称** 以便区分它们。

</details>

<details>

<summary>连接 Nozomi 会改变我 Nozomi 控制台中的任何内容吗？</summary>

不会。Dispel 只会读取 Nozomi 中的数据。它绝不会在 Nozomi 端创建、修改或删除任何数据。

</details>

<details>

<summary>如果我移除站点映射，已导入的设备会怎样？</summary>

不再受任何有效映射覆盖的设备，会在后续同步中停止更新。移除映射只会影响未来的同步——不会追溯删除历史记录。

</details>

<details>

<summary>为什么我看不到“区域”选项？</summary>

区域筛选是 Nozomi 特有的。只有那些资产带有 Nozomi 区域标签的站点才会显示“区域”选择器。如果某个站点没有区域，则会导入其全部资产。

</details>

<details>

<summary>新资产多久会出现？</summary>

新资产会在下一次同步时出现——会按定期计划自动出现，或者如果您选择 **刷新**.

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