> 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/tenable.md).
# Tenable OT Security
Conecte o Tenable OT Security, por meio da API REST em seu appliance local, para importar ativos OT descobertos para o Dispel como dispositivos — com suas vulnerabilidades conhecidas — mapeados para um Wicket e atualizad
## Visão geral
A integração com o Tenable permite que o Dispel capture os ativos OT que o Tenable обнаружiu na sua rede e os traga como dispositivos do Dispel, juntamente com as vulnerabilidades conhecidas que o Tenable encontrou neles. Você se conecta ao seu appliance Tenable 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.
O Tenable é uma integração de descoberta de ativos local. Especificamente, o Dispel se integra ao Tenable OT Security (anteriormente Tenable.ot) por meio da sua API REST.
Como um appliance Tenable mantém um único inventário plano de ativos, sem conceito nativo de site ou local, o Dispel o trata como um único site que você mapeia para um único Wicket — não há uma lista por site para percorrer.
#### O que o Dispel importa
* Ativos OT descobertos (nome, endereço IP, endereço MAC, fabricante/modelo, sistema operacional, versão do firmware, número de série, tipo de dispositivo) como dispositivos do Dispel.
* Vulnerabilidades conhecidas de cada ativo, extraídas das descobertas de plugins do Tenable, com CVE e severidade CVSS quando उपलब्धíveis. Plugins de severidade informativa (por exemplo, "Open Port") são filtrados para que os totais correspondam ao próprio painel OT do Tenable.
* Inteligência adicional do dispositivo exibida no dispositivo: status de fim de vida útil, detalhes SNMP e — para controladores baseados em chassis — uma visualização do backplane mostrando quais módulos compartilham o rack.
{% hint style="info" %}
**Onde encontrá-lo.** Entre como administrador da organização e abra **Configurações → Integrações**. O Tenable aparece na seção **Descoberta de ativos / Visibilidade de rede** . Clique em **Conectar** no cartão do Tenable para começar.
{% endhint %}
## Antes de começar
Você vai precisar do seguinte no seu console Tenable:
* Uma chave de API — gere uma em **Configurações locais → Gerenciamento de usuários → Chaves de API**. O Tenable emite dois valores: um **ID da chave** (um identificador curto) e a **Chave de API** secreta em si.
* O **URL do appliance** do seu appliance Tenable — por exemplo `https://tenable-ot.example.com`.
* Se o seu appliance usar um certificado TLS autoassinado, esteja pronto para ativar a opção de autoassinado durante a configuração.
{% hint style="warning" %}
**Inclua o IP do Dispel na lista de permissões.** Quando você abrir o formulário de conexão, o Dispel exibirá um valor de **IP na lista de permissões** Adicione esse endereço à lista de permissões do firewall da sua rede para que o Dispel consiga alcançar o appliance local.
{% endhint %}
## Conectando o Tenable
1. Vá para **Configurações → Integrações** e clique em **Conectar** no cartão do Tenable.
2. Opcionalmente, defina um **Nome de exibição** para distinguir esta integração das outras (você pode conectar mais de um appliance).
3. Preencha os campos de conexão:
| Campo | Tipo | Observações |
| --------------------------------------- | ---------- | ----------------------------------------------------------------------------------------------------------------------- |
| **URL do appliance** | Config | A URL base do seu appliance Tenable, por exemplo `https://tenable-ot.example.com`. |
| **Permitir certificados autoassinados** | Config | Ative esta opção se o seu appliance usar um certificado TLS autoassinado. |
| **ID da chave** | Credencial | O identificador exibido ao lado da sua chave de API no Tenable. Ele identifica a chave — não é usado para autenticação. |
| **Chave de API** | Credencial | O segredo da chave de API. Armazenado de forma criptografada e nunca mostrado novamente. |
4. Clique em **Testar conexão** para confirmar que o Dispel consegue autenticar no appliance. 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" %}
**ID da chave vs. Chave de API.** O Dispel autentica usando apenas o segredo da chave de API. O ID da chave é armazenado somente para referência — para que você consiga identificar qual chave está em uso quando for hora de rotacioná-la.
{% endhint %}
{% hint style="info" %}
**Suas credenciais são criptografadas.** A chave de API é criptografada em repouso e nunca é exibida novamente depois que você salva. Ao editar mais tarde, deixe os campos de credencial em branco para manter os valores armazenados.
{% endhint %}
## Mapeando o appliance para um Wicket
Quando a sincronização inicial terminar, abra a integração para encontrar a seção de **Mapeamento de site** . O Tenable aparece como um único site representando o seu appliance.
> 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 ativos do appliance para o Wicket mapeado — você verá o progresso passar de aguardando para buscando, para sincronizando, até concluir — e então informa quantos dispositivos foram importados. Os dispositivos importados aparecem no Wicket mapeado junto com quaisquer dispositivos que você adicionou manualmente, com suas vulnerabilidades associadas.
## Mantendo seu inventário atualizado
* O Dispel sincroniza novamente automaticamente em um cronograma recorrente, de modo que ativos recém-descobertos, detalhes alterados e vulnerabilidades atualizadas sejam capturados sem nenhuma ação da sua parte.
* Para buscar o inventário mais recente imediatamente, abra a integração e escolha **Atualizar**.
* Para alterar os detalhes de conexão ou rotacionar credenciais, edite a integração e use **Salvar e sincronizar**. Deixe os campos de credencial em branco para manter a chave de API atual.
As descobertas de vulnerabilidade são atualizadas a cada sincronização, e as descobertas que o Tenable não reporta mais são removidas automaticamente.
## 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 buscá-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 as orientações de erro. |
Um **indicador de saúde** (Conectado, Degradado, Inacessível) reflete se o Dispel consegue alcançar o appliance Tenable no momento.
## Solução de problemas
Se uma sincronização ou teste de conexão falhar, o Dispel classifica o erro e sugere uma solução:
| Erro | O que normalmente significa e como corrigir |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Falha na autenticação** | A chave de API foi rejeitada. Confirme se a chave ainda está ativa no Tenable (**Configurações locais → Gerenciamento de usuários → Chaves de API**) e se você colou o **Chave de API** segredo — e não o **ID da chave**. |
| **Endpoint inacessível** | O Dispel não conseguiu alcançar o appliance. Verifique a URL do appliance e se o IP do Dispel está na lista de permissões do seu firewall. |
| **Erro de certificado** | O appliance apresentou um certificado TLS não confiável. Se ele usa um certificado autoassinado, ative **Permitir certificados autoassinados** nas configurações de conexão. |
| **Tempo limite da conexão excedido** | O appliance 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 errada ou a API não está acessível nesse endereço. Verifique novamente a URL do appliance. |
## Perguntas frequentes
Com qual produto Tenable isso se conecta?
Tenable OT Security (anteriormente Tenable.ot) — o appliance local que descobre e avalia ativos OT. Este não é o serviço em nuvem Tenable Vulnerability Management (Tenable.io).
Qual é a diferença entre o ID da chave e a Chave de API?
Quando você gera uma chave de API, o Tenable emite dois valores: um ID da chave (um identificador curto) e o segredo da Chave de API. O Dispel autentica apenas com o segredo; o ID da chave é armazenado para referência, para que você saiba qual chave está em uso ao rotacioná-la.
Por que as contagens de vulnerabilidades não correspondem à contagem bruta de plugins do Tenable?
O Dispel filtra plugins de severidade informativa (por exemplo, "Open Port") para que os números coincidam com as contagens de vulnerabilidades mostradas no próprio painel OT do Tenable, em vez do total maior que inclui resultados puramente informativos.
Posso conectar mais de um appliance Tenable?
Sim. O Tenable oferece suporte a várias integrações, então você pode conectar vários appliances lado a lado. Dê a cada um um **Nome de exibição** para diferenciá-los.
Conectar o Tenable muda algo no meu appliance?
Não. O Dispel apenas lê a API do Tenable. Ele nunca cria, modifica ou exclui dados no lado do Tenable.
---
# 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/tenable.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.