> 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/tenable.md).
# Tenable OT Security
Connectez Tenable OT Security, via son API REST sur votre appliance sur site, pour importer dans Dispel les actifs OT découverts sous forme de dispositifs — avec leurs vulnérabilités connues — mappés à un Wicket et actualisé
## Aperçu
L’intégration Tenable permet à Dispel de récupérer les actifs OT découverts par Tenable sur votre réseau et de les importer comme appareils Dispel, ainsi que les vulnérabilités connues que Tenable y a trouvées. Vous vous connectez une seule fois à votre appliance Tenable, vous la mappez à une installation Dispel et à un Wicket, puis Dispel importe les appareils correspondants et les maintient à jour via une synchronisation récurrente.
Tenable est une intégration de découverte d’actifs sur site. Plus précisément, Dispel s’intègre à Tenable OT Security (anciennement Tenable.ot) via son API REST.
Comme une appliance Tenable contient un inventaire d’actifs unique et plat, sans notion native de site ou d’emplacement, Dispel la traite comme un seul site que vous mappez à un seul Wicket — il n’y a pas de liste par site à parcourir.
#### Ce que Dispel importe
* Les actifs OT découverts (nom, adresse IP, adresse MAC, marque/modèle, système d’exploitation, version du micrologiciel, numéro de série, type d’appareil) comme appareils Dispel.
* Les vulnérabilités connues de chaque actif, issues des résultats des plugins de Tenable, avec le CVE et la sévérité CVSS lorsque disponibles. Les plugins de sévérité informative (par exemple, « Open Port ») sont filtrés afin que les décomptes correspondent au propre tableau de bord OT de Tenable.
* Des informations supplémentaires sur l’appareil affichées sur celui-ci : état de fin de vie, détails SNMP et — pour les contrôleurs basés sur châssis — une vue du backplane montrant quels modules partagent le rack.
{% hint style="info" %}
**Où le trouver.** Connectez-vous en tant qu’administrateur d’organisation et ouvrez **Paramètres → Intégrations**. Tenable apparaît dans la **Découverte d’actifs / Visibilité réseau** section. Cliquez sur **Connecter** sur la carte Tenable pour commencer.
{% endhint %}
## Avant de commencer
Vous aurez besoin des éléments suivants depuis votre console Tenable :
* Une clé API — générez-en une sous **Paramètres locaux → Gestion des utilisateurs → Clés API**. Tenable fournit deux valeurs : un **ID de clé** (un identifiant court) et la **clé API** secret lui-même.
* L’ **URL de l’appliance** de votre appliance Tenable, par exemple `https://tenable-ot.example.com`.
* Si votre appliance utilise un certificat TLS auto-signé, soyez prêt à activer l’option auto-signée pendant la configuration.
{% hint style="warning" %}
**Ajoutez l’IP de Dispel à la liste blanche.** Lorsque vous ouvrez le formulaire de connexion, Dispel affiche une **IP sur liste blanche** valeur. Ajoutez cette adresse à la liste blanche de votre pare-feu afin que Dispel puisse atteindre l’appliance sur site.
{% endhint %}
## Connexion à Tenable
1. Allez dans **Paramètres → Intégrations** et cliquez sur **Connecter** sur la carte Tenable.
2. Définissez éventuellement un **Nom d’affichage** pour distinguer cette intégration des autres (vous pouvez connecter plusieurs appliances).
3. Renseignez les champs de connexion :
| Champ | Type | Remarques |
| ----------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **URL de l’appliance** | Configuration | L’URL de base de votre appliance Tenable, par ex. `https://tenable-ot.example.com`. |
| **Autoriser les certificats auto-signés** | Configuration | Activez cette option si votre appliance utilise un certificat TLS auto-signé. |
| **ID de clé** | Identifiant | L’identifiant affiché à côté de votre clé API dans Tenable. Il identifie la clé — il n’est pas utilisé pour l’authentification. |
| **clé API** | Identifiant | Le secret de la clé API. Stocké de manière chiffrée et jamais réaffiché. |
4. Cliquez sur **Tester la connexion** pour confirmer que Dispel peut s’authentifier auprès de l’appliance. Corrigez toute erreur signalée avant d’enregistrer.
5. Cliquez sur **Enregistrer**. Dispel enregistre l’intégration et exécute immédiatement la synchronisation initiale.
{% hint style="info" %}
**ID de clé vs clé API.** Dispel s’authentifie uniquement à l’aide du secret de la clé API. L’ID de clé est conservé uniquement à titre de référence — afin que vous sachiez quelle clé est utilisée au moment de la faire tourner.
{% endhint %}
{% hint style="info" %}
**Vos identifiants sont chiffrés.** La clé API est chiffrée au repos et n’est plus jamais affichée après l’enregistrement. Lors d’une modification ultérieure, laissez les champs d’identifiants vides pour conserver les valeurs stockées.
{% endhint %}
## Mapper l’appliance à un Wicket
Une fois la synchronisation initiale terminée, ouvrez l’intégration pour trouver la **Mappage des sites** section. Tenable apparaît comme un site unique représentant votre appliance.
> Mappez chaque site du fournisseur à une installation Dispel et à un Wicket. Les appareils des sites mappés seront synchronisés dans Dispel.
1. Choisissez une **Installation**.
2. Choisissez une **Wicket**. Si l’installation ne comporte qu’un seul Wicket, Dispel le sélectionne pour vous.
3. Cliquez sur **Enregistrer les mappages et importer**.
Dispel importe les actifs de l’appliance vers le Wicket mappé — vous verrez la progression passer de l’attente à la récupération, puis à la synchronisation et enfin à la fin — puis il indique combien d’appareils ont été importés. Les appareils importés apparaissent dans le Wicket mappé aux côtés des appareils que vous avez ajoutés manuellement, avec leurs vulnérabilités associées.
## Maintenir votre inventaire à jour
* Dispel resynchronise automatiquement selon un calendrier récurrent, de sorte que les actifs nouvellement découverts, les détails modifiés et les vulnérabilités mises à jour sont pris en compte sans aucune action de votre part.
* Pour récupérer immédiatement l’inventaire le plus récent, ouvrez l’intégration et choisissez **Actualiser**.
* Pour modifier les détails de connexion ou faire pivoter les identifiants, modifiez l’intégration et utilisez **Enregistrer et synchroniser**. Laissez les champs d’identifiants vides pour conserver la clé API actuelle.
Les résultats de vulnérabilité sont actualisés à chaque synchronisation, et ceux que Tenable ne signale plus disparaissent automatiquement.
## État de la connexion
Chaque intégration affiche un statut 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 en cours** | Exécution de la première synchronisation. |
| **Prêt** | Connecté et synchronisé ; le mappage est appliqué. |
| **Actualisation requise** | 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 correspondant à votre mappage enregistré. |
| **Échec** | La dernière opération a échoué — consultez les indications d’erreur. |
Un badge séparé **badge de santé** (Connecté, Dégradé, Injoignable) indique si Dispel peut actuellement joindre l’appliance Tenable.
## Dépannage
Si une synchronisation ou un test de connexion échoue, Dispel classe l’erreur et propose une correction :
| Erreur | Ce que cela signifie généralement et comment le corriger |
| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Échec de l’authentification** | La clé API a été refusée. Vérifiez que la clé est toujours active dans Tenable (**Paramètres locaux → Gestion des utilisateurs → Clés API**) et que vous avez collé le **clé API** secret — et non le **ID de clé**. |
| **Point de terminaison injoignable** | Dispel n’a pas pu joindre l’appliance. Vérifiez l’URL de l’appliance et que l’IP de Dispel est autorisée dans votre pare-feu. |
| **Erreur de certificat** | L’appliance a présenté un certificat TLS non approuvé. S’il utilise un certificat auto-signé, activez **Autoriser les certificats auto-signés** dans les paramètres de connexion. |
| **Délai de connexion dépassé** | L’appliance a mis trop de temps à répondre — souvent en raison d’une latence réseau ou d’une règle de pare-feu entre Dispel et votre réseau. |
| **Erreur de configuration** | L’URL semble incorrecte ou l’API n’est pas accessible à cette adresse. Revérifiez l’URL de l’appliance. |
## Foire aux questions
À quel produit Tenable cela se connecte-t-il ?
Tenable OT Security (anciennement Tenable.ot) — l’appliance sur site qui découvre et évalue les actifs OT. Il ne s’agit pas du service cloud Tenable Vulnerability Management (Tenable.io).
Quelle est la différence entre l’ID de clé et la clé API ?
Lorsque vous générez une clé API, Tenable fournit deux valeurs : un ID de clé (un identifiant court) et le secret de la clé API. Dispel s’authentifie uniquement avec le secret ; l’ID de clé est conservé comme référence afin que vous sachiez quelle clé est utilisée lors de sa rotation.
Pourquoi les décomptes de vulnérabilités ne correspondent-ils pas au nombre brut de plugins de Tenable ?
Dispel filtre les plugins de sévérité informative (par exemple, « Open Port ») afin que les chiffres correspondent aux décomptes de vulnérabilités affichés sur le tableau de bord OT de Tenable, plutôt qu’au total plus élevé qui inclut de simples résultats informatifs.
Puis-je connecter plus d’une appliance Tenable ?
Oui. Tenable prend en charge plusieurs intégrations, vous pouvez donc connecter plusieurs appliances côte à côte. Donnez à chacune un **Nom d’affichage** nom distinct pour les distinguer.
La connexion à Tenable change-t-elle quelque chose sur mon appliance ?
Non. Dispel lit uniquement l’API de Tenable. Il ne crée, ne modifie et ne supprime jamais de données du côté de Tenable.
---
# 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/tenable.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.