> 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-es/integrar-y-administrar/integrations/asset-discovery/txone.md).

# TXOne

Conecta tu consola TXOne StellarOne para incorporar a Dispel los endpoints OT protegidos como dispositivos, asignarlos a un Wicket y actualizarlos mediante una sincronización recurrente.

## Descripción general

La integración de TXOne permite que Dispel obtenga los endpoints de OT administrados por tu consola de TXOne **StellarOne**  y los incorpore como dispositivos de Dispel. Te conectas a StellarOne una sola vez, la asignas a una instalación de Dispel y a un Wicket, y Dispel importa los dispositivos correspondientes y los mantiene actualizados mediante sincronizaciones periódicas.

TXOne es una integración de **detección de activos** . Dispel se conecta a tu consola de administración de StellarOne y solo lee información de ella.

En StellarOne, los **agentes**  son los endpoints de StellarProtect que se encuentran bajo administración. Dispel importa cada agente como un dispositivo e informa su IP, MAC, nombre de host, sistema operativo y aplicaciones ICS instaladas. Como una consola de StellarOne representa un único entorno, Dispel considera que la consola es un único **sitio**  que asignas a un único Wicket.

#### Qué importa Dispel

* Agentes administrados (nombre de host, dirección IP, dirección MAC y sistema operativo) como dispositivos de Dispel.
* Protocolos de red y puertos observados para cada agente.
* Un enlace al agente en StellarOne, almacenado en el dispositivo.

{% hint style="info" %}
**Dónde encontrarlo.** Inicia sesión como administrador de la organización y abre **Configuración → Integraciones**. TXOne aparece en la sección **Detección de activos / Visibilidad de red** . Haz clic en **Conectar**  en la tarjeta de TXOne para empezar.
{% endhint %}

## Antes de empezar

Necesitarás lo siguiente de tu consola TXOne StellarOne:

* Una **clave de API**, generada desde la consola de administración de StellarOne (consulta la guía del administrador de StellarOne para ver los pasos exactos).
* La **URL de StellarOne** de tu consola; por ejemplo, `https://stellar1.example.com`.
* Si tu consola usa un **certificado TLS autofirmado**, prepárate para habilitar la opción de certificado autofirmado durante la configuración.

{% hint style="warning" %}
**Añade la IP de Dispel a la lista de permitidas.** Al abrir el formulario de conexión, Dispel muestra un valor de **IP de lista blanca** . Añade esta dirección a la lista de permitidas del firewall de tu red para que Dispel pueda acceder a la consola de StellarOne.
{% endhint %}

## Conectar TXOne

1. Ve a **Configuración → Integraciones** y haz clic en **Conectar** en la tarjeta de TXOne.
2. Si quieres, define un **Nombre para mostrar** para distinguir esta integración de las demás (puedes conectar más de una consola).
3. Completa los campos de conexión:

| Campo                                  | Tipo          | Notas                                                                                 |
| -------------------------------------- | ------------- | ------------------------------------------------------------------------------------- |
| **URL de StellarOne**                  | Configuración | La URL de tu consola de administración TXOne StellarOne.                              |
| **Permitir certificados autofirmados** | Configuración | Activa esta opción si tu consola usa un certificado TLS autofirmado.                  |
| **Clave de API**                       | Credencial    | La clave de API generada en StellarOne. Se almacena cifrada y no se vuelve a mostrar. |

4. Haz clic en **Probar conexión** para confirmar que Dispel puede autenticarse en StellarOne. Corrige cualquier error indicado antes de guardar.
5. Haz clic en **Guardar**. Dispel guarda la integración y ejecuta inmediatamente la sincronización inicial.

{% hint style="info" %}
**Tus credenciales están cifradas.** La clave de API se cifra cuando está almacenada y no se vuelve a mostrar después de guardarla. Si la editas más adelante, deja vacío el campo de credenciales para conservar el valor almacenado.
{% endhint %}

## Asignar la consola a un Wicket

Cuando finalice la sincronización inicial, abre la integración para encontrar la sección **Asignación de sitios** . TXOne aparece como un único sitio que representa tu consola de StellarOne.

> Asigna cada sitio del proveedor a una instalación y un Wicket de Dispel. Los dispositivos de los sitios asignados se sincronizarán con Dispel.

