> 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/txone.md).

# TXOne

Verbinden Sie Ihre TXOne-StellarOne-Konsole, um geschützte OT-Endpunkte als Geräte in Dispel zu übernehmen, einem Wicket zugeordnet und bei einer wiederkehrenden Synchronisierung aktualisiert.

## Übersicht

Die TXOne-Integration ermöglicht es Dispel, die von Ihrer TXOne verwalteten OT-Endpunkte abzurufen **StellarOne** Konsole und sie als Dispel-Geräte zu übernehmen. Sie verbinden sich einmal mit StellarOne, ordnen es einer Dispel-Einrichtung und einem Wicket zu, und Dispel importiert die passenden Geräte und hält sie durch eine wiederkehrende Synchronisierung auf dem neuesten Stand.

TXOne ist eine **Asset-Discovery** Integration. Dispel verbindet sich mit Ihrer StellarOne-Verwaltungskonsole und liest daraus ausschließlich.

In StellarOne, **Agenten** sind die verwalteten StellarProtect-Endpunkte. Dispel importiert jeden Agenten als Gerät und erfasst dessen IP, MAC-Adresse, Hostnamen, Betriebssystem und installierte ICS-Anwendungen. Da eine StellarOne-Konsole eine einzelne Umgebung repräsentiert, behandelt Dispel die Konsole als einen **Standort** den Sie einem einzelnen Wicket zuordnen.

#### Was Dispel importiert

* Verwaltete Agenten (Hostname, IP-Adresse, MAC-Adresse, Betriebssystem) als Dispel-Geräte.
* Beobachtete Netzwerkprotokolle und Ports für jeden Agenten.
* Ein Verweis zurück auf den Agenten in StellarOne, auf dem Gerät gespeichert.

{% hint style="info" %}
**Wo Sie es finden.** Melden Sie sich als Organisationsadministrator an und öffnen Sie **Einstellungen → Integrationen**. TXOne erscheint im **Asset Discovery / Network Visibility** Bereich. Klicken Sie auf **Verbinden** auf der TXOne-Karte, um zu beginnen.
{% endhint %}

## Bevor Sie beginnen

Sie benötigen Folgendes aus Ihrer TXOne StellarOne-Konsole:

* Einen **API-Schlüssel**, der in der StellarOne-Verwaltungskonsole generiert wurde (siehe das StellarOne-Administrationshandbuch für die genauen Schritte).
* Die **StellarOne-URL** Ihrer Konsole — zum Beispiel `https://stellar1.example.com`.
* Wenn Ihre Konsole ein **selbstsigniertes TLS-Zertifikat**, seien Sie bereit, während der Einrichtung die Option für selbstsignierte Zertifikate zu aktivieren.

{% hint style="warning" %}
**Nehmen Sie die IP von Dispel in die Allowlist auf.** Wenn Sie das Verbindungsformular öffnen, zeigt Dispel einen **Whitelist-IP** Wert an. Fügen Sie diese Adresse der Allowlist Ihrer Netzwerk-Firewall hinzu, damit Dispel die StellarOne-Konsole erreichen kann.
{% endhint %}

## TXOne verbinden

1. Gehen Sie zu **Einstellungen → Integrationen** und klicken Sie **Verbinden** auf die TXOne-Karte.
2. Optional können Sie einen **Anzeigenamen** festlegen, um diese Integration von anderen zu unterscheiden (Sie können mehr als eine Konsole verbinden).
3. Füllen Sie die Verbindungsfelder aus:

| Feld                                     | Typ           | Hinweise                                                                                             |
| ---------------------------------------- | ------------- | ---------------------------------------------------------------------------------------------------- |
| **StellarOne-URL**                       | Konfiguration | Die URL Ihrer TXOne-StellarOne-Verwaltungskonsole.                                                   |
| **Selbstsignierte Zertifikate zulassen** | Konfiguration | Aktivieren Sie diese Option, wenn Ihre Konsole ein selbstsigniertes TLS-Zertifikat verwendet.        |
| **API-Schlüssel**                        | Anmeldedaten  | Der in StellarOne generierte API-Schlüssel. Wird verschlüsselt gespeichert und nie wieder angezeigt. |

4. Klicken Sie auf **Verbindung testen** um zu bestätigen, dass sich Dispel bei StellarOne 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" %}
**Ihre Anmeldedaten sind verschlüsselt.** Der API-Schlüssel wird im Ruhezustand verschlüsselt und nach dem Speichern nie wieder angezeigt. Lassen Sie beim späteren Bearbeiten das Anmeldedatenfeld leer, um den gespeicherten Wert beizubehalten.
{% endhint %}

## Zuordnung der Konsole zu einem Wicket

Wenn die erste Synchronisierung abgeschlossen ist, öffnen Sie die Integration, um den **Bereich Standortzuordnung** zu finden. TXOne erscheint als einzelner Standort, der Ihre StellarOne-Konsole repräsentiert.

