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

# Forescout

通过 Forescout eyeControl 在您的 Enterprise Manager 设备上的 Web API 将其连接起来，把发现的主机作为设备拉取到 Dispel 中——映射到某个 Wicket，并通过周期性同步刷新。

## 概览

Forescout 集成可让 Dispel 拉取 Forescout 在您的网络中发现的主机，并将它们作为 Dispel 设备导入。您只需一次连接到 Forescout 设备，将其映射到一个 Dispel 设施和 Wicket，然后 Dispel 会导入匹配的设备，并在后续的定期同步中保持其最新状态。

Forescout 是一个本地部署的 **资产发现** 集成。具体来说，Dispel 与 **Forescout eyeControl** 通过其 Web API（即 **eyeExtend Connect** 模块）进行集成，并且只会从中读取。您将 Dispel 指向您的 **Enterprise Manager** —— Forescout 的中央管理设备，它会汇总您网络中的各个 Forescout 设备。您自行部署并运行 Enterprise Manager（作为物理或虚拟设备），因此它不是 Forescout 托管的云服务——Dispel 通过您自身环境中的地址访问它，这就是为什么连接通常会使用私有 URL 和自签名证书选项。

由于 Enterprise Manager 代表单一环境，Dispel 将其视为一个 **站点** ，您将其映射到单个 Wicket——无需逐个处理站点列表。

{% hint style="info" %}
**关于 Forescout 名称的说明。** “eyeControl” 是 Dispel 连接的 Forescout 产品；“Enterprise Manager” 是您将 Dispel 指向的管理设备。连接字段标记为 **Enterprise Manager URL** 以与 Forescout 控制台中的措辞一致。
{% endhint %}

#### Dispel 导入的内容

* 发现的主机（名称、IP 地址、MAC 地址、制造商/型号、操作系统、设备类型）作为 Dispel 设备。
* 每台主机观测到的网络协议和端口。
* 回链到 Forescout 中该主机的链接，存储在设备上。

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

## 开始。

您需要从 Forescout 控制台获取以下内容：

* 一个 **Web API 用户** —— 在以下位置创建一个： **工具 → 选项 → Web API → 用户设置**。Dispel 使用此用户的 **用户名** 和 **密码**.
* 该 **Enterprise Manager URL** 您设备的——例如 `https://192.168.1.100`.
* 如果您的设备使用 **自签名 TLS 证书**，请准备在设置过程中启用自签名选项。

{% hint style="warning" %}
**将 Dispel 的 IP 加入允许列表。** 当您打开连接表单时，Dispel 会显示一个 **白名单 IP** 值。将此地址添加到网络防火墙允许列表中，以便 Dispel 能够访问本地设备。
{% endhint %}

## 连接 Forescout

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

| 字段                         | 类型 | 备注                                       |
| -------------------------- | -- | ---------------------------------------- |
| **Enterprise Manager URL** | 配置 | 您的 Forescout Enterprise Manager 设备的 URL。 |
| **允许自签名证书**                | 配置 | 如果您的设备使用自签名 TLS 证书，请开启此项。                |
| **用户名**                    | 凭据 | 在 Forescout 控制台中创建的 Web API 用户。          |
| **密码**                     | 凭据 | Web API 用户的密码。以加密方式存储，之后不再显示。            |

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

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

## 将设备映射到 Wicket

初始同步完成后，打开该集成以找到 **站点映射** 部分。Forescout 会显示为代表您设备的单个站点。

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

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

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

## 保持清单最新

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

## 连接状态

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

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

单独的 **健康徽标** （已连接、降级、不可达）反映 Dispel 当前是否能够访问 Forescout 设备。

## 故障排除

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

| 错误         | 通常表示什么以及如何修复                                                             |
| ---------- | ------------------------------------------------------------------------ |
| **身份验证失败** | Web API 用户名或密码被拒绝。确认 Web API 用户存在且密码是最新的。                                |
| **端点不可达**  | Dispel 无法访问该设备。请验证 Enterprise Manager URL，并确认您的防火墙已将 Dispel 的 IP 加入允许列表。 |
| **证书错误**   | 该设备提供了不受信任的 TLS 证书。如果它使用自签名证书，请启用 **允许自签名证书** 在连接设置中。                    |
| **连接超时**   | 该设备响应时间过长——通常是 Dispel 与您的网络之间的网络延迟或防火墙规则导致。                              |
| **配置错误**   | URL 看起来不正确，或者该设备未启用 Web API。请重新检查连接设置。                                   |

## 常见问题

<details>

<summary>这是 eyeControl、eyeSight 还是 eyeExtend？</summary>

Forescout 平台由 “eye” 品牌下的多个模块组成——eyeSight（可见性）、eyeControl（策略与控制）、eyeExtend（第三方集成）等。Dispel 连接到 **eyeControl** 通过其 **eyeExtend Connect** Web API。您通过将 Dispel 指向您的 **Enterprise Manager** 设备来进行配置，这就是连接字段被称为 **Enterprise Manager URL**.

</details>

<details>

<summary>我可以连接多个 Forescout 设备吗？</summary>

可以。Forescout 支持多个集成，因此您可以并排连接多个设备。请为每个设备设置不同的 **显示名称** 以便区分它们。

</details>

<details>

<summary>为什么 Forescout 只显示一个站点？</summary>

一个 Forescout 设备代表单一环境，因此 Dispel 将其建模为一个站点映射到一个 Wicket——而不是需要逐个映射的站点列表。

</details>

<details>

<summary>我的设备使用自签名证书。连接会失败吗？</summary>

不会，只要您启用 **允许自签名证书** 在连接设置中。若您的设备提供来自受信任机构的证书，则保持关闭。

</details>

<details>

<summary>连接 Forescout 会改变我设备上的任何内容吗？</summary>

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

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