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

# Dragos

Connectez la plateforme Dragos (SiteStore) pour importer les actifs OT détectés dans Dispel, associer les capteurs Dragos aux Wickets et synchroniser les données des appareils et les vulnérabilités détectées.

## Présentation

L’intégration Dragos permet à Dispel de récupérer les ressources OT découvertes par la plateforme Dragos et de les importer comme appareils Dispel. Vous vous connectez une fois à votre **SiteStore** Dragos, associez chaque capteur Dragos à un site et à un Wicket Dispel, et Dispel importe les appareils correspondants et les actualise régulièrement lors des synchronisations.

Dragos est une intégration de **découverte des ressources** . Dispel lit les données de Dragos : la plateforme n’est jamais modifiée.

Dans Dragos, les **capteurs** sont les points de collecte qui surveillent votre réseau industriel. Dispel considère chaque capteur Dragos comme un **site** que vous associez à un Wicket Dispel, afin que les ressources soient rattachées au bon emplacement selon le capteur.

#### Données importées par Dispel

* Les actifs découverts (nom, adresse IP, adresse MAC, fabricant/modèle, système d’exploitation, type d’appareil) sous forme d’appareils Dispel.
* Les protocoles et ports réseau observés pour chaque actif.
* Un lien vers la ressource dans Dragos, enregistré sur l’appareil.
* **Résultats de détection des vulnérabilités** pour chaque appareil importé — couvrant les problèmes matériels/firmware et logiciels/systèmes d’exploitation — actualisés à chaque synchronisation.

{% hint style="info" %}
**Où la trouver.** Connectez-vous en tant qu’administrateur de l’organisation et ouvrez **Settings → Integrations**. Dragos apparaît dans la section **Asset Discovery / Network Visibility** . Cliquez sur **Connect** sur la carte Dragos pour commencer.
{% endhint %}

## Avant de commencer

Vous aurez besoin des éléments suivants de votre Dragos SiteStore :

* Une **clé API** — son **identifiant de clé API** (l’identifiant) et son **secret de clé API**. Créez-la dans SiteStore.
* L’ **URL SiteStore** de votre déploiement — par exemple `https://customer.dragos.cloud`.

{% hint style="warning" %}
**Le secret de la clé API n’est affiché qu’une seule fois.** Dragos n’affiche le secret qu’une seule fois, lors de la création de la clé. Copiez-le à ce moment-là : si vous le perdez, créez une nouvelle clé. Ajoutez également l’ **IP à autoriser** de Dispel (indiquée dans le formulaire de connexion) à la liste d’autorisation de votre pare-feu pour que Dispel puisse accéder à SiteStore, en particulier pour les déploiements sur site.
{% endhint %}

## Connexion à Dragos

1. Accédez à **Settings → Integrations** et cliquez sur **Connect** sur la carte Dragos.
2. Vous pouvez, si vous le souhaitez, définir un **nom d’affichage** pour distinguer cette intégration des autres (vous pouvez connecter plusieurs SiteStore).
3. Renseignez les champs de connexion :

| Champ                      | Type          | Remarques                                                                                     |
| -------------------------- | ------------- | --------------------------------------------------------------------------------------------- |
| **URL SiteStore**          | Configuration | L’URL de base de votre instance Dragos SiteStore.                                             |
| **Identifiant de clé API** | Identifiant   | L’identifiant de la clé API de votre Dragos SiteStore.                                        |
| **Secret de la clé API**   | Identifiant   | Le secret associé à la clé. Il est stocké sous forme chiffrée et ne sera plus jamais affiché. |

4. Cliquez sur **Tester la connexion** pour confirmer que Dispel peut s’authentifier auprès de SiteStore. Corrigez toute erreur signalée avant d’enregistrer.
5. Cliquez sur **Enregistrer**. Dispel enregistre l’intégration et lance immédiatement la synchronisation initiale pour détecter vos capteurs.

{% hint style="info" %}
**Vos identifiants sont chiffrés.** Le secret de la clé API est chiffré au repos et n’est plus affiché après son enregistrement. Pour conserver les valeurs enregistrées lors d’une modification ultérieure, laissez les champs d’identifiants vides.
{% endhint %}

## Associer les capteurs aux Wickets

Une fois la synchronisation initiale terminée, ouvrez l’intégration pour trouver la section **Mappage des sites** . Chaque capteur Dragos apparaît comme un site. C’est ici que vous choisissez les capteurs qui deviendront des appareils Dispel et où ils seront associés.

> Associez chaque site du fournisseur à un établissement et à un wicket Dispel. Les appareils des sites associés seront synchronisés avec Dispel.

Pour chaque capteur que vous souhaitez importer :

1. Sélectionnez un **Établissement**.
2. Sélectionnez un **Wicket**. Si l’établissement ne possède qu’un seul wicket, Dispel le sélectionne automatiquement.
3. Cliquez sur **Enregistrer les associations et importer**.