> Ordnen Sie jeden Herstellerstandort einer Dispel-Einrichtung und einem Wicket zu. Geräte aus zugeordneten Standorten werden in Dispel synchronisiert.

1. Wählen Sie eine **Einrichtung**.
2. Wählen Sie eine **Wicket**. Wenn die Einrichtung nur ein Wicket hat, wählt Dispel es für Sie aus.
3. Klicken Sie auf **Zuordnungen speichern & importieren**.

Dispel importiert die Agenten der Konsole in das zugeordnete Wicket — Sie sehen, wie der Fortschritt von Warten über Abrufen und Synchronisieren bis zum Abschluss wechselt — und meldet dann, wie viele Geräte importiert wurden (zum Beispiel, **"12 Geräte importiert"** oder eine Aufschlüsselung neuer gegenüber bereits importierter Geräte). Importierte Geräte erscheinen im zugeordneten Wicket zusammen mit allen Geräten, die Sie manuell hinzugefügt haben.

## Ihr Inventar aktuell halten

* Dispel **synchronisiert automatisch erneut** nach einem wiederkehrenden Zeitplan, sodass neu hinzugefügte Agenten und geänderte Details 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 den Schlüssel zu rotieren, bearbeiten Sie die Integration und verwenden Sie **Speichern & synchronisieren**. Lassen Sie das Anmeldedatenfeld leer, um den aktuellen Schlüssel beizubehalten.

## Verbindungsstatus

Jede Integration zeigt einen Status an, damit Sie immer wissen, wo sie steht:

| Status                          | Bedeutung                                                                                  |
| ------------------------------- | ------------------------------------------------------------------------------------------ |
| **Nicht initialisiert**         | Gespeichert, aber die erste Synchronisierung wurde noch nicht ausgeführt.                  |
| **Initialisierung**             | Führt die erste Synchronisierung aus.                                                      |
| **Bereit**                      | Verbunden und synchronisiert; die Zuordnung ist angewendet.                                |
| **Aktualisierung erforderlich** | Neue Herstellerdaten 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**             | Importiert Geräte für Ihre gespeicherte Zuordnung.                                         |
| **Fehlgeschlagen**              | Der letzte Vorgang ist fehlgeschlagen — siehe die Hinweise zum Fehler.                     |

Eine separate **Statusanzeige** (Verbunden, Beeinträchtigt, Nicht erreichbar) zeigt an, ob Dispel die StellarOne-Konsole derzeit erreichen kann.

## Fehlerbehebung

Wenn eine Synchronisierung oder ein Verbindungs-Test fehlschlägt, klassifiziert Dispel den Fehler und schlägt eine Lösung vor:

| Fehler                               | Was er normalerweise bedeutet und wie man ihn behebt                                                                                                                                                                  |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Authentifizierung fehlgeschlagen** | Der API-Schlüssel wurde abgelehnt. Generieren Sie in StellarOne einen neuen Schlüssel und aktualisieren Sie die Integration.                                                                                          |
| **Endpunkt nicht erreichbar**        | Dispel konnte die Konsole nicht erreichen. Überprüfen Sie die StellarOne-URL und ob die IP von Dispel in Ihrer Firewall in der Allowlist steht.                                                                       |
| **Zertifikatsfehler**                | Die Konsole 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 Konsole hat zu lange für eine Antwort gebraucht — oft liegt das an Netzwerklatenz oder einer Firewall-Regel zwischen Dispel und Ihrem Netzwerk.                                                                   |
| **Konfigurationsfehler**             | Die URL sieht falsch aus. Überprüfen Sie die Verbindungseinstellungen erneut.                                                                                                                                         |

## Häufig gestellte Fragen

<details>

<summary>Kann ich mehr als eine StellarOne-Konsole verbinden?</summary>

Ja. TXOne unterstützt mehrere Integrationen, sodass Sie mehrere Konsolen nebeneinander verbinden können. Geben Sie jeder einen eindeutigen **Anzeigenamen** zur Unterscheidung.

</details>

<details>

<summary>Warum zeigt TXOne nur einen Standort an?</summary>

Eine StellarOne-Konsole repräsentiert eine einzelne Umgebung, daher modelliert Dispel sie als einen Standort, der einem Wicket zugeordnet ist — statt als Liste von Standorten, die einzeln zugeordnet werden.

</details>

<details>

<summary>Meine Konsole verwendet ein selbstsigniertes Zertifikat. Wird die Verbindung fehlschlagen?</summary>

Nicht, wenn Sie **Selbstsignierte Zertifikate zulassen** in den Verbindungseinstellungen aktivieren. Lassen Sie es deaktiviert, wenn Ihre Konsole ein Zertifikat von einer vertrauenswürdigen Zertifizierungsstelle präsentiert.

</details>

<details>

<summary>Ändert das Verbinden von TXOne etwas in StellarOne?</summary>

Nein. Dispel liest nur aus StellarOne. Es erstellt, ändert oder löscht niemals Daten auf der TXOne-Seite.

</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-de/integrieren-and-administrieren/integrations/asset-discovery/txone.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.