> 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/claroty-xdome.md).
# Claroty xDome
Connectez Claroty xDome, via son API cloud, pour importer dans Dispel les dispositifs OT, IoT et IIoT découverts — enrichis des résultats de vulnérabilité — mappés à un Wicket.
## Aperçu
L’intégration Claroty xDome permet à Dispel d’extraire les actifs OT, IoT et IIoT que xDome a découverts et de les importer en tant qu’appareils Dispel, enrichis des résultats de vulnérabilités de xDome. Vous vous connectez une seule fois à votre locataire xDome, vous l’associez à une installation Dispel et à un Wicket, puis Dispel importe les appareils correspondants et les maintient à jour lors d’une synchronisation récurrente.
Claroty xDome est une intégration de découverte d’actifs dans le cloud. Dispel s’authentifie auprès de l’API xDome à l’aide d’un jeton API et ne fait que lire les données. Comme un locataire xDome 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 de sites distincts à parcourir.
#### Ce que Dispel importe
* Appareils découverts par xDome, associés à vos appareils Dispel existants et importés comme de nouveaux appareils lorsqu’il n’y a pas de correspondance.
* Les résultats de vulnérabilités de xDome (basés sur les CVE, avec des scores CVSS v3) comme résultats sur les appareils correspondants, afin que vous puissiez voir les problèmes connus d’un appareil sans quitter Dispel.
{% hint style="info" %}
**Où le trouver.** Connectez-vous en tant qu’administrateur de l’organisation et ouvrez [**Paramètres → Intégrations**](https://app.dispel.com/settings/integrations). Claroty xDome apparaît dans le **Découverte des actifs / Visibilité réseau** section. Cliquez sur **Connecter** sur la carte Claroty xDome pour commencer.
{% endhint %}
## Avant de commencer
Vous aurez besoin des éléments suivants de xDome :
* Une **Jeton API**. Dans xDome, accédez à **Paramètres → Paramètres d’administration → Gestion des utilisateurs**, créez un utilisateur API, puis générez-lui un jeton.
* Votre hôte API xDome spécifique à la région **Hôte API xDome** — par exemple `https://api.claroty.com` ou `https://eu.api.claroty.com`.
{% hint style="warning" %}
**Le jeton API n’est affiché qu’une seule fois.** xDome n’affiche le jeton qu’au moment où vous le générez. Copiez-le alors ; si vous le perdez, générez-en un nouveau.
{% endhint %}
{% hint style="info" %}
**Les permissions du jeton déterminent ce que Dispel voit.** Dispel importe les actifs que l’utilisateur API est autorisé à lire, alors accordez à l’utilisateur API l’accès aux sites dont vous souhaitez voir les appareils dans Dispel.
{% endhint %}
## Connexion à Claroty xDome
1. Accédez à [**Paramètres → Intégrations**](https://app.dispel.com/settings/integrations) et cliquez sur **Connecter** sur la carte Claroty xDome.
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 de l’API** | Configuration | Votre hôte API xDome spécifique à la région, par exemple `https://api.claroty.com` ou `https://eu.api.claroty.com`. |
| **Jeton API** | Identifiant | Le jeton généré pour un utilisateur API dans xDome. Stocké chiffré et jamais réaffiché. |
| **Inclure les appareils retirés** | Configuration | Facultatif. Lorsqu’elle est activée, Dispel importe également les appareils que xDome a marqués comme retirés. Désactivée par défaut. |
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" %}
**Vos identifiants sont chiffrés.** Le jeton API est chiffré au repos et n’est jamais réaffiché après l’enregistrement. Lors de la modification ultérieure, laissez le champ du jeton vide pour conserver la valeur stockée.
{% endhint %}
## Mappage du locataire vers un Wicket
Une fois la synchronisation initiale terminée, ouvrez l’intégration pour trouver la **section Mappage du site** section. Claroty xDome apparaît comme un seul site représentant votre locataire.
> 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 xDome dans le Wicket associé, 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 les résultats de vulnérabilités xDome attaché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 résultats 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 faire pivoter le jeton, modifiez l’intégration et utilisez **Enregistrer et synchroniser**. Laissez le champ du jeton vide pour conserver le jeton actuel.
Les résultats de vulnérabilités sont actualisés à chaque synchronisation, et les résultats que xDome 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) indique si Dispel peut actuellement joindre l’API xDome.
## 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** | Le jeton API a été refusé. Confirmez que l’utilisateur API est actif dans xDome et que le jeton est actuel — il n’est affiché qu’une seule fois, donc générez-en un nouveau s’il a été perdu. |
| **Point de terminaison inaccessible** | Dispel n’a pas pu joindre xDome. Vérifiez que l’URL de l’API est votre hôte correct spécifique à la région (par exemple `https://api.claroty.com` ou `https://eu.api.claroty.com`). |
| **Délai de connexion dépassé** | xDome a mis trop de temps à répondre — généralement un problème réseau transitoire ; réessayez. |
## Questions fréquentes
Où dois-je créer le jeton API ?
Dans xDome, accédez à **Paramètres → Paramètres d’administration → Gestion des utilisateurs**, créez un utilisateur API et générez-lui un jeton. Le jeton n’est affiché qu’une seule fois, alors copiez-le avant de quitter la page.
Quelle URL d’API dois-je utiliser ?
Votre hôte API xDome spécifique à la région, par exemple `https://api.claroty.com` ou `https://eu.api.claroty.com`. Utilisez l’hôte correspondant à la région dans laquelle votre locataire xDome s’exécute.
Quels résultats Claroty xDome importe-t-il dans Dispel ?
Les résultats de vulnérabilités de xDome — basés sur les CVE, avec des scores CVSS v3 — associés aux appareils correspondants. Les résultats sont actualisés à chaque synchronisation, et ceux que xDome ne signale plus disparaissent automatiquement.
Est-ce que Dispel modifie quoi que ce soit dans xDome ?
Non. L’intégration est en lecture seule. Dispel extrait l’inventaire et les résultats, mais ne crée, ne modifie ni ne supprime jamais de données dans xDome.
Puis-je connecter plus d’un locataire xDome ?
Oui. Claroty xDome prend en charge plusieurs intégrations, vous pouvez donc connecter plusieurs locataires côte à côte. Donnez à chacun 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/claroty-xdome.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.