> 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/dragos.md).

# Dragos

Conecta la plataforma Dragos (SiteStore) para incorporar a Dispel los activos OT detectados, asignar los sensores de Dragos a Wickets y mantener sincronizados los datos de los dispositivos y los hallazgos de vulnerabilidades.

## Resumen

La integración de Dragos permite a Dispel extraer los activos OT que la plataforma Dragos ha descubierto e incorporarlos como dispositivos de Dispel. Conectas tu Dragos **SiteStore** una vez, asigna cada sensor de Dragos a una instalación y Wicket de Dispel, y Dispel importa los dispositivos correspondientes y los mantiene actualizados mediante una sincronización recurrente.

Dragos es una **de descubrimiento de activos** integración. Dispel lee de Dragos — nunca escribe de vuelta en la plataforma.

En Dragos, **los sensores** son los puntos de recopilación que supervisan su red industrial. Dispel trata cada sensor de Dragos como una **sitio** que asignas a un Wicket de Dispel, para que los activos lleguen al lugar correcto según el sensor.

#### Qué importa Dispel

* Activos descubiertos (nombre, dirección IP, dirección MAC, marca/modelo, sistema operativo, tipo de dispositivo) como dispositivos de Dispel.
* Protocolos y puertos de red observados para cada activo.
* Un enlace de regreso al activo en Dragos, almacenado en el dispositivo.
* **Hallazgos de vulnerabilidades** para cada dispositivo importado — cubriendo tanto problemas de hardware/firmware como de software/SO — actualizado en cada sincronización.

{% hint style="info" %}
**Dónde encontrarlo.** Inicie sesión como administrador de la organización y abra **Configuración → Integraciones**. Dragos aparece en la **Descubrimiento de activos / Visibilidad de red** sección. Haga clic en **Conectar** en la tarjeta de Dragos para comenzar.
{% endhint %}

## Antes de comenzar

Necesitarás lo siguiente de tu SiteStore de Dragos:

* Una **clave API** — su **ID de la clave API** (el identificador) y **Secreto de la clave API**. Aprovisiona esto en SiteStore.
* La **URL de SiteStore** de tu implementación — por ejemplo `https://customer.dragos.cloud`.

{% hint style="warning" %}
**El secreto de la clave API se muestra solo una vez.** Dragos muestra el secreto una sola vez cuando aprovisionas la clave. Cópialo en ese momento — si lo pierdes, aprovisiona una nueva clave. Además, añade la IP de Dispel **IP de lista blanca** (mostrada en el formulario de conexión) a la lista de permitidos de tu firewall para que Dispel pueda acceder a SiteStore, especialmente en implementaciones locales.
{% endhint %}

## Conexión de Dragos

1. Vaya a **Configuración → Integraciones** y haga clic en **Conectar** en la tarjeta de Dragos.
2. Opcionalmente, establezca un **Nombre para mostrar** para distinguir esta integración de las demás (puedes conectar más de un SiteStore).
3. Complete los campos de conexión:

| Campo                       | Tipo          | Notas                                                                              |
| --------------------------- | ------------- | ---------------------------------------------------------------------------------- |
| **URL de SiteStore**        | Configuración | La URL base de tu instancia de Dragos SiteStore.                                   |
| **ID de la clave API**      | Credencial    | El identificador de la clave API de tu SiteStore de Dragos.                        |
| **Secreto de la clave API** | Credencial    | El secreto asociado con la clave. Se almacena cifrado y nunca se vuelve a mostrar. |

4. Haga clic en **Probar conexión** para confirmar que Dispel puede autenticarse en SiteStore. Corrige cualquier error informado antes de guardar.
5. Haga clic en **Guardar**. Dispel guarda la integración y ejecuta de inmediato la sincronización inicial para descubrir tus sensores.

{% hint style="info" %}
**Sus credenciales están cifradas.** El secreto de la clave API se cifra en reposo y nunca se vuelve a mostrar después de guardar. Al editar más tarde, deja en blanco los campos de credenciales para conservar los valores almacenados.
{% endhint %}

## Asignación de sensores a Wickets

Una vez finalizada la sincronización inicial, abra la integración para encontrar la **Asignación de sitios** sección. Cada sensor de Dragos aparece como un sitio, y aquí es donde decides qué sensores se convierten en dispositivos de Dispel y dónde se ubican.

