> 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-fr/integrer-et-administrer/integrations/asset-discovery/darktrace.md).
# Darktrace
Connectez Darktrace, via l’API du portail de sécurité ActiveAI, pour importer dans Dispel les dispositifs découverts — enrichis d’alertes de modèle comportemental et d’un lien direct vers Threat Visualizer — mappés à un Wick
## Aperçu
L'intégration Darktrace permet à Dispel de récupérer les appareils que l'IA auto-apprenante de Darktrace a découverts sur votre réseau et de les intégrer en tant qu'appareils Dispel, enrichis des détections comportementales de Darktrace. Vous vous connectez une fois à votre instance Darktrace, l'associez à un site Dispel et à un Wicket, puis Dispel importe les appareils correspondants et les maintient à jour lors d'une synchronisation récurrente.
Darktrace est une intégration de découverte d'actifs cloud. Dispel s'authentifie auprès du portail de sécurité ActiveAI et lit les données via l'API cloud de Darktrace, en lecture seule. Vous indiquez à Dispel votre URL maître Darktrace ; Dispel en déduit le nom de votre instance et accède à l'API via le proxy cloud de Darktrace.
Comme un master Darktrace représente un seul environnement, Dispel le traite comme un seul site que vous associez à un seul Wicket — il n'y a pas de liste par site à parcourir.
#### Ce que Dispel importe
* Appareils que Darktrace a découverts, associés à vos appareils Dispel existants par adresse IP et adresse MAC, et importés comme nouveaux appareils lorsqu'il n'y a pas de correspondance.
* Alertes de modèle Darktrace (ses détections comportementales) sous forme de constats sur les appareils correspondants, avec une gravité dérivée de la catégorie du modèle.
* Une vue détaillée de l'appareil : un badge « Enrichi par Darktrace », un lien profond vers l'appareil dans Darktrace Threat Visualizer, et un panneau Darktrace affichant l'état d'Autonomous Response (Antigena), les informations de l'appareil, la connectivité et un score de risque comportemental.
{% hint style="info" %}
**Où le trouver.** Connectez-vous en tant qu’administrateur de l’organisation et ouvrez **Paramètres → Intégrations**. Darktrace apparaît dans le **Découverte des actifs / Visibilité réseau** section. Cliquez sur **Connecter** sur la carte Darktrace pour commencer.
{% endhint %}
## Avant de commencer
Vous aurez besoin des éléments suivants de Darktrace :
* Une application cliente créée dans le portail de sécurité ActiveAI, sous **Gérer les applications clientes**. Sa création vous donne un **ID client** et un **Secret client**.
* Le **URL maître Darktrace** de votre instance — par exemple `https://usw1-00000-01.cloud.darktrace.com`.
{% hint style="warning" %}
**Utilisez les identifiants de l'application cliente ActiveAI — pas les jetons hérités.** Le cloud de Darktrace nécessite les identifiants de l'application cliente du portail de sécurité ActiveAI (OAuth2). L'ancien couple jeton/secret de l'API Threat Visualizer ne permettra pas l'authentification.
{% endhint %}
{% hint style="info" %}
**Le secret client n'est affiché qu'une seule fois.** Darktrace n'affiche le secret qu'à la création de l'application cliente. Copiez-le à ce moment-là ; si vous le perdez, créez une nouvelle application cliente.
{% endhint %}
## Connexion à Darktrace
1. Accédez à **Paramètres → Intégrations** et cliquez sur **Connecter** sur la carte Darktrace.
2. Vous pouvez éventuellement définir un **Nom d’affichage** pour distinguer cette intégration des autres (vous pouvez connecter plusieurs instances).
3. Renseignez les champs de connexion :
| Champ | Type | Notes |
| ------------------------ | ------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **URL maître Darktrace** | Configuration | Votre URL maître Darktrace, par exemple `https://your-instance.cloud.darktrace.com`. Dispel en déduit le nom de l'instance. |
| **ID client** | Identifiant | L'ID client d'une application cliente créée dans le portail de sécurité ActiveAI. |
| **Secret client** | Identifiant | Le secret client affiché une seule fois lors de la création de l'application cliente. Stocké chiffré et jamais réaffiché. |
4. Cliquez sur **Tester la connexion** pour confirmer que Dispel peut s'authentifier. Corrigez toute erreur signalée avant d'enregistrer.
5. Cliquez sur **Enregistrer**. Dispel enregistre l’intégration et lance immédiatement la synchronisation initiale.
{% hint style="info" %}
**Comment fonctionne la connexion.** Dispel échange votre ID client et votre secret client contre un jeton de courte durée auprès du serveur d'autorisation ActiveAI et appelle l'API Darktrace via le `api.darktrace.com` proxy cloud, en utilisant l'instance dérivée de votre URL maître. Les jetons sont actualisés automatiquement.
{% endhint %}
{% hint style="info" %}
**Vos identifiants sont chiffrés.** Le secret client est chiffré au repos et n'est plus jamais affiché après l'enregistrement. Lors d'une modification ultérieure, laissez les champs d'identifiants vides pour conserver les valeurs stockées.
{% endhint %}
## Association de l'instance à un Wicket
Une fois la synchronisation initiale terminée, ouvrez l’intégration pour trouver la **section Mappage du site** section. Darktrace apparaît comme un seul site représentant votre instance.
> Associez chaque site fournisseur à une installation Dispel et à un Wicket. Les appareils des sites associés seront synchronisés dans Dispel.
1. Choisissez un **Site**.
2. Choisissez un **guichet**. Si l’installation n’a qu’un seul Wicket, Dispel le sélectionne pour vous.
3. Cliquez sur **Enregistrer le mappage et importer**.
Dispel importe les appareils de Darktrace dans le Wicket associé — vous verrez la progression passer d'en attente, à récupération, à synchronisation, puis à terminé — puis indique combien d'appareils ont été importés. Les appareils importés apparaissent dans le Wicket associé aux côtés des appareils que vous avez ajoutés manuellement, avec leur enrichissement Darktrace et leurs Model Alerts associés.
## Maintenir votre inventaire à jour
* Dispel se resynchronise automatiquement selon un calendrier récurrent, de sorte que les appareils nouvellement découverts, les détails modifiés et les nouveaux Model Alerts sont pris en compte sans aucune action de votre part.
* Pour récupérer immédiatement le dernier inventaire, ouvrez l’intégration et choisissez **Actualiser**.
* Pour modifier les détails de connexion ou renouveler les identifiants, modifiez l'intégration et utilisez **Enregistrer et synchroniser**. Laissez les champs d'identifiants vides pour conserver le secret client actuel.
Les constats Model Alert sont actualisés à chaque synchronisation, et les alertes que Darktrace ne signale plus disparaissent automatiquement.
## État de la connexion
Chaque intégration affiche un état afin que vous sachiez toujours où elle en est :
| Statut | Signification |
| ------------------------------- | --------------------------------------------------------------------------------------------------- |
| **Non initialisé** | Enregistré, mais la première synchronisation n’a pas encore été exécutée. |
| **Initialisation** | Exécution de la première synchronisation. |
| **Prêt** | Connecté et synchronisé ; le mappage est appliqué. |
| **Nécessite une actualisation** | De nouvelles données du fournisseur sont disponibles ; lancez une actualisation pour les récupérer. |
| **Actualisation en cours** | Une synchronisation est en cours. |
| **Modifications en attente** | Les modifications de mappage sont enregistrées mais pas encore appliquées. |
| **Application en cours** | Importation des appareils pour le mappage enregistré. |
| **Échec** | La dernière opération a échoué — consultez les recommandations relatives à l’erreur. |
Un **badge d’état** (Connecté, Dégradé, Injoignable) reflète si Dispel peut actuellement atteindre l'API Darktrace.
## Dépannage
Si une synchronisation ou un test de connexion échoue, Dispel classe l’erreur et suggère une correction :
| Erreur | Ce que cela signifie généralement et comment le corriger |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Échec de l’authentification** | L'ID client ou le secret client a été rejeté. Confirmez que l'application cliente est active dans le portail de sécurité ActiveAI et que le secret est à jour — il n'est affiché qu'une seule fois, donc recréez l'application s'il a été perdu. |
| **Point de terminaison inaccessible** | Dispel n'a pas pu joindre Darktrace. Vérifiez que l'URL maître Darktrace est correcte. |
| **Délai de connexion dépassé** | Darktrace a mis trop de temps à répondre — généralement un problème réseau transitoire ; réessayez. |
| **Erreur de configuration** | L'URL maître semble incorrecte. Elle doit être l'URL maître cloud de votre instance Darktrace (par exemple `https://your-instance.cloud.darktrace.com`); Dispel en déduit le nom de l'instance. |
## Questions fréquentes
Quels identifiants dois-je utiliser — ActiveAI ou les jetons API hérités ?
Utilisez les identifiants de l'application cliente du portail de sécurité ActiveAI (un ID client et un secret client créés sous **Gérer les applications clientes**). Le cloud de Darktrace nécessite le flux OAuth2 de type client\_credentials ; l'ancien couple jeton/secret de l'API Threat Visualizer ne permettra pas l'authentification.
Qu'est-ce que l'« URL maître » ?
C'est l'URL de votre instance maître Darktrace, par exemple `https://usw1-00000-01.cloud.darktrace.com`. Dispel en déduit le nom de votre instance et relaie les requêtes API via `api.darktrace.com`, vous n'avez donc qu'à fournir l'URL maître.
Quels constats Darktrace apporte-t-il dans Dispel ?
Les Model Alerts de Darktrace — ses détections comportementales — rattachées aux appareils correspondants sous forme de constats, avec une gravité dérivée de la catégorie du modèle. Il s'agit de détections comportementales et non de vulnérabilités basées sur des CVE.
Dispel déclenche-t-il ou modifie-t-il Autonomous Response (Antigena) ?
Non. L'intégration est en lecture seule. Dispel affiche l'état d'Antigena dans le cadre de l'enrichissement de l'appareil, mais ne déclenche, ne modifie ni n'efface jamais les actions Autonomous Response dans Darktrace.
Puis-je connecter plusieurs instances Darktrace ?
Oui. Darktrace prend en charge plusieurs intégrations, vous pouvez donc connecter plusieurs instances côte à côte. Donnez à chacune un **Nom d’affichage** pour les distinguer.
---
# 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-fr/integrer-et-administrer/integrations/asset-discovery/darktrace.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.