Dispel traite chaque capteur associé — vous verrez la progression de chaque site passer de « en attente » à « récupération », puis à « synchronisation » et enfin à « terminé » — et indique ensuite le nombre d’appareils importés (par exemple, **« 12 appareils importés »** ou une ventilation entre les appareils nouveaux et ceux déjà importés). Les appareils importés apparaissent dans le Wicket associé, aux côtés de ceux que vous avez ajoutés manuellement.

## Maintenir votre inventaire à jour

* Dispel **se resynchronise automatiquement** selon une périodicité définie. Les nouveaux actifs découverts et les informations modifiées sont ainsi pris en compte sans intervention de votre part.
* Pour récupérer immédiatement le dernier inventaire, ouvrez l’intégration et sélectionnez **Actualiser**.
* Pour modifier les détails de connexion ou renouveler les identifiants, modifiez l’intégration et cliquez sur **Enregistrer et synchroniser**. Laissez les champs d’identifiants vides pour conserver le secret actuel.

## Vulnérabilités détectées

Dragos signale les vulnérabilités connues des ressources qu’il surveille. Après chaque synchronisation réussie, Dispel récupère les résultats liés aux vulnérabilités de vos appareils importés — concernant le matériel et le micrologiciel, ainsi que les logiciels et les systèmes d’exploitation — et les associe à ces appareils. Vous pouvez ainsi consulter les problèmes connus d’un appareil sans quitter Dispel. Les résultats sont actualisés à chaque synchronisation et les vulnérabilités résolues sont automatiquement supprimées.

## État de la connexion

Chaque intégration affiche un état pour que vous sachiez toujours où elle en est :

| État                         | Signification                                                                                       |
| ---------------------------- | --------------------------------------------------------------------------------------------------- |
| **Non initialisée**          | Enregistrée, mais la première synchronisation n’a pas encore été lancée.                            |
| **Initialisation**           | Lancer la première synchronisation et détecter les capteurs.                                        |
| **Prête**                    | Connecté et synchronisé ; les mappages sont appliqués.                                              |
| **Actualisation nécessaire** | 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 du mappage sont enregistrées, mais pas encore appliquées.                         |
| **Application en cours**     | Importation des appareils correspondant à vos mappages enregistrés.                                 |
| **Échec**                    | La dernière opération a échoué — consultez les conseils de résolution des erreurs.                  |

Un badge d’état distinct, **d’état** (Connecté, Dégradé, Injoignable), indique si Dispel peut actuellement accéder à l’API Dragos.

## Dépannage

Si une synchronisation ou un test de connexion échoue, Dispel classe l’erreur et suggère une solution :

| Erreur                                | Signification habituelle et solution                                                                                                                                 |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Échec de l’authentification**       | L’ID ou le secret de la clé API a été refusé. La clé a peut-être été renouvelée, a expiré ou a été révoquée. Générez-en une nouvelle et mettez à jour l’intégration. |
| **Point de terminaison inaccessible** | Dispel n’a pas pu joindre SiteStore. Vérifiez l’URL de SiteStore et assurez-vous que l’adresse IP de Dispel figure dans la liste d’autorisation de votre pare-feu.   |
| **Délai de connexion dépassé**        | SiteStore a mis trop de temps à répondre — cela est souvent dû à la latence du réseau ou à une règle de pare-feu.                                                    |
| **Limitation du débit**               | Dragos a limité le débit des requêtes. La prochaine synchronisation planifiée devrait réussir.                                                                       |
| **Erreur de configuration**           | L’URL de SiteStore semble incorrecte. Vérifiez à nouveau les paramètres de connexion.                                                                                |

## Questions fréquentes

<details>

<summary>Puis-je connecter plusieurs instances de Dragos SiteStore ?</summary>

Oui. Dragos prend en charge plusieurs intégrations : vous pouvez donc connecter plusieurs instances de SiteStore en parallèle. Attribuez à chacune un **Nom d’affichage** distinct pour les différencier.

</details>

<details>

<summary>Qu’est-ce qu’un « site » dans Dragos ?</summary>

Dispel associe les **capteurs** Dragos à des sites. Chaque capteur qui surveille votre réseau apparaît dans la liste Mappage des sites, ce qui vous permet d’acheminer les ressources de différents capteurs vers différents sites et Wickets.

</details>

<details>

<summary>J’ai perdu le secret de ma clé API. Que dois-je faire ?</summary>

Dragos n’affiche le secret qu’une seule fois, lors de sa création. Si vous ne l’avez plus, créez une nouvelle clé API dans SiteStore, puis mettez à jour l’intégration avec le nouvel ID et le nouveau secret.

</details>

<details>

<summary>La connexion à Dragos modifie-t-elle quoi que ce soit dans SiteStore ?</summary>

Non. Dispel ne fait que lire les données de Dragos. Il ne crée, ne modifie ni ne supprime jamais de données du côté 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-fr/integrer-et-administrer/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.
