> 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/tenable.md).
# Tenable OT Security
Conecta Tenable OT Security, a través de su API REST en tu appliance local, para extraer los activos OT descubiertos a Dispel como dispositivos — con sus vulnerabilidades conocidas — asignados a un Wicket y refresc
## Descripción general
La integración de Tenable permite a Dispel extraer los activos OT que Tenable ha descubierto en tu red e incorporarlos como dispositivos de Dispel, junto con las vulnerabilidades conocidas que Tenable ha encontrado en ellos. Te conectas a tu dispositivo Tenable una sola vez, lo asignas a una instalación de Dispel y a un Wicket, y Dispel importa los dispositivos coincidentes y los mantiene actualizados mediante una sincronización recurrente.
Tenable es una integración local de descubrimiento de activos. En concreto, Dispel se integra con Tenable OT Security (antes Tenable.ot) a través de su API REST.
Como un dispositivo Tenable contiene un único inventario plano de activos sin un concepto nativo de sitio o ubicación, Dispel lo trata como un solo sitio que asignas a un único Wicket; no hay una lista por sitio que revisar.
#### Qué importa Dispel
* Activos OT descubiertos (nombre, dirección IP, dirección MAC, fabricante/modelo, sistema operativo, versión de firmware, número de serie, tipo de dispositivo) como dispositivos de Dispel.
* Vulnerabilidades conocidas de cada activo, tomadas de los hallazgos de plugins de Tenable, con el CVE y la severidad CVSS cuando estén disponibles. Los plugins de severidad informativa (por ejemplo, "Open Port") se filtran para que los recuentos coincidan con el panel OT propio de Tenable.
* Información adicional del dispositivo mostrada en el dispositivo: estado de fin de vida útil, detalles SNMP y, para controladores basados en chasis, una vista del backplane que muestra qué módulos comparten el rack.
{% hint style="info" %}
**Dónde encontrarlo.** Inicia sesión como administrador de la organización y abre **Configuración → Integraciones**. Tenable aparece en la **Descubrimiento de activos / Visibilidad de red** sección. Haz clic en **Conectar** en la tarjeta de Tenable para comenzar.
{% endhint %}
## Antes de comenzar
Necesitarás lo siguiente de tu consola de Tenable:
* Una clave API: genera una en **Configuración local → Administración de usuarios → Claves API**. Tenable emite dos valores: un **ID de clave** (un identificador corto) y la **Clave API** secreta en sí misma.
* La **URL del dispositivo** de tu dispositivo Tenable; por ejemplo `https://tenable-ot.example.com`.
* Si tu dispositivo usa un certificado TLS autofirmado, prepárate para habilitar la opción de autofirmado durante la configuración.
{% hint style="warning" %}
**Incluye la IP de Dispel en la lista permitida.** Cuando abras el formulario de conexión, Dispel mostrará un valor de **IP de lista blanca** Añade esta dirección a la lista permitida de tu firewall de red para que Dispel pueda الوصول al dispositivo local.
{% endhint %}
## Conectando Tenable
1. Ve a **Configuración → Integraciones** y haz clic en **Conectar** en la tarjeta de Tenable.
2. Opcionalmente, define un **Nombre para mostrar** para distinguir esta integración de otras (puedes conectar más de un dispositivo).
3. Completa los campos de conexión:
| Campo | Tipo | Notas |
| -------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------ |
| **URL del dispositivo** | Configuración | La URL base de tu dispositivo Tenable, por ejemplo `https://tenable-ot.example.com`. |
| **Permitir certificados autofirmados** | Configuración | Actívalo si tu dispositivo usa un certificado TLS autofirmado. |
| **ID de clave** | Credencial | El identificador que se muestra junto a tu clave API en Tenable. Identifica la clave; no se usa para autenticarse. |
| **Clave API** | Credencial | El secreto de la clave API. Se almacena cifrado y no se volverá a mostrar. |
4. Haz clic en **Probar conexión** para confirmar que Dispel puede autenticarse en el dispositivo. Corrige cualquier error informado antes de guardar.
5. Haz clic en **Guardar**. Dispel guarda la integración y ejecuta inmediatamente la sincronización inicial.
{% hint style="info" %}
**ID de clave frente a clave API.** Dispel se autentica usando solo el secreto de la clave API. El ID de clave se guarda únicamente como referencia, para que puedas saber qué clave está en uso cuando llegue el momento de rotarla.
{% endhint %}
{% hint style="info" %}
**Tus credenciales están cifradas.** La clave API se cifra en reposo y no se vuelve a mostrar después de guardarla. Al editarla más tarde, deja los campos de credenciales en blanco para conservar los valores almacenados.
{% endhint %}
## Asignar el dispositivo a un Wicket
Una vez que termine la sincronización inicial, abre la integración para encontrar la sección de **Asignación de sitio** Tenable aparece como un único sitio que representa tu dispositivo.
> Asigna cada sitio del proveedor a una instalación de Dispel y a un Wicket. Los dispositivos de los sitios asignados se sincronizarán en Dispel.
1. Elige una **Instalación**.
2. Elige una **Wicket**. Si la instalación tiene solo un Wicket, Dispel lo selecciona por ti.
3. Haz clic en **Guardar asignaciones e importar**.
Dispel importa los activos del dispositivo al Wicket asignado; verás cómo el progreso pasa de en espera, a obteniendo, a sincronizando, a completado; y después informa cuántos dispositivos se importaron. Los dispositivos importados aparecen en el Wicket asignado junto con cualquier dispositivo que hayas agregado manualmente, con sus vulnerabilidades adjuntas.
## Mantener actualizado tu inventario
* Dispel se resincroniza automáticamente según un programa recurrente, por lo que los activos descubiertos recientemente, los detalles modificados y las vulnerabilidades actualizadas se detectan sin que tengas que hacer nada.
* Para obtener el inventario más reciente de inmediato, abre la integración y elige **Actualizar**.
* Para cambiar los detalles de la conexión o rotar credenciales, edita la integración y usa **Guardar y sincronizar**. Deja los campos de credenciales en blanco para conservar la clave API actual.
Los hallazgos de vulnerabilidades se actualizan en cada sincronización, y los hallazgos que Tenable ya no informa desaparecen automáticamente.
## Estado de la conexión
Cada integración muestra un estado para que siempre sepas en qué punto está:
| Estado | Significado |
| -------------------------- | ------------------------------------------------------------------------------------- |
| **No inicializado** | Guardado, pero la primera sincronización aún no se ha ejecutado. |
| **Inicializando** | Ejecutando la primera sincronización. |
| **Listo** | Conectado y sincronizado; la asignación se aplica. |
| **Necesita actualización** | Hay nuevos datos del proveedor disponibles; ejecuta una actualización para cargarlos. |
| **Actualizando** | Hay una sincronización en curso. |
| **Cambios pendientes** | Los cambios de asignación están guardados pero aún no se han aplicado. |
| **Aplicando** | Importando dispositivos para tu asignación guardada. |
| **Fallido** | La última operación falló; consulta la guía del error. |
Una **insignia de estado** (Conectado, Degradado, Inalcanzable) refleja si Dispel puede alcanzar actualmente el dispositivo Tenable.
## Solución de problemas
Si una sincronización o una conexión de prueba falla, Dispel clasifica el error y sugiere una solución:
| Error | Qué suele significar y cómo solucionarlo |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Falló la autenticación** | La clave API fue rechazada. Confirma que la clave sigue activa en Tenable (**Configuración local → Administración de usuarios → Claves API**) y que pegaste el **Clave API** secreto, no el **ID de clave**. |
| **Punto final inaccesible** | Dispel no pudo الوصول al dispositivo. Verifica la URL del dispositivo y que la IP de Dispel esté incluida en la lista permitida de tu firewall. |
| **Error de certificado** | El dispositivo presentó un certificado TLS no confiable. Si usa un certificado autofirmado, habilita **Permitir certificados autofirmados** en la configuración de conexión. |
| **La conexión agotó el tiempo de espera** | El dispositivo tardó demasiado en responder; normalmente se debe a latencia de red o a una regla de firewall entre Dispel y tu red. |
| **Error de configuración** | La URL parece incorrecta o la API no es accesible en esa dirección. Revisa de nuevo la URL del dispositivo. |
## Preguntas frecuentes
¿A qué producto de Tenable se conecta esto?
Tenable OT Security (antes Tenable.ot), el dispositivo local que descubre y evalúa activos OT. Esto no es el servicio en la nube Tenable Vulnerability Management (Tenable.io).
¿Cuál es la diferencia entre el ID de clave y la clave API?
Cuando generas una clave API, Tenable emite dos valores: un ID de clave (un identificador corto) y el secreto de la clave API. Dispel se autentica solo con el secreto; el ID de clave se guarda como referencia para que sepas qué clave está en uso al rotarla.
¿Por qué los recuentos de vulnerabilidades no coinciden con el recuento bruto de plugins de Tenable?
Dispel filtra los plugins de severidad informativa (por ejemplo, "Open Port") para que las cifras coincidan con los recuentos de vulnerabilidades que se muestran en el panel OT propio de Tenable, en lugar del total mayor que incluye resultados puramente informativos.
¿Puedo conectar más de un dispositivo Tenable?
Sí. Tenable admite varias integraciones, por lo que puedes conectar varios dispositivos uno al lado del otro. Asigna a cada uno un **Nombre para mostrar** distinto para diferenciarlos.
¿Conectar Tenable cambia algo en mi dispositivo?
No. Dispel solo lee de la API de Tenable. Nunca crea, modifica ni elimina datos en el lado de 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-es/integrar-y-administrar/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.