> 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.
## Vue d’ensemble
L’intégration Dragos permet à Dispel de récupérer les actifs OT que la plateforme Dragos a découverts et de les importer comme appareils Dispel. Vous vous connectez à votre Dragos **SiteStore** une fois, associez chaque capteur Dragos à une installation et à un Wicket Dispel, puis Dispel importe les appareils correspondants et les maintient à jour lors d’une synchronisation récurrente.
Dragos est une **de découverte d’actifs** intégration. Dispel lit les données de Dragos — il n’écrit jamais vers la plateforme.
Dans Dragos, **les capteurs** sont les points de collecte qui surveillent votre réseau industriel. Dispel traite chaque capteur Dragos comme un **site** que vous associez à un Wicket Dispel, afin que les actifs arrivent au bon endroit par capteur.
#### Ce que Dispel importe
* Actifs découverts (nom, adresse IP, adresse MAC, marque/modèle, système d’exploitation, type d’appareil) en tant qu’appareils Dispel.
* Protocoles et ports réseau observés pour chaque actif.
* Un lien vers l’actif dans Dragos, stocké sur l’appareil.
* **Résultats de vulnérabilités** pour chaque appareil importé — couvrant à la fois les problèmes matériels/firmware et logiciels/système d’exploitation — actualisé à chaque synchronisation.
{% hint style="info" %}
**Où le trouver.** Connectez-vous en tant qu’administrateur de l’organisation et ouvrez **Paramètres → Intégrations**. Dragos apparaît dans le **section Découverte d’actifs / Visibilité réseau** section. Cliquez sur **Connecter** sur la carte Dragos pour commencer.
{% endhint %}
## Avant de commencer
Vous aurez besoin des éléments suivants de votre SiteStore Dragos :
* Un **clé API** — son **ID de clé API** (l'identifiant) et **Secret de clé API**. Provisionnez cela dans SiteStore.
* Le **URL du SiteStore** de votre déploiement — par exemple `https://customer.dragos.cloud`.
{% hint style="warning" %}
**Le secret de clé API n’est affiché qu’une seule fois.** Dragos affiche le secret une seule fois lorsque vous provisionnez la clé. Copiez-le à ce moment-là — si vous le perdez, provisionnez une nouvelle clé. Ajoutez également l’adresse IP de Dispel **IP de la liste d’autorisation** (affichée sur le formulaire de connexion) à votre liste d’autorisation de pare-feu afin que Dispel puisse atteindre SiteStore, en particulier pour les déploiements sur site.
{% endhint %}
## Connexion de Dragos
1. Accédez à **Paramètres → Intégrations** et cliquez sur **Connecter** sur la carte Dragos.
2. Vous pouvez éventuellement définir un **nom d’affichage** pour distinguer cette intégration des autres (vous pouvez connecter plus d’un SiteStore).
3. Renseignez les champs de connexion :
| Champ | Type | Notes |
| --------------------- | ------------- | --------------------------------------------------------------- |
| **URL du SiteStore** | Configuration | L’URL de base de votre instance SiteStore Dragos. |
| **ID de clé API** | Identifiant | L’identifiant de clé API de votre SiteStore Dragos. |
| **Secret de clé API** | Identifiant | Le secret associé à la clé. Stocké chiffré et jamais ré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écouvrir vos capteurs.
{% hint style="info" %}
**Vos identifiants sont chiffrés.** Le secret de clé API est chiffré au repos et n’est plus jamais affiché après l’enregistrement. Lors de la modification ultérieure, laissez les champs d’identifiants vides pour conserver les valeurs stockées.
{% endhint %}
## Association des capteurs aux Wickets
Une fois la synchronisation initiale terminée, ouvrez l’intégration pour trouver la **section Mappage des sites** section. Chaque capteur Dragos apparaît comme un site, et c’est ici que vous décidez quels capteurs deviennent des appareils Dispel et où ils sont placés.
> Associez chaque site du fournisseur à une installation Dispel et à un Wicket. Les appareils des sites mappés seront synchronisés dans Dispel.
Pour chaque capteur que vous souhaitez importer :
1. Choisissez un **site**.
2. Choisissez un **Wicket**. Si le site ne comporte qu’un seul Wicket, Dispel le sélectionne pour vous.
3. Cliquez sur **Enregistrer les mappages et importer**.
Dispel parcourt chaque capteur associé — vous verrez l’avancement par site passer d’« en attente » à « récupération », puis à « synchronisation », puis à « terminé » — puis indique combien d’appareils ont été importés (par exemple, **« 12 appareils importés »** ou une répartition entre les appareils nouveaux et déjà importés). Les appareils importés apparaissent dans le Wicket mappé aux côtés de tous les appareils que vous avez ajoutés manuellement.
## Maintenir votre inventaire à jour
* Dispel **se resynchronise automatiquement** selon un calendrier récurrent, de sorte que les nouveaux actifs découverts et les détails modifiés soient 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 actuel.
## Résultats de vulnérabilités
Dragos signale les vulnérabilités connues des actifs qu’il surveille. Après chaque synchronisation réussie, Dispel récupère les résultats de vulnérabilité pour vos appareils importés — couvrant à la fois les problèmes matériels/firmware et logiciels/système d’exploitation — et les associe à ces appareils, afin que vous puissiez voir les problèmes connus d’un appareil sans quitter Dispel. Les résultats sont actualisés à chaque synchronisation, et les résultats résolus disparaissent automatiquement.
## État de la connexion
Chaque intégration affiche un état afin que vous sachiez toujours où elle en est :
| État | 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 et découverte des capteurs. |
| **Prêt** | Connecté et synchronisé ; les associations sont appliquées. |
| **Doit être actualisé** | 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 vos associations enregistrées. |
| **Échec** | La dernière opération a échoué — consultez les indications d’erreur. |
Un **badge d’état** (Connecté, Dégradé, Injoignable) indique si Dispel peut actuellement atteindre l’API Dragos.
## Dépannage
Si une synchronisation ou un test de connexion échoue, Dispel classe l’erreur et suggère une solution :
| Erreur | Ce que cela signifie généralement et comment le corriger |
| ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Échec de l’authentification** | L’ID/le secret de clé API a été rejeté. La clé a peut-être été renouvelée, expirée ou révoquée — provisionnez-en une nouvelle et mettez à jour l’intégration. |
| **Point de terminaison inaccessible** | Dispel n’a pas pu atteindre SiteStore. Vérifiez l’URL de SiteStore et que l’IP de Dispel figure sur la liste autorisée de votre pare-feu. |
| **Délai de connexion dépassé** | SiteStore a mis trop de temps à répondre — souvent à cause d’une latence réseau ou d’une règle de pare-feu. |
| **Limitation de 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. |
## Foire aux questions
Puis-je connecter plus d’un SiteStore Dragos ?
Oui. Dragos prend en charge plusieurs intégrations, vous pouvez donc connecter plusieurs instances de SiteStore côte à côte. Donnez à chacune un **nom d’affichage** nom distinct pour les distinguer.
Qu’est-ce qu’un « site » pour Dragos ?
Dispel associe les **les capteurs** Dragos aux sites. Chaque capteur qui surveille votre réseau apparaît dans la liste de mappage des sites, afin que vous puissiez acheminer les actifs de différents capteurs vers différentes installations et Wickets.
J’ai perdu mon secret de clé API. Que dois-je faire ?
Dragos n’affiche le secret qu’une seule fois, lors du provisionnement. Si vous ne l’avez plus, provisionnez une nouvelle clé API dans SiteStore et mettez à jour l’intégration avec le nouvel identifiant et le nouveau secret.
Le fait de connecter Dragos modifie-t-il quelque chose dans SiteStore ?
Non. Dispel ne fait que lire depuis Dragos. Il ne crée, ne modifie ni ne supprime jamais de données côté Dragos.
---
# 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=&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.