> 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-nl/integreren-en-beheren/integrations/asset-discovery/tenable.md).

# Tenable OT Security

Verbind Tenable OT Security via de REST API op uw on-premise appliance om ontdekte OT-assets als apparaten in Dispel binnen te halen — met hun bekende kwetsbaarheden — toegewezen aan een Wicket en ververst

## Overzicht

De Tenable-integratie laat Dispel de OT-assets ophalen die Tenable op uw netwerk heeft ontdekt en ze importeren als Dispel-apparaten, samen met de bekende kwetsbaarheden die Tenable daarop heeft gevonden. U koppelt uw Tenable-appliance één keer, wijst deze toe aan een Dispel-faciliteit en Wicket, en Dispel importeert de overeenkomende apparaten en houdt ze actueel via een terugkerende synchronisatie.

Tenable is een on-premise asset-discovery-integratie. Specifiek integreert Dispel met Tenable OT Security (voorheen Tenable.ot) via de REST API.

Omdat een Tenable-appliance één platte asset-inventaris bevat zonder een native site- of locatieconcept, behandelt Dispel deze als één site die u koppelt aan één enkel Wicket — er is geen lijst per site die u hoeft door te lopen.

#### Wat Dispel importeert

* Ontdekte OT-assets (naam, IP-adres, MAC-adres, merk/model, besturingssysteem, firmwareversie, serienummer, apparaattype) als Dispel-apparaten.
* Bekende kwetsbaarheden voor elk asset, afgeleid uit de pluginbevindingen van Tenable, met waar beschikbaar de CVE- en CVSS-ernst. Plugins met informatieve ernst (bijvoorbeeld "Open Port") worden uitgefilterd, zodat de aantallen overeenkomen met het eigen OT-dashboard van Tenable.
* Extra apparaatinformatie die op het apparaat wordt weergegeven: end-of-life-status, SNMP-details en — voor controllers op basis van een chassis — een backplane-weergave die laat zien welke modules hetzelfde rack delen.

{% hint style="info" %}
**Waar u het vindt.** Meld u aan als organisatiebeheerder en open **Instellingen → Integraties**. Tenable verschijnt in de **Asset Discovery / Network Visibility** sectie. Klik op **Verbinden** op de Tenable-kaart om te beginnen.
{% endhint %}

## Voordat u begint

U heeft het volgende nodig uit uw Tenable-console:

* Een API-sleutel — maak er een aan onder **Lokale instellingen → Gebruikersbeheer → API-sleutels**. Tenable verstrekt twee waarden: een **Key ID** (een korte identificatie) en de **API-sleutel** zelf.
* Het **Appliance-URL** van uw Tenable-appliance — bijvoorbeeld `https://tenable-ot.example.com`.
* Als uw appliance een zelfondertekend TLS-certificaat gebruikt, wees dan voorbereid om de optie voor zelfondertekend tijdens de configuratie in te schakelen.

{% hint style="warning" %}
**Zet het IP-adres van Dispel op de allowlist.** Wanneer u het verbindingsformulier opent, toont Dispel een **Whitelist-IP** waarde. Voeg dit adres toe aan de allowlist van uw netwerkfirewall zodat Dispel de on-premise appliance kan bereiken.
{% endhint %}

## Tenable verbinden

1. Ga naar **Instellingen → Integraties** en klik op **Verbinden** op de Tenable-kaart.
2. Stel optioneel een **Weergavenaam** in om deze integratie van andere te onderscheiden (u kunt meer dan één appliance koppelen).
3. Vul de verbindingsvelden in:

| Veld                                       | Type          | Opmerkingen                                                                                                                                         |
| ------------------------------------------ | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Appliance-URL**                          | Config        | De basis-URL van uw Tenable-appliance, bijv. `https://tenable-ot.example.com`.                                                                      |
| **Zelfondertekende certificaten toestaan** | Config        | Schakel in als uw appliance een zelfondertekend TLS-certificaat gebruikt.                                                                           |
| **Key ID**                                 | Inloggegevens | De identificatie die naast uw API-sleutel in Tenable wordt weergegeven. Deze identificeert de sleutel — hij wordt niet gebruikt voor authenticatie. |
| **API-sleutel**                            | Inloggegevens | Het geheim van de API-sleutel. Versleuteld opgeslagen en nooit opnieuw weergegeven.                                                                 |

4. Klik op **Verbinding testen** om te bevestigen dat Dispel zich kan authenticeren bij de appliance. Los eventuele gemelde fout op voordat u opslaat.
5. Klik op **Opslaan**. Dispel slaat de integratie op en start onmiddellijk de eerste synchronisatie.

{% hint style="info" %}
**Key ID versus API-sleutel.** Dispel authenticates alleen met het geheime deel van de API-sleutel. De Key ID wordt puur ter referentie opgeslagen — zodat u kunt zien welke sleutel in gebruik is wanneer het tijd is om deze te roteren.
{% endhint %}

{% hint style="info" %}
**Uw inloggegevens zijn versleuteld.** De API-sleutel is at rest versleuteld en wordt na het opslaan nooit opnieuw weergegeven. Laat bij het later bewerken de velden voor inloggegevens leeg om de opgeslagen waarden te behouden.
{% endhint %}

## De appliance aan een Wicket koppelen

Zodra de eerste synchronisatie is voltooid, opent u de integratie om de **Sitekoppeling** sectie te vinden. Tenable verschijnt als één enkele site die uw appliance vertegenwoordigt.

> Koppel elke vendorsite aan een Dispel-faciliteit en Wicket. Apparaten van gekoppelde sites worden gesynchroniseerd naar Dispel.

1. Kies een **Faciliteit**.
2. Kies een **Wicket**. Als de faciliteit slechts één Wicket heeft, selecteert Dispel dit voor u.
3. Klik op **Koppelingen opslaan & importeren**.

