> 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/claroty-xdome.md).
# Claroty xDome
Conecta Claroty xDome, a través de su API en la nube, para extraer dispositivos OT, IoT e IIoT descubiertos a Dispel — enriquecidos con hallazgos de vulnerabilidades — asignados a un Wicket.
## Descripción general
La integración de Claroty xDome permite a Dispel extraer los activos OT, IoT e IIoT que xDome ha descubierto e incorporarlos como dispositivos de Dispel, enriquecidos con los hallazgos de vulnerabilidades de xDome. Te conectas a tu tenant de xDome una sola vez, lo asignas a una instalación de Dispel y un Wicket, y Dispel importa los dispositivos coincidentes y los mantiene actualizados mediante una sincronización recurrente.
Claroty xDome es una integración de descubrimiento de activos en la nube. Dispel se autentica en la API de xDome con un token de API y solo lee de ella. Como un tenant de xDome representa un único entorno, Dispel lo trata como un solo sitio que asignas a un único Wicket; no hay una lista por sitio que revisar.
#### Qué importa Dispel
* Dispositivos que xDome ha descubierto, asignados a tus dispositivos de Dispel existentes e importados como nuevos dispositivos donde no hay coincidencia.
* Los hallazgos de vulnerabilidades de xDome (basados en CVE, con puntuaciones CVSS v3) como hallazgos en los dispositivos coincidentes, para que puedas ver los problemas conocidos de un dispositivo sin salir de Dispel.
{% hint style="info" %}
**Dónde encontrarlo.** Inicie sesión como administrador de la organización y abra [**Configuración → Integraciones**](https://app.dispel.com/settings/integrations). Claroty xDome aparece en la **Descubrimiento de activos / Visibilidad de red** sección. Haga clic en **Conectar** en la tarjeta de Claroty xDome para comenzar.
{% endhint %}
## Antes de comenzar
Necesitarás lo siguiente de xDome:
* Una **token de API**. En xDome, ve a **Configuración → Configuración de administrador → Gestión de usuarios**, crea un usuario de API y luego genera un token para él.
* Tu **host de la API de xDome específico de tu región** — por ejemplo `https://api.claroty.com` o `https://eu.api.claroty.com`.
{% hint style="warning" %}
**El token de API se muestra una sola vez.** xDome muestra el token solo cuando lo generas. Cópialo en ese momento; si lo pierdes, genera uno nuevo.
{% endhint %}
{% hint style="info" %}
**El alcance de los permisos del token determina lo que ve Dispel.** Dispel importa los activos que el usuario de API tiene permiso para leer, así que dale al usuario de API acceso a los sitios cuyos dispositivos quieres en Dispel.
{% endhint %}
## Conectando Claroty xDome
1. Vaya a [**Configuración → Integraciones**](https://app.dispel.com/settings/integrations) y haga clic en **Conectar** en la tarjeta de Claroty xDome.
2. Opcionalmente, establezca un **Nombre para mostrar** para distinguir esta integración de las demás (puedes conectar más de una instancia).
3. Complete los campos de conexión:
| Campo | Tipo | Notas |
| ---------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **URL de la API** | Configuración | Tu host de la API de xDome específico de tu región, por ejemplo `https://api.claroty.com` o `https://eu.api.claroty.com`. |
| **Token de API** | Credencial | El token generado para un usuario de API en xDome. Se almacena cifrado y nunca se vuelve a mostrar. |
| **Incluir dispositivos retirados** | Configuración | Opcional. Cuando está activado, Dispel también importa los dispositivos que xDome ha marcado como retirados. Desactivado por defecto. |
4. Haga clic en **Probar conexión** para confirmar que Dispel puede autenticarse. Corrige cualquier error notificado antes de guardar.
5. Haga clic en **Guardar**. Dispel guarda la integración y ejecuta inmediatamente la sincronización inicial.
{% hint style="info" %}
**Sus credenciales están cifradas.** El token de API se cifra en reposo y nunca se muestra de nuevo después de guardarlo. Al editar más tarde, deja el campo del token en blanco para conservar el valor almacenado.
{% endhint %}
## Asignación del tenant a un Wicket
Una vez que finalice la sincronización inicial, abra la integración para encontrar la **Asignación de sitios** sección. Claroty xDome aparece como un solo sitio que representa tu tenant.
> Asigne cada sitio del proveedor a una instalación y un Wicket de Dispel. Los dispositivos de los sitios asignados se sincronizarán en Dispel.
1. Elija un **Instalación**.
2. Elija un **Wicket**. Si la instalación solo tiene un Wicket, Dispel lo selecciona por usted.
3. Haga clic en **Guardar asignaciones e importar**.
Dispel importa los dispositivos de xDome al Wicket asignado y luego informa cuántos dispositivos se importaron. Los dispositivos importados aparecen en el Wicket asignado junto con cualquier dispositivo que hayas añadido manualmente, con los hallazgos de vulnerabilidades de xDome adjuntos.
## Manteniendo su inventario actualizado
* Dispel vuelve a sincronizar automáticamente en un horario recurrente, de modo que los dispositivos descubiertos recientemente, los detalles cambiados y los nuevos hallazgos se incorporan sin ninguna acción de tu parte.
* Para obtener de inmediato el inventario más reciente, abra la integración y elija **Actualizar**.
* Para cambiar los detalles de conexión o rotar el token, edita la integración y usa **Guardar y sincronizar**. Deja el campo del token en blanco para conservar el token actual.
Los hallazgos de vulnerabilidades se actualizan en cada sincronización, y cualquier hallazgo que xDome ya no reporte desaparece automáticamente.
## Estado de la conexión
Cada integración muestra un estado para que siempre sepa en qué punto se encuentra:
| 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 ha aplicado. |
| **Necesita actualización** | Hay nuevos datos del proveedor disponibles; ejecute una actualización para obtenerlos. |
| **Actualizando** | Hay una sincronización en curso. |
| **Cambios pendientes** | Los cambios de asignación se han guardado, pero aún no se han aplicado. |
| **Aplicando** | Importando dispositivos para su asignación guardada. |
| **Falló** | La última operación falló — consulte la guía del error. |
Una **insignia de estado** (Conectado, Degradado, Inalcanzable) refleja si Dispel puede الوصول actualmente a la API de xDome.
## Solución de problemas
Si una sincronización o prueba de conexión falla, Dispel clasifica el error y sugiere una solución:
| Error | Qué suele significar y cómo solucionarlo |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Falló la autenticación** | El token de API fue rechazado. Confirma que el usuario de API está activo en xDome y que el token es actual; se muestra solo una vez, así que genera uno nuevo si se perdió. |
| **Punto final inaccesible** | Dispel no pudo الوصول a xDome. Verifica que la URL de la API sea tu host correcto específico de la región (por ejemplo `https://api.claroty.com` o `https://eu.api.claroty.com`). |
| **Tiempo de conexión agotado** | xDome tardó demasiado en responder — normalmente es un problema de red transitorio; inténtalo de nuevo. |
## Preguntas frecuentes
¿Dónde creo el token de API?
En xDome, ve a **Configuración → Configuración de administrador → Gestión de usuarios**, crea un usuario de API y genera un token para él. El token se muestra solo una vez, así que cópialo antes de salir de la página.
¿Qué URL de API debo usar?
Tu host de la API de xDome específico de tu región, por ejemplo `https://api.claroty.com` o `https://eu.api.claroty.com`. Usa el host de la región en la que se ejecuta tu tenant de xDome.
¿Qué hallazgos de Claroty xDome incorpora Dispel?
Los hallazgos de vulnerabilidades de xDome — basados en CVE, con puntuaciones CVSS v3 — adjuntos a los dispositivos coincidentes. Los hallazgos se actualizan en cada sincronización, y cualquier hallazgo que xDome ya no reporte desaparece automáticamente.
¿Dispel cambia algo en xDome?
No. La integración es de solo lectura. Dispel extrae inventario y hallazgos, pero nunca crea, modifica ni elimina datos en xDome.
¿Puedo conectar más de un tenant de xDome?
Sí. Claroty xDome admite varias integraciones, así que puedes conectar varios tenants uno al lado del otro. Asigna a cada uno un distinto **Nombre para mostrar** para distinguirlos.
---
# 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/claroty-xdome.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.