1. Elige una **Instalación**.
2. Elige un **Wicket**. Si la instalación solo tiene un Wicket, Dispel lo selecciona automáticamente.
3. Haz clic en **Guardar asignaciones e importar**.

Dispel importa los agentes de la consola al Wicket asignado. Verás cómo el progreso pasa de pendiente a obteniendo, luego a sincronizando y, por último, a completado. Después, se informa cuántos dispositivos se importaron (por ejemplo, **"12 dispositivos importados"** o un desglose de los dispositivos nuevos y los ya importados). Los dispositivos importados aparecen en el Wicket asignado junto con los dispositivos que hayas añadido manualmente.

## Mantener actualizado el inventario

* Dispel **vuelve a sincronizar automáticamente** según un calendario periódico, por lo que se detectan los agentes inscritos recientemente y los cambios en sus datos sin que tengas que hacer nada.
* Para obtener el inventario más reciente de inmediato, abre la integración y selecciona **Actualizar**.
* Para cambiar los datos de conexión o renovar la clave, edita la integración y usa **Guardar y sincronizar**. Deja vacío el campo de credenciales para conservar la clave actual.

## Estado de la conexión

Cada integración muestra un estado para que siempre sepas en qué situación se encuentra:

| Estado                    | Significado                                                                   |
| ------------------------- | ----------------------------------------------------------------------------- |
| **No inicializado**       | Guardada, pero la primera sincronización aún no se ha ejecutado.              |
| **Inicializando**         | Ejecutando la primera sincronización.                                         |
| **Lista**                 | Conectada y sincronizada; se aplicó la asignación.                            |
| **Necesita actualizarse** | Hay nuevos datos del proveedor; actualiza para obtenerlos.                    |
| **Actualizando**          | Hay una sincronización en curso.                                              |
| **Cambios pendientes**    | Los cambios en la asignación están guardados, pero aún no se han aplicado.    |
| **Aplicando**             | Importando dispositivos según la asignación guardada.                         |
| **Error**                 | La última operación falló; consulta las instrucciones para resolver el error. |

Un **indicador de estado** independiente (Conectado, Degradado, Inaccesible) indica si Dispel puede comunicarse actualmente con la consola de StellarOne.

## Solución de problemas

Si falla una sincronización o una prueba de conexión, Dispel clasifica el error y sugiere una solución:

| Error                                    | Qué suele significar y cómo solucionarlo                                                                                                                                        |
| ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Error de autenticación**               | Se rechazó la clave de API. Genera una nueva clave en StellarOne y actualiza la integración.                                                                                    |
| **Punto de conexión inaccesible**        | Dispel no pudo comunicarse con la consola. Comprueba la URL de StellarOne y que la dirección IP de Dispel esté incluida en la lista de permitidos del firewall.                 |
| **Error de certificado**                 | La consola presentó un certificado TLS que no es de confianza. Si utiliza un certificado autofirmado, activa **Permitir certificados autofirmados** en los ajustes de conexión. |
| **Tiempo de espera de conexión agotado** | La consola tardó demasiado en responder, a menudo por la latencia de la red o por una regla del firewall entre Dispel y tu red.                                                 |
| **Error de configuración**               | La URL parece incorrecta. Vuelve a comprobar los ajustes de conexión.                                                                                                           |

## Preguntas frecuentes

<details>

<summary>¿Puedo conectar más de una consola de StellarOne?</summary>

Sí. TXOne admite varias integraciones, así que puedes conectar varias consolas en paralelo. Asigna a cada una un **Nombre visible** distinto para diferenciarlas.

</details>

<details>

<summary>¿Por qué TXOne muestra un solo sitio?</summary>

Una consola de StellarOne representa un único entorno, por lo que Dispel la modela como un sitio asignado a un Wicket, en lugar de mostrar una lista de sitios para asignar individualmente.

</details>

<details>

<summary>Mi consola usa un certificado autofirmado. ¿Fallará la conexión?</summary>

No, si activas **Permitir certificados autofirmados** en los ajustes de conexión. Déjalo desactivado si la consola presenta un certificado emitido por una autoridad de confianza.

</details>

<details>

<summary>¿Conectar TXOne cambia algo en StellarOne?</summary>

No. Dispel solo lee datos de StellarOne. Nunca crea, modifica ni elimina datos en 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-es/integrar-y-administrar/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.