Dispel importeert de assets van de appliance in het gekoppelde Wicket — u ziet de voortgang van wachten naar ophalen, naar synchroniseren, naar voltooid gaan — en meldt vervolgens hoeveel apparaten zijn geïmporteerd. Geïmporteerde apparaten verschijnen in het gekoppelde Wicket naast eventuele apparaten die u handmatig hebt toegevoegd, met hun kwetsbaarheden eraan gekoppeld.

## Uw inventaris actueel houden

* Dispel synchroniseert automatisch opnieuw volgens een terugkerend schema, zodat nieuw ontdekte assets, gewijzigde details en bijgewerkte kwetsbaarheden zonder enige actie van uw kant worden opgepikt.
* Om de nieuwste inventaris direct op te halen, opent u de integratie en kiest u **Vernieuwen**.
* Om verbindingsgegevens te wijzigen of inloggegevens te roteren, bewerkt u de integratie en gebruikt u **Opslaan & synchroniseren**. Laat de velden voor inloggegevens leeg om de huidige API-sleutel te behouden.

Kwetsbaarheidsbevindingen worden bij elke synchronisatie vernieuwd, en bevindingen die Tenable niet langer rapporteert verdwijnen automatisch.

## Verbindingsstatus

Elke integratie toont een status, zodat u altijd weet hoe het ervoor staat:

| Status                         | Betekenis                                                                           |
| ------------------------------ | ----------------------------------------------------------------------------------- |
| **Nog niet geïnitialiseerd**   | Opgeslagen, maar de eerste synchronisatie is nog niet uitgevoerd.                   |
| **Initialiseren**              | De eerste synchronisatie uitvoeren.                                                 |
| **Gereed**                     | Verbonden en gesynchroniseerd; de koppeling is toegepast.                           |
| **Vernieuwing nodig**          | Nieuwe vendorgegevens zijn beschikbaar; voer een vernieuwing uit om ze op te halen. |
| **Vernieuwen**                 | Er is een synchronisatie bezig.                                                     |
| **Wijzigingen in behandeling** | Koppelingswijzigingen zijn opgeslagen maar nog niet toegepast.                      |
| **Toepassen**                  | Apparaten importeren voor uw opgeslagen koppeling.                                  |
| **Mislukt**                    | De laatste bewerking is mislukt — zie de foutmelding voor begeleiding.              |

Een aparte **gezondheidsbadge** (Verbonden, Gedegradeerd, Onbereikbaar) geeft aan of Dispel de Tenable-appliance momenteel kan bereiken.

## Probleemoplossing

Als een synchronisatie of verbindingstest mislukt, classificeert Dispel de fout en stelt het een oplossing voor:

| Fout                      | Wat het meestal betekent en hoe u het oplost                                                                                                                                                                     |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authenticatie mislukt** | De API-sleutel is geweigerd. Controleer of de sleutel nog actief is in Tenable (**Lokale instellingen → Gebruikersbeheer → API-sleutels**) en of u het **API-sleutel** geheim hebt geplakt — niet de **Key ID**. |
| **Eindpunt onbereikbaar** | Dispel kon de appliance niet bereiken. Controleer de Appliance-URL en of het IP-adres van Dispel op de allowlist van uw firewall staat.                                                                          |
| **Certificaatfout**       | De appliance presenteerde een niet-vertrouwd TLS-certificaat. Als deze een zelfondertekend certificaat gebruikt, schakel **Zelfondertekende certificaten toestaan** in in de verbindingsinstellingen.            |
| **Verbindingstime-out**   | De appliance deed er te lang over om te reageren — vaak netwerkvertraging of een firewallregel tussen Dispel en uw netwerk.                                                                                      |
| **Configuratiefout**      | De URL lijkt onjuist of de API is op dat adres niet bereikbaar. Controleer de Appliance-URL opnieuw.                                                                                                             |

## Veelgestelde vragen

<details>

<summary>Met welk Tenable-product maakt dit verbinding?</summary>

Tenable OT Security (voorheen Tenable.ot) — de on-premise appliance die OT-assets ontdekt en beoordeelt. Dit is niet de cloudservice Tenable Vulnerability Management (Tenable.io).

</details>

<details>

<summary>Wat is het verschil tussen de Key ID en de API Key?</summary>

Wanneer u een API-sleutel genereert, verstrekt Tenable twee waarden: een Key ID (een korte identificatie) en het geheim van de API-sleutel. Dispel authenticates alleen met het geheim; de Key ID wordt ter referentie opgeslagen zodat u weet welke sleutel in gebruik is bij het roteren ervan.

</details>

<details>

<summary>Waarom komen de kwetsbaarheidstellingen niet overeen met het ruwe pluginaantal van Tenable?</summary>

Dispel filtert plugins met informatieve ernst eruit (bijvoorbeeld "Open Port"), zodat de aantallen overeenkomen met de kwetsbaarheidstellingen die op het eigen OT-dashboard van Tenable worden getoond, in plaats van het grotere totaal dat ook puur informatieve resultaten bevat.

</details>

<details>

<summary>Kan ik meer dan één Tenable-appliance koppelen?</summary>

Ja. Tenable ondersteunt meerdere integraties, dus u kunt meerdere appliances naast elkaar koppelen. Geef elke appliance een onderscheidende **Weergavenaam** om ze uit elkaar te houden.

</details>

<details>

<summary>Verandert het koppelen van Tenable iets aan mijn appliance?</summary>

Nee. Dispel leest alleen via de API van Tenable. Het maakt, wijzigt of verwijdert nooit gegevens aan de Tenable-kant.

</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-nl/integreren-en-beheren/integrations/asset-discovery/tenable.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.
