---
title: Clients
id: "de:tpm:ROOT:clients.adoc"
site: de
component: tpm
module: ROOT
version: 3.0
lang: de
url: "https://help.rtlscloud.io/de/tpm/3.0/clients.html"
source_repo: "https://github.com/iot-invent/rtlscloud-tpm.git@3.0.x"
source_path: docs/de/modules/ROOT/pages/clients.adoc
---

# Clients

Die Clients, über die Fremdsysteme die Positions-, Entscheidungs- und Telemetriemeldungen der Tags empfangen. Die Anwendung stellt die Meldungen laufend zu; ein Fremdsystem muss nichts abfragen.

## Referenz

![Clients](_images/tpm_app_clients.png)

| Modul | Beschreibung |
| --- | --- |
| ![refresh](_images/refresh.svg) Aktualisieren | Lädt die Liste neu, einschließlich des Verbindungsstatus |
| ![plus](_images/plus.svg) Neu | Legt einen Client an |
| ![edit](_images/edit.svg) Bearbeiten | Öffnet den gewählten Client zum Ändern |
| ![delete](_images/delete.svg) Löschen | Entfernt den Client. Eine bestehende Verbindung wird sofort getrennt |
| ![info](_images/info.svg) Info | Anzahl der dargestellten Clients |

## Attribute

| Feld | Typ | Beschreibung |
| --- | --- | --- |
| Name | Text | Anzeigename, üblicherweise das System, das den Client nutzt |
| Client-ID | Text | Wird beim Speichern erzeugt. Über das Symbol in die Zwischenablage kopierbar |
| Client Secret | Passwort | Das Kennwort des Clients. Wird nur beim Erfassen angezeigt und danach nie wieder |
| Gruppen | Mehrfachauswahl | Die Gruppen, deren Tag-Meldungen dieser Client empfangen darf |
| Notizen | Text | Freier Text |
| Mandant | Auswahl | Nur beim Anlegen setzbar |
| Status | Anzeige | Ob der Client derzeit verbunden ist |

> **IMPORTANT:** Das Client Secret ist nach dem Speichern nicht mehr einsehbar. Hinterlegen Sie es sofort im Zielsystem. Ist es verloren, setzen Sie ein neues — es gibt keinen Weg, das bestehende anzuzeigen.

## Berechtigung

Ein Client empfängt **ausschließlich** Meldungen von Tags aus den ihm zugewiesenen Gruppen.

-   Ohne zugewiesene Gruppe verbindet sich der Client erfolgreich und empfängt **nichts**. Das ist die häufigste Fehlkonfiguration.

-   Ein Tag ohne Gruppe erzeugt Meldungen, die kein Client empfängt — siehe [Gruppen](tag_groups.md).

-   Die Prüfung erfolgt für jede Meldung einzeln. Ein Client kann seinen Umfang nicht dadurch erweitern, dass er breiter abonniert.

Verschieben Sie einen Tag in eine andere Gruppe, ändert sich ab der nächsten Meldung, wer sie erhält. Das Fremdsystem muss sich dafür nicht neu verbinden.

## Status

| Wert | Bedeutung |
| --- | --- |
| Connected | Der Client hält derzeit mindestens eine Verbindung |
| Disconnected | Es besteht keine Verbindung |

Der Status wird beim Aktualisieren der Liste direkt aus dem laufenden Betrieb gelesen, nicht aus der Datenbank. Er zeigt also den tatsächlichen Zustand.

## Mehrere Verbindungen eines Clients

Ein Fremdsystem darf denselben Client von mehreren Instanzen aus nutzen. Die Meldungen werden dann abwechselnd auf die Verbindungen verteilt, und fällt eine aus, übernimmt eine andere.

Damit lässt sich ein empfangendes System skalieren, ohne dass sich seine Instanzen untereinander abstimmen müssen. Zu beachten: Aufeinanderfolgende Meldungen **eines** Tags können auf unterschiedlichen Instanzen landen. Wenn die Reihenfolge wichtig ist, sortieren Sie im Zielsystem nach dem Zeitstempel der Meldung.

## Client deaktivieren oder entfernen

Beides wirkt sofort — eine bestehende Verbindung wird getrennt, ohne auf einen Zeitablauf zu warten. Das ist das Mittel, um einen Client zu widerrufen.