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

# Darktrace

Conecta Darktrace, a través de la API de ActiveAI Security Portal, para extraer dispositivos descubiertos a Dispel — enriquecidos con Model Alerts de comportamiento y un enlace profundo al Threat Visualizer — asignados a un Wick

## Descripción general

La integración de Darktrace permite a Dispel extraer los dispositivos que la IA de autoaprendizaje de Darktrace ha հայտն discovered in your network and bring them in as Dispel devices, enriched with Darktrace's behavioural detections. You connect to your Darktrace instance once, map it to a Dispel facility and Wicket, and Dispel imports the matching devices and keeps them current on a recurring sync.

Darktrace es una integración de descubrimiento de activos en la nube. Dispel se autentica en el ActiveAI Security Portal y lee a través de la API en la nube de Darktrace, y solo lee de ella. Indicas a Dispel la URL maestra de tu Darktrace; Dispel deriva de ella el nombre de tu instancia y llega a la API a través del proxy en la nube de Darktrace.

Como un maestro de Darktrace representa un único entorno, Dispel lo trata como un solo sitio que asignas a un único Wicket; no hay una lista por sitio que recorrer.

#### Qué importa Dispel

* Dispositivos que Darktrace ha descubierto, vinculados con tus dispositivos existentes de Dispel por dirección IP y MAC e importados como nuevos dispositivos cuando no hay coincidencia.
* Alertas de modelo de Darktrace (sus detecciones conductuales) como hallazgos en los dispositivos coincidentes, con la gravedad derivada de la categoría del modelo.
* Una vista enriquecida del dispositivo: una insignia de "Enriquecido por Darktrace", un enlace profundo al dispositivo en Darktrace Threat Visualizer y un panel de Darktrace que muestra el estado de Autonomous Response (Antigena), la inteligencia del dispositivo, la conectividad y una puntuación de riesgo conductual.

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

## Antes de comenzar

Necesitarás lo siguiente de Darktrace:

* Una aplicación cliente creada en el ActiveAI Security Portal, en **Administrar aplicaciones cliente**. Al crearla, obtienes un **ID de cliente** y un **Secreto de cliente**.
* La **URL maestra de Darktrace** de tu instancia — por ejemplo `https://usw1-00000-01.cloud.darktrace.com`.

{% hint style="warning" %}
**Usa credenciales de la aplicación cliente de ActiveAI, no tokens heredados.** La nube de Darktrace requiere credenciales de aplicación cliente (OAuth2) del ActiveAI Security Portal. El antiguo par token/secreto de Threat Visualizer no se autentificará.
{% endhint %}

{% hint style="info" %}
**El secreto del cliente se muestra una sola vez.** Darktrace muestra el secreto solo cuando se crea la aplicación cliente. Cópialo en ese momento; si lo pierdes, crea una nueva aplicación cliente.
{% endhint %}

## Conectando Darktrace

1. Vaya a **Configuración → Integraciones** y haga clic en **Conectar** en la tarjeta de Darktrace.
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 maestra de Darktrace** | Configuración | La URL maestra de tu Darktrace, por ejemplo `https://your-instance.cloud.darktrace.com`. Dispel deriva de ella el nombre de la instancia. |
| **ID de cliente**            | Credencial    | El ID de cliente de una aplicación cliente creada en el ActiveAI Security Portal.                                                         |
| **Secreto de cliente**       | Credencial    | El secreto del cliente se muestra una sola vez cuando se crea la aplicación cliente. Se almacena cifrado y nunca se vuelve a mostrar.     |

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" %}
**Cómo funciona la conexión.** Dispel intercambia tu ID de cliente y secreto de cliente por un token de corta duración en el servidor de autorización de ActiveAI y llama a la API de Darktrace a través de `api.darktrace.com` proxy en la nube, usando la instancia derivada de tu URL maestra. Los tokens se actualizan automáticamente.
{% endhint %}

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

## Asignación de la instancia a un Wicket

Una vez que finalice la sincronización inicial, abra la integración para encontrar la **Asignación de sitios** sección. Darktrace aparece como un único sitio que representa tu instancia.

> 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 Darktrace al Wicket asignado — verás cómo el progreso pasa de en espera, a obteniendo, a sincronizando, a completado — 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 su enriquecimiento de Darktrace y las Alertas de modelo adjuntas.

## Manteniendo su inventario actualizado

* Dispel resincroniza automáticamente según un calendario recurrente, de modo que los dispositivos descubiertos recientemente, los detalles cambiados y las nuevas Alertas de modelo se incorporan sin ninguna acción por 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 credenciales, edite la integración y use **Guardar y sincronizar**. Deja los campos de credenciales en blanco para conservar el secreto del cliente actual.

Los hallazgos de Alertas de modelo se actualizan en cada sincronización, y las alertas que Darktrace ya no informa desaparecen 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 Darktrace.

## 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**     | Se rechazó el ID de cliente o el secreto del cliente. Confirma que la aplicación cliente está activa en el ActiveAI Security Portal y que el secreto es el actual — se muestra solo una vez, así que vuelve a crear la aplicación si se perdió. |
| **Punto final inaccesible**    | Dispel no pudo الوصول a Darktrace. Verifica que la URL maestra de Darktrace sea correcta.                                                                                                                                                       |
| **Tiempo de conexión agotado** | Darktrace tardó demasiado en responder — normalmente un problema de red transitorio; inténtalo de nuevo.                                                                                                                                        |
| **Error de configuración**     | La URL maestra parece incorrecta. Debe ser la URL maestra de la nube de Darktrace (por ejemplo `https://your-instance.cloud.darktrace.com`); Dispel deriva de ella el nombre de la instancia.                                                   |

## Preguntas frecuentes

<details>

<summary>¿Qué credenciales uso: ActiveAI o los tokens API heredados?</summary>

Usa credenciales de aplicación cliente del ActiveAI Security Portal (un ID de cliente y un secreto de cliente creados en **Administrar aplicaciones cliente**). La nube de Darktrace requiere el flujo de credenciales de cliente OAuth2; el antiguo par token/secreto de Threat Visualizer no se autentificará.

</details>

<details>

<summary>¿Qué es la "URL maestra"?</summary>

Es la URL de tu instancia maestra de Darktrace, por ejemplo `https://usw1-00000-01.cloud.darktrace.com`. Dispel deriva de ella el nombre de tu instancia y proxy las solicitudes de API a través de `api.darktrace.com`, por lo que solo necesitas proporcionar la URL maestra.

</details>

<details>

<summary>¿Qué hallazgos incorpora Darktrace a Dispel?</summary>

Las Alertas de modelo de Darktrace — sus detecciones conductuales — adjuntas a los dispositivos coincidentes como hallazgos, con la gravedad derivada de la categoría del modelo. Se trata de detecciones conductuales, no de vulnerabilidades basadas en CVE.

</details>

<details>

<summary>¿Dispel activa o cambia Autonomous Response (Antigena)?</summary>

No. La integración es de solo lectura. Dispel muestra el estado de Antigena como parte del enriquecimiento del dispositivo, pero nunca activa, modifica ni borra acciones de Autonomous Response en Darktrace.

</details>

<details>

<summary>¿Puedo conectar más de una instancia de Darktrace?</summary>

Sí. Darktrace admite varias integraciones, por lo que puedes conectar varias instancias una al lado de la otra. Dale a cada una una distinta **Nombre para mostrar** para distinguirlos.

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