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

# TXOne

连接您的 TXOne StellarOne 控制台，将受保护的 OT 端点作为设备拉取到 Dispel 中，映射到某个 Wicket，并通过周期性同步刷新。

## 概述

TXOne 集成可让 Dispel 拉取由您的 TXOne **StellarOne** 控制台管理的 OT 终端，并将其作为 Dispel 设备导入。您只需连接 StellarOne 一次，将其映射到一个 Dispel 设施和 Wicket，Dispel 就会导入匹配的设备，并通过定期同步使其保持最新。

TXOne 是一种 **资产发现** 集成。Dispel 会连接到您的 StellarOne 管理控制台，并且只从中读取数据。

在 StellarOne 中， **代理** 是受管理的 StellarProtect 终端。Dispel 会将每个代理导入为一台设备，并报告其 IP、MAC、主机名、操作系统和已安装的 ICS 应用。由于一个 StellarOne 控制台代表一个独立环境，Dispel 会将该控制台视为一个 **站点** ，并将其映射到一个 Wicket。

#### Dispel 导入的内容

* 受管理的代理（主机名、IP 地址、MAC 地址、操作系统），作为 Dispel 设备。
* 每个代理检测到的网络协议和端口。
* 设备中保存的指向 StellarOne 中相应代理的链接。

{% hint style="info" %}
**查找位置。** 以组织管理员身份登录并打开 **Settings → Integrations**。TXOne 显示在 **Asset Discovery / Network Visibility** 部分。点击 TXOne 卡片上的 **连接** 即可开始。
{% endhint %}

## 开始之前

您需要从 TXOne StellarOne 控制台获取以下信息：

* 一个 **API 密钥**，在 StellarOne Management Console 中生成（具体步骤请参阅《StellarOne 管理员指南》）。
* 您的控制台 **StellarOne URL** ，例如 `https://stellar1.example.com`.
* 如果您的控制台使用 **自签名 TLS 证书**，请准备好在设置期间启用自签名选项。

{% hint style="warning" %}
**将 Dispel 的 IP 地址加入允许列表。** 打开连接表单时，Dispel 会显示一个 **允许列表 IP** 值。请将此地址添加到网络防火墙的允许列表中，以便 Dispel 连接到 StellarOne 控制台。
{% endhint %}

## 连接 TXOne

1. 前往 **Settings → Integrations** ，然后点击 TXOne 卡片上的 **连接** 。
2. 可选：设置 **显示名称** ，以便将此集成与其他集成区分开来（您可以连接多个控制台）。
3. 填写连接字段：

| 字段                 | 类型 | 备注                                          |
| ------------------ | -- | ------------------------------------------- |
| **StellarOne URL** | 配置 | TXOne StellarOne 管理控制台的 URL。                |
| **允许自签名证书**        | 配置 | 如果您的控制台使用自签名 TLS 证书，请开启此选项。                 |
| **API 密钥**         | 凭据 | 在 StellarOne 中生成的 API 密钥。该密钥经过加密存储，且不会再次显示。 |

4. 点击 **测试连接** ，确认 Dispel 可以通过身份验证连接到 StellarOne。保存前，请修复报告的所有错误。
5. 点击 **保存**。Dispel 会保存此集成并立即运行初始同步。

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

## 将控制台映射到 Wicket

初始同步完成后，打开集成即可找到 **站点映射** 部分。TXOne 会显示为一个站点，代表您的 StellarOne 控制台。

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

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

Dispel 会将控制台中的代理导入映射的 Wicket — 您会看到进度从等待、获取、同步到完成 — 然后报告已导入的设备数量（例如， **"已导入 12 台设备"** ，或列出新设备与已导入设备的数量）。导入的设备会与您手动添加的设备一同显示在映射的 Wicket 中。

## 保持资产清单最新

* Dispel **会自动重新同步** ，并按固定计划定期执行，因此新注册的代理和已更改的详细信息都会自动同步，无需您采取任何操作。
* 要立即获取最新清单，请打开集成并选择 **刷新**.
* 若要更改连接详细信息或轮换密钥，请编辑此集成并使用 **保存并同步**。凭据字段留空即可保留当前密钥。

## 连接状态

每个集成都显示一个状态，方便您随时了解其运行情况：

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

独立的 **运行状况徽章** （已连接、性能下降、无法访问）会显示 Dispel 当前是否能够连接到 StellarOne 控制台。

## 故障排除

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

| 错误         | 通常含义及解决方法                                                         |
| ---------- | ----------------------------------------------------------------- |
| **身份验证失败** | API 密钥遭到拒绝。请在 StellarOne 中生成新密钥并更新此集成。                            |
| **无法访问端点** | Dispel 无法连接到控制台。请检查 StellarOne URL，并确认防火墙已将 Dispel 的 IP 地址加入允许列表。 |
| **证书错误**   | 控制台提供了不受信任的 TLS 证书。如果使用的是自签名证书，请启用 **允许自签名证书** （位于连接设置中）。         |
| **连接超时**   | 控制台响应超时 — 通常是由于网络延迟，或 Dispel 与您的网络之间存在防火墙规则所致。                    |
| **配置错误**   | URL 似乎有误。请重新检查连接设置。                                               |

## 常见问题

<details>

<summary>我可以连接多个 StellarOne 控制台吗？</summary>

可以。TXOne 支持多个集成，因此您可以同时连接多个控制台。为每个控制台设置不同的 **显示名称** 以便区分。

</details>

<details>

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

一个 StellarOne 控制台代表一个环境，因此 Dispel 会将其建模为映射到一个 Wicket 的单一站点，而不是一组需要逐一映射的站点。

</details>

<details>

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

只要在连接设置中启用 **允许自签名证书** ，连接就不会失败。如果控制台提供的是受信任证书颁发机构颁发的证书，请关闭此选项。

</details>

<details>

<summary>连接 TXOne 会更改 StellarOne 中的任何内容吗？</summary>

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

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