> 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 中， **agents** 是受管理的 StellarProtect 端点。Dispel 将每个 agent 作为设备导入，并报告其 IP、MAC、主机名、操作系统以及已安装的 ICS 应用。由于 StellarOne 控制台代表单一环境，Dispel 会将该控制台视为一个 **站点** ，并将其映射到一个单独的 Wicket。

#### Dispel 导入的内容

* 受管 agent（主机名、IP 地址、MAC 地址、操作系统）作为 Dispel 设备。
* 每个 agent 观测到的网络协议和端口。
* 指向 StellarOne 中该 agent 的链接，存储在设备上。

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

## 开始之前

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

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

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

## 连接 TXOne

1. 前往 **设置 → 集成** 并点击 **连接** 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 会将控制台中的 agent 导入到已映射的 Wicket 中——你会看到进度从等待、获取、同步到完成——然后报告导入了多少设备（例如， **“已导入 12 台设备”** 或新设备与已导入设备的明细）。导入的设备会与任何你手动添加的设备一起显示在已映射的 Wicket 中。

## 保持你的库存最新

* Dispel **会自动重新同步** ，按周期计划执行，因此新注册的 agent 和更改后的详细信息会在无需你任何操作的情况下被获取。
* 要立即拉取最新库存，请打开该集成并选择 **刷新**.
* 要更改连接详细信息或轮换密钥，请编辑该集成并使用 **保存并同步**. 将凭据字段留空可保留当前密钥。

## 连接状态

每个集成都会显示一个状态，因此你始终知道它处于什么阶段：

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

单独的 **健康徽章** （已连接、已降级、无法访问）反映了 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.