> 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.

Para cada sensor que quieras importar:

1. Elija una **Instalación**.
2. Elija una **Wicket**. Si la instalación tiene solo un Wicket, Dispel lo selecciona por usted.
3. Haga clic en **Guardar asignaciones e importar**.

Dispel procesa cada sensor asignado — verás cómo el progreso por sitio pasa de en espera, a obteniendo, a sincronizando, hasta completado — y luego informa cuántos dispositivos se importaron (por ejemplo, **"12 dispositivos importados"** o un desglose de dispositivos nuevos frente a ya importados). Los dispositivos importados aparecen en el Wicket asignado junto con los dispositivos que haya agregado manualmente.

## Mantener su inventario actualizado

* Dispel **vuelve a sincronizar automáticamente** según un horario recurrente, de modo que los activos descubiertos recientemente y los detalles modificados se recogen sin que tengas que hacer nada.
* Para obtener el inventario más reciente de inmediato, abra la integración y elija **Actualizar**.
* Para cambiar los detalles de conexión o rotar las credenciales, edite la integración y use **Guardar y sincronizar**. Deja los campos de credenciales en blanco para conservar el secreto actual.

## Hallazgos de vulnerabilidades

Dragos informa de las vulnerabilidades conocidas de los activos que supervisa. Después de cada sincronización exitosa, Dispel extrae los hallazgos de vulnerabilidades de tus dispositivos importados — cubriendo tanto problemas de hardware/firmware como de software/SO — y los adjunta a esos dispositivos, para que puedas ver los problemas conocidos de un dispositivo sin salir de Dispel. Los hallazgos se actualizan en cada sincronización, y los hallazgos resueltos desaparecen automáticamente.

## Estado de 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 y descubriendo sensores.                          |
| **Listo**                  | Conectado y sincronizado; se aplican las asignaciones.                                 |
| **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 tus asignaciones guardadas.                               |
| **Fallido**                | La última operación falló; consulte la guía del error.                                 |

Una **insignia de estado** (Conectado, Degradado, Inalcanzable) refleja si Dispel puede acceder actualmente a la API de Dragos.

## Solución de problemas

Si una sincronización o una 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 ID/secreto de la clave API fue rechazado. Es posible que la clave haya sido rotada, haya caducado o haya sido revocada — aprovisiona una nueva y actualiza la integración. |
| **Endpoint inalcanzable**          | Dispel no pudo acceder a SiteStore. Verifica la URL de SiteStore y que la IP de Dispel esté en la lista de permitidos de tu firewall.                                         |
| **Se agotó el tiempo de conexión** | SiteStore tardó demasiado en responder — a menudo por latencia de red o una regla del firewall.                                                                               |
| **Límite de tasa**                 | Dragos limitó las solicitudes. La próxima sincronización programada debería tener éxito.                                                                                      |
| **Error de configuración**         | La URL de SiteStore parece incorrecta. Vuelve a comprobar la configuración de conexión.                                                                                       |

## Preguntas frecuentes

<details>

<summary>¿Puedo conectar más de un SiteStore de Dragos?</summary>

Sí. Dragos admite varias integraciones, por lo que puedes conectar varias instancias de SiteStore en paralelo. Dale a cada una un **Nombre para mostrar** para distinguirlas.

</details>

<details>

<summary>¿Qué es un «site» en Dragos?</summary>

Dispel asigna Dragos **los sensores** a sitios. Cada sensor que supervisa tu red aparece en la lista de asignación de sitios, para que puedas enrutar activos de distintos sensores a diferentes instalaciones y Wickets.

</details>

<details>

<summary>Perdí mi secreto de clave API. ¿Qué hago?</summary>

Dragos muestra el secreto solo una vez en el momento del aprovisionamiento. Si ya no lo tienes, aprovisiona una nueva clave API en SiteStore y actualiza la integración con el nuevo ID y secreto.

</details>

<details>

<summary>¿Conectar Dragos cambia algo en SiteStore?</summary>

No. Dispel solo lee de Dragos. Nunca crea, modifica ni elimina datos del lado de Dragos.

</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/dragos.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.