> 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-de/integrieren-and-administrieren/integrations/asset-discovery/tenable.md).
# Tenable OT Security
Verbinden Sie Tenable OT Security über seine REST-API auf Ihrer lokalen Appliance, um erkannte OT-Assets als Geräte in Dispel zu übernehmen — mit den bekannten Schwachstellen — zugeordnet zu einem Wicket und aktualisi
## Überblick
Die Tenable-Integration ermöglicht es Dispel, die OT-Assets aus Tenable zu übernehmen, die in Ihrem Netzwerk entdeckt wurden, und sie zusammen mit den bekannten Schwachstellen, die Tenable auf ihnen gefunden hat, als Dispel-Geräte einzubringen. Sie verbinden sich einmal mit Ihrer Tenable-Appliance, ordnen sie einer Dispel-Facility und einem Wicket zu, und Dispel importiert die passenden Geräte und hält sie bei wiederholten Synchronisierungen aktuell.
Tenable ist eine lokale Integration zur Asset-Erkennung. Konkret integriert sich Dispel über seine REST-API mit Tenable OT Security (früher Tenable.ot).
Da eine Tenable-Appliance ein einzelnes, flaches Asset-Inventar ohne natives Konzept für Standort oder Location enthält, behandelt Dispel sie als einen Standort, den Sie einem einzelnen Wicket zuordnen — es gibt keine standortspezifische Liste, die abgearbeitet werden muss.
#### Was Dispel importiert
* Entdeckte OT-Assets (Name, IP-Adresse, MAC-Adresse, Hersteller/Modell, Betriebssystem, Firmware-Version, Seriennummer, Gerätetyp) als Dispel-Geräte.
* Bekannte Schwachstellen für jedes Asset, abgeleitet aus den Plugin-Funden von Tenable, mit der CVE und der CVSS-Schweregradbewertung, sofern verfügbar. Plugins mit Informationsschwere (zum Beispiel "Open Port") werden herausgefiltert, damit die Zählungen mit dem OT-Dashboard von Tenable übereinstimmen.
* Zusätzliche Geräteinformationen, die am Gerät angezeigt werden: End-of-Life-Status, SNMP-Details und — bei chassisbasierten Controllern — eine Backplane-Ansicht, die zeigt, welche Module sich das Rack teilen.
{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen**. Tenable erscheint im Abschnitt **Asset-Erkennung / Netzwerktransparenz** . Klicken Sie auf **Verbinden** auf der Tenable-Karte, um zu beginnen.
{% endhint %}
## Bevor Sie beginnen
Sie benötigen Folgendes aus Ihrer Tenable-Konsole:
* Einen API-Schlüssel — erstellen Sie einen unter **Lokale Einstellungen → Benutzerverwaltung → API-Schlüssel**. Tenable stellt zwei Werte bereit: eine **Key ID** (eine kurze Kennung) und den **API-Schlüssel** -Geheimschlüssel selbst.
* Die **Appliance-URL** Ihrer Tenable-Appliance — zum Beispiel `https://tenable-ot.example.com`.
* Wenn Ihre Appliance ein selbstsigniertes TLS-Zertifikat verwendet, stellen Sie darauf ein, während der Einrichtung die Option für selbstsignierte Zertifikate zu aktivieren.
{% hint style="warning" %}
**Dispel-IP auf die Allowlist setzen.** Wenn Sie das Verbindungsformular öffnen, zeigt Dispel einen Wert für **Whitelist-IP** an. Fügen Sie diese Adresse zur Allowlist Ihrer Netzwerk-Firewall hinzu, damit Dispel die lokale Appliance erreichen kann.
{% endhint %}
## Tenable verbinden
1. Gehen Sie zu **Einstellungen → Integrationen** und klicken Sie auf **Verbinden** auf der Tenable-Karte.
2. Optional können Sie einen **Anzeigenamen** festlegen, um diese Integration von anderen zu unterscheiden (Sie können mehr als eine Appliance verbinden).
3. Füllen Sie die Verbindungsfelder aus:
| Feld | Typ | Hinweise |
| ---------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Appliance-URL** | Konfiguration | Die Basis-URL Ihrer Tenable-Appliance, z. B. `https://tenable-ot.example.com`. |
| **Selbstsignierte Zertifikate zulassen** | Konfiguration | Aktivieren Sie diese Option, wenn Ihre Appliance ein selbstsigniertes TLS-Zertifikat verwendet. |
| **Key ID** | Anmeldeinformationen | Die Kennung, die in Tenable neben Ihrem API-Schlüssel angezeigt wird. Sie identifiziert den Schlüssel — sie wird nicht zur Authentifizierung verwendet. |
| **API-Schlüssel** | Anmeldeinformationen | Der geheime API-Schlüssel. Verschlüsselt gespeichert und danach nie wieder angezeigt. |
4. Klicken Sie auf **Verbindung testen** um zu bestätigen, dass Dispel sich bei der Appliance authentifizieren kann. Beheben Sie alle gemeldeten Fehler, bevor Sie speichern.
5. Klicken Sie auf **Speichern**. Dispel speichert die Integration und führt sofort die erste Synchronisierung aus.
{% hint style="info" %}
**Key ID vs. API-Schlüssel.** Dispel authentifiziert sich ausschließlich mit dem geheimen API-Schlüssel. Die Key ID wird nur als Referenz gespeichert — damit Sie beim Rotieren erkennen können, welcher Schlüssel verwendet wird.
{% endhint %}
{% hint style="info" %}
**Ihre Anmeldeinformationen sind verschlüsselt.** Der API-Schlüssel wird im Ruhezustand verschlüsselt gespeichert und nach dem Speichern nie wieder angezeigt. Lassen Sie beim späteren Bearbeiten die Anmeldefelder leer, um die gespeicherten Werte beizubehalten.
{% endhint %}
## Zuordnung der Appliance zu einem Wicket
Sobald die erste Synchronisierung abgeschlossen ist, öffnen Sie die Integration, um den Abschnitt **Standortzuordnung** zu finden. Tenable erscheint als einzelner Standort, der Ihre Appliance repräsentiert.
> Ordnen Sie jeden Anbieter-Standort einer Dispel-Facility und einem Wicket zu. Geräte aus zugeordneten Standorten werden in Dispel synchronisiert.
1. Wählen Sie eine **Facility**.
2. Wählen Sie eine **Wicket**. Wenn die Facility nur ein Wicket hat, wählt Dispel es für Sie aus.
3. Klicken Sie auf **Zuordnungen speichern & importieren**.
Dispel importiert die Assets der Appliance in das zugeordnete Wicket — Sie sehen den Fortschritt von Warten über Abrufen und Synchronisieren bis Abgeschlossen — und meldet dann, wie viele Geräte importiert wurden. Importierte Geräte erscheinen im zugeordneten Wicket neben allen Geräten, die Sie manuell hinzugefügt haben, zusammen mit den zugehörigen Schwachstellen.
## Ihr Inventar aktuell halten
* Dispel synchronisiert automatisch nach einem wiederkehrenden Zeitplan, sodass neu entdeckte Assets, geänderte Details und aktualisierte Schwachstellen ohne Ihr Zutun übernommen werden.
* Um das neueste Inventar sofort abzurufen, öffnen Sie die Integration und wählen Sie **Aktualisieren**.
* Um Verbindungsdetails zu ändern oder Zugangsdaten zu rotieren, bearbeiten Sie die Integration und verwenden Sie **Speichern & synchronisieren**. Lassen Sie die Anmeldefelder leer, um den aktuellen API-Schlüssel beizubehalten.
Schwachstellenfunde werden bei jeder Synchronisierung aktualisiert, und Funde, die Tenable nicht mehr meldet, werden automatisch entfernt.
## Verbindungsstatus
Jede Integration zeigt einen Status an, damit Sie immer wissen, wie es steht:
| Status | Bedeutung |
| ------------------------------- | ---------------------------------------------------------------------------------------- |
| **Nicht initialisiert** | Gespeichert, aber die erste Synchronisierung wurde noch nicht ausgeführt. |
| **Initialisierung läuft** | Die erste Synchronisierung wird ausgeführt. |
| **Bereit** | Verbunden und synchronisiert; die Zuordnung ist angewendet. |
| **Aktualisierung erforderlich** | Neue Anbieterdaten sind verfügbar; führen Sie eine Aktualisierung aus, um sie abzurufen. |
| **Wird aktualisiert** | Eine Synchronisierung läuft. |
| **Ausstehende Änderungen** | Zuordnungsänderungen sind gespeichert, aber noch nicht angewendet. |
| **Wird angewendet** | Geräte für Ihre gespeicherte Zuordnung werden importiert. |
| **Fehlgeschlagen** | Die letzte Operation ist fehlgeschlagen — siehe die Fehlerhinweise. |
Ein separates **Gesundheitsabzeichen** (Verbunden, Beeinträchtigt, Nicht erreichbar) zeigt an, ob Dispel die Tenable-Appliance derzeit erreichen kann.
## Fehlerbehebung
Wenn eine Synchronisierung oder ein Verbindungstest fehlschlägt, klassifiziert Dispel den Fehler und schlägt eine Lösung vor:
| Fehler | Was er normalerweise bedeutet und wie er behoben wird |
| ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Authentifizierung fehlgeschlagen** | Der API-Schlüssel wurde abgelehnt. Bestätigen Sie, dass der Schlüssel in Tenable noch aktiv ist (**Lokale Einstellungen → Benutzerverwaltung → API-Schlüssel**) und dass Sie den **API-Schlüssel** Geheimschlüssel — nicht den **Key ID**. |
| **Endpunkt nicht erreichbar** | Dispel konnte die Appliance nicht erreichen. Überprüfen Sie die Appliance-URL und dass die IP von Dispel in Ihrer Firewall auf der Allowlist steht. |
| **Zertifikatsfehler** | Die Appliance hat ein nicht vertrauenswürdiges TLS-Zertifikat präsentiert. Wenn sie ein selbstsigniertes Zertifikat verwendet, aktivieren Sie **Selbstsignierte Zertifikate zulassen** in den Verbindungseinstellungen. |
| **Verbindungszeitüberschreitung** | Die Appliance hat zu lange für eine Antwort gebraucht — oft aufgrund von Netzwerklatenz oder einer Firewall-Regel zwischen Dispel und Ihrem Netzwerk. |
| **Konfigurationsfehler** | Die URL sieht falsch aus oder die API ist unter dieser Adresse nicht erreichbar. Überprüfen Sie die Appliance-URL erneut. |
## Häufig gestellte Fragen
Mit welchem Tenable-Produkt verbindet sich dies?
Tenable OT Security (früher Tenable.ot) — die lokale Appliance, die OT-Assets entdeckt und bewertet. Dies ist nicht der Cloud-Dienst Tenable Vulnerability Management (Tenable.io).
Was ist der Unterschied zwischen der Key ID und dem API-Schlüssel?
Wenn Sie einen API-Schlüssel generieren, stellt Tenable zwei Werte bereit: eine Key ID (eine kurze Kennung) und den geheimen API-Schlüssel. Dispel authentifiziert sich nur mit dem Geheimschlüssel; die Key ID wird zur Referenz gespeichert, damit Sie beim Rotieren wissen, welcher Schlüssel verwendet wird.
Warum stimmen die Schwachstellenzahlen nicht mit der rohen Plugin-Anzahl von Tenable überein?
Dispel filtert Plugins mit Informationsschwere (zum Beispiel "Open Port") heraus, damit die Zahlen mit den Schwachstellenzahlen übereinstimmen, die auf dem eigenen OT-Dashboard von Tenable angezeigt werden, statt mit der größeren Gesamtsumme, die rein informative Ergebnisse einschließt.
Kann ich mehr als eine Tenable-Appliance verbinden?
Ja. Tenable unterstützt mehrere Integrationen, sodass Sie mehrere Appliances parallel verbinden können. Geben Sie jeder einen eindeutigen **Anzeigenamen** an, damit Sie sie unterscheiden können.
Ändert das Verbinden von Tenable etwas an meiner Appliance?
Nein. Dispel liest nur aus der API von Tenable. Es erstellt, ändert oder löscht niemals Daten auf der Tenable-Seite.
---
# 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-de/integrieren-and-administrieren/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.