> 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-pt-br/integre-e-administre/integrations/asset-discovery/txone.md).
# TXOne
Conecte seu console TXOne StellarOne para trazer endpoints de OT protegidos para a Dispel como dispositivos, mapeados para um Wicket e atualizados em uma sincronização recorrente.
## Visão geral
A integração com TXOne permite que o Dispel obtenha os endpoints de OT gerenciados pelo seu TXOne **StellarOne** console e os traga como dispositivos do Dispel. Você se conecta ao StellarOne uma vez, mapeia-o para uma instalação e um Wicket do Dispel, e o Dispel importa os dispositivos correspondentes e os mantém atualizados em uma sincronização recorrente.
TXOne é uma **integração de descoberta de ativos** integração. O Dispel se conecta ao seu console de gerenciamento StellarOne e apenas lê dele.
No StellarOne, **agentes** são os endpoints StellarProtect sob gerenciamento. O Dispel importa cada agente como um dispositivo, informando seu IP, MAC, nome do host, sistema operacional e os aplicativos de ICS instalados. Como um console StellarOne representa um único ambiente, o Dispel trata o console como um **site** que você mapeia para um único Wicket.
#### O que o Dispel importa
* Agentes gerenciados (nome do host, endereço IP, endereço MAC, sistema operacional) como dispositivos do Dispel.
* Protocolos e portas de rede observados para cada agente.
* Um link de volta para o agente no StellarOne, armazenado no dispositivo.
{% hint style="info" %}
**Onde encontrar.** Entre como administrador da organização e abra **Configurações → Integrações**. O TXOne aparece na **Descoberta de ativos / Visibilidade de rede** seção. Clique em **Conectar** no cartão do TXOne para começar.
{% endhint %}
## Antes de começar
Você precisará do seguinte do seu console TXOne StellarOne:
* Uma **chave de API**, gerada no Console de Gerenciamento do StellarOne (consulte o Guia do Administrador do StellarOne para ver os passos exatos).
* O **URL do StellarOne** do seu console — por exemplo `https://stellar1.example.com`.
* Se o seu console usar um **certificado TLS autoassinado**, esteja pronto para ativar a opção de autoassinado durante a configuração.
{% hint style="warning" %}
**Adicione o IP do Dispel à allowlist.** Ao abrir o formulário de conexão, o Dispel mostra um **IP da whitelist** valor. Adicione este endereço à lista de permissões do seu firewall de rede para que o Dispel possa alcançar o console StellarOne.
{% endhint %}
## Conectando o TXOne
1. Vá para **Configurações → Integrações** e clique em **Conectar** no cartão do TXOne.
2. Opcionalmente, defina um **Nome de exibição** para diferenciar esta integração das outras (você pode conectar mais de um console).
3. Preencha os campos de conexão:
| Campo | Tipo | Observações |
| --------------------------------------- | ---------- | ---------------------------------------------------------------------------------------- |
| **URL do StellarOne** | Config | A URL do seu console de gerenciamento TXOne StellarOne. |
| **Permitir certificados autoassinados** | Config | Ative se o seu console usar um certificado TLS autoassinado. |
| **Chave de API** | Credencial | A chave de API gerada no StellarOne. Armazenada criptografada e nunca exibida novamente. |
4. Clique em **Testar conexão** para confirmar que o Dispel pode se autenticar no StellarOne. Corrija qualquer erro informado antes de salvar.
5. Clique em **Salvar**. O Dispel salva a integração e executa imediatamente a sincronização inicial.
{% hint style="info" %}
**Suas credenciais são criptografadas.** A chave de API é criptografada em repouso e nunca é exibida novamente após você salvar. Ao editar depois, deixe o campo de credencial em branco para manter o valor armazenado.
{% endhint %}
## Mapeando o console para um Wicket
Quando a sincronização inicial terminar, abra a integração para encontrar a **Mapeamento de site** seção. O TXOne aparece como um único site representando seu console StellarOne.
> Mapeie cada site do fornecedor para uma instalação e um wicket do Dispel. Os dispositivos dos sites mapeados serão sincronizados no Dispel.
1. Escolha uma **Instalação**.
2. Escolha uma **Wicket**. Se a instalação tiver apenas um Wicket, o Dispel o seleciona para você.
3. Clique em **Salvar mapeamentos e importar**.
O Dispel importa os agentes do console para o Wicket mapeado — você verá o progresso passar de aguardando para obtendo, para sincronizando, para concluído — e então informa quantos dispositivos foram importados (por exemplo, **"12 dispositivos importados"** ou uma discriminação entre dispositivos novos e já importados). Os dispositivos importados aparecem no Wicket mapeado junto com quaisquer dispositivos que você adicionou manualmente.
## Mantendo seu inventário atualizado
* O Dispel **ressincroniza automaticamente** em um agendamento recorrente, para que agentes recém-cadastrados e detalhes alterados sejam capturados sem nenhuma ação da sua parte.
* Para obter o inventário mais recente imediatamente, abra a integração e escolha **Atualizar**.
* Para alterar os detalhes da conexão ou trocar a chave, edite a integração e use **Salvar e sincronizar**. Deixe o campo de credencial em branco para manter a chave atual.
## Status da conexão
Cada integração mostra um status para que você sempre saiba em que situação ela está:
| Status | Significado |
| -------------------------- | ----------------------------------------------------------------------------------- |
| **Não inicializado** | Salvo, mas a primeira sincronização ainda não foi executada. |
| **Inicializando** | Executando a primeira sincronização. |
| **Pronto** | Conectado e sincronizado; o mapeamento foi aplicado. |
| **Precisa de atualização** | Novos dados do fornecedor estão disponíveis; execute uma atualização para obtê-los. |
| **Atualizando** | Uma sincronização está em andamento. |
| **Alterações pendentes** | As alterações de mapeamento foram salvas, mas ainda não foram aplicadas. |
| **Aplicando** | Importando dispositivos para o mapeamento salvo. |
| **Falhou** | A última operação falhou — consulte a orientação do erro. |
Um **indicador de integridade** (Conectado, Degradado, Inacessível) reflete se o Dispel consegue alcançar o console StellarOne no momento.
## Solução de problemas
Se uma sincronização ou teste de conexão falhar, o Dispel classifica o erro e sugere uma correção:
| Erro | O que geralmente significa e como corrigir |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Falha na autenticação** | A chave de API foi rejeitada. Gere uma nova chave no StellarOne e atualize a integração. |
| **Endpoint inacessível** | O Dispel não conseguiu alcançar o console. Verifique a URL do StellarOne e se o IP do Dispel está na allowlist do seu firewall. |
| **Erro de certificado** | O console apresentou um certificado TLS não confiável. Se ele usar um certificado autoassinado, ative **Permitir certificados autoassinados** nas configurações de conexão. |
| **Tempo de conexão esgotado** | O console demorou demais para responder — geralmente por latência de rede ou uma regra de firewall entre o Dispel e sua rede. |
| **Erro de configuração** | A URL parece incorreta. Verifique novamente as configurações de conexão. |
## Perguntas frequentes
Posso conectar mais de um console StellarOne?
Sim. O TXOne oferece suporte a várias integrações, então você pode conectar vários consoles lado a lado. Dê a cada um um **Nome de exibição** nome distinto para diferenciá-los.
Por que o TXOne mostra apenas um site?
Um console StellarOne representa um único ambiente, então o Dispel o modela como um site mapeado para um Wicket — em vez de uma lista de sites para mapear individualmente.
Meu console usa um certificado autoassinado. A conexão falhará?
Não, se você ativar **Permitir certificados autoassinados** nas configurações de conexão. Mantenha desativado quando seu console apresentar um certificado de uma autoridade confiável.
Conectar o TXOne altera algo no StellarOne?
Não. O Dispel apenas lê do StellarOne. Ele nunca cria, modifica ou exclui dados do lado do TXOne.
---
# 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-pt-br/integre-e-administre/integrations/asset-discovery/txone.md?ask=&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.