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

# Armis

连接您的 Armis 租户，将发现的受管和未受管资产拉取到 Dispel 中，把 Armis 站点映射到 Wicket，并使设备数据和漏洞发现保持同步。

## 概览

Armis 集成使 Dispel 能够拉取 Armis 在您的环境中发现的资产——无论是受管还是未受管——并将它们作为 Dispel 设备导入。您只需一次连接到 Armis 租户，将每个 Armis 站点映射到一个 Dispel 设施和 Wicket，Dispel 就会导入匹配的设备，并在定期同步中保持其更新。

Armis 是云原生的 **资产发现** 集成。没有本地部署的设备——Dispel 连接到云中的 Armis 租户，并且只会从中读取。

#### Dispel 导入的内容

* 发现的资产（名称、IP 地址、MAC 地址、制造商/型号、操作系统、设备类型）作为 Dispel 设备。
* 每个资产所观察到的网络协议和端口。
* 返回到 Armis 中该资产的链接，存储在设备上。
* **漏洞发现** 适用于每个导入的设备，并在每次同步时刷新。

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

## 开始。

您需要从 Armis 租户中获取以下内容：

* 一个 **API 密钥** （密钥），在 Armis 控制台的 API 设置下创建。
* 您的 **Armis 租户 URL** — 例如 `https://acme.armis.com`.

{% hint style="warning" %}
**将 Dispel 的 IP 加入允许列表。** 当您打开连接表单时，Dispel 会显示一个 **白名单 IP** 值。如果您的 Armis 租户按源 IP 限制 API 访问，请将此地址加入允许列表，以便 Dispel 可以连接。
{% endhint %}

## 连接 Armis

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

| 字段               | 类型 | 备注                                               |
| ---------------- | -- | ------------------------------------------------ |
| **Armis 租户 URL** | 配置 | 您的 Armis 租户的基础 URL（例如 `https://acme.armis.com`). |
| **API 密钥**       | 凭据 | 您的 Armis API（密钥）密钥。以加密方式存储，且不会再次显示。              |

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

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

## 将站点映射到 Wicket

初始同步完成后，打开该集成以找到 **站点映射** 部分。Armis 会显示您租户中配置的站点，而您可以在此决定哪些站点会成为 Dispel 设备以及它们将落到哪里。

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

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

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

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

## 保持清单最新

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

## 漏洞发现

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

## 连接状态

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

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

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

## 故障排除

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

| 错误         | 通常表示什么以及如何修复                                                       |
| ---------- | ------------------------------------------------------------------ |
| **身份验证失败** | API 密钥被拒绝。该密钥可能已轮换、过期或被吊销——请生成新密钥并更新该集成。                           |
| **端点不可达**  | Dispel 无法访问 API。请验证租户 URL，如果您的租户限制 API 访问，请确认 Dispel 的 IP 已加入允许列表。 |
| **连接超时**   | Armis 响应时间过长——通常是暂时性的网络延迟。                                         |
| **受速率限制**  | Armis 对请求进行了限流。下一次计划同步应会成功。                                        |
| **配置错误**   | 租户 URL 看起来不正确。请重新检查它是否指向您的 Armis 租户。                               |

## 常见问题

<details>

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

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

</details>

<details>

<summary>Armis 有本地部署选项吗？</summary>

没有。Armis 是一个云平台，因此 Dispel 始终通过互联网连接到您的 Armis 租户。没有可供指向的设备。

</details>

<details>

<summary>连接 Armis 会改变我在 Armis 租户中的任何内容吗？</summary>

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

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