Zugriffstoken erstellen und verwalten

Access Token sind JSON Web Token (JWT), welche benötigt werden, um mit dem Endpunkt eines Telemetry Routers interagieren zu können.

Voraussetzungen

• Sie verfügen über eine Instanz des Telemetry Router. Instanzen erstellen und verwalten

API-Voraussetzungen und -Variablen

Um die API-Befehle in dieser Anleitung auszuführen, müssen Sie zunächst die folgenden Pfadparameter als Umgebungsvariablen in Ihrem Terminal exportieren (oder diese direkt in den Befehlen ersetzen):

• $PROJECT_ID: Ihre eindeutige STACKIT-Projekt-ID (z. B. 16dbfb51...).
• $REGION_ID: Die Region, in der sich Ihre Instanz befindet (z. B. eu01 oder eu02).
• $TELEMETRY_ROUTER_ID: Die eindeutige ID Ihrer Telemetry Router-Instanz.
• $ACCESS_TOKEN_ID: Der spezifische Bezeichner eines Zugriffstokens (erforderlich für die Operationen Anzeigen, Bearbeiten und Löschen).

Wenn Sie Hilfe beim Finden dieser Bezeichner benötigen oder erfahren möchten, wie der stackit curl-Wrapper funktioniert, lesen Sie unseren zentralen Leitfaden: Mit der Telemetry Router-API interagieren.

Eine konzeptionelle Übersicht über die verschiedenen Authentifizierungs-Pfade finden Sie in unserer Authentifizierungsübersicht.

Zugriffstoken erstellen

STACKIT API

Um ein Zugriffstoken für den Telemetry Router zu erstellen, müssen Sie den entsprechenden Endpunkt aufrufen.

Eigenschaften für Ihr neues Zugriffstoken wählen

Parameter	Bedeutung	Beispiel
ttl	Eine Ganzzahl oder null, um die Lebensdauer des Tokens in Tagen zu definieren. null steht für ein Token mit unbegrenzter Lebensdauer.	28800
displayName	Ein Name für die Instanz des Telemetry Router	my-telemetry-router
description	Eine optionale Beschreibung für Ihre Unterlagen	Meine Instanz des Telemetry Router

stackit curl -X POST \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers/$TELEMETRY_ROUTER_ID/access-tokens" \
-H "Content-Type: application/json" \
--data '{
    "ttl": <TTL>,
    "displayName": "<DISPLAY_NAME>",
    "description": "<DESCRIPTION>"
}'

Beispiel

stackit curl -X POST \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens" \
-H "Content-Type: application/json" \
--data '{
    "ttl": 180,
    "displayName": "my-telemetry-router-access-token",
    "description": "Mein Zugriffstoken für den Telemetry Router"
}'

STACKIT Portal

Führen Sie die Schritte im Portal aus, um ein Telemetry Router-Zugriffstoken zu erstellen.

1. Klicken Sie in der Seitenleiste auf Telemetry Router.

2. Navigieren Sie zu der Instanz, für die Sie ein Zugriffstoken erstellen möchten, und klicken Sie auf den Eintrag.

3. Klicken Sie in der Seitenleiste auf Zugriffstoken.

4. Klicken Sie in der oberen Leiste auf Zugriffstoken erstellen.

5. Konfigurieren Sie im Overlay Ihr neues Zugriffstoken.

   Geben Sie einen Namen für Ihr neues Zugriffstoken ein. Dieser Name dient Ihnen als Referenz. Das Token kann entweder eine unbegrenzte Lebensdauer oder eine Lebensdauer zwischen 1 und 180 Tagen haben.

   Nachdem Sie alle Informationen festgelegt haben, klicken Sie auf Erstellen.

6. Kopieren Sie das erstellte Token an einen sicheren Ort. Sie können das Token später nicht mehr abrufen.

Alle Zugriffstoken auflisten

STACKIT API

stackit curl -X GET \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers/$TELEMETRY_ROUTER_ID/access-tokens" \
-H "Content-Type: application/json"

Beispiel

stackit curl -X GET \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens" \
-H "Content-Type: application/json"

STACKIT Portal

Führen Sie die Schritte im Portal aus, um alle Telemetry Router-Zugriffstoken anzuzeigen.

1. Klicken Sie in der Seitenleiste auf Telemetry Router.
2. Navigieren Sie zu der Instanz, für die Sie ein Zugriffstoken erstellen möchten, und klicken Sie auf den Eintrag.
3. Klicken Sie in der Seitenleiste auf Zugriffstoken.
4. Sie sehen eine Liste aller Zugriffstoken mit ihrem Status.

Ein Zugriffstoken anzeigen

STACKIT API

stackit curl -X GET \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers/$TELEMETRY_ROUTER_ID/access-tokens/$ACCESS_TOKEN_ID" \
-H "Content-Type: application/json"

Beispiel

stackit curl -X GET \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9" \
-H "Content-Type: application/json"

STACKIT Portal

Führen Sie die Schritte im Portal aus, um ein Telemetry Router-Zugriffstoken anzuzeigen.

1. Klicken Sie in der Seitenleiste auf Telemetry Router.

2. Navigieren Sie zu der Instanz, für die Sie ein Zugriffstoken erstellen möchten, und klicken Sie auf den Eintrag.

3. Klicken Sie in der Seitenleiste auf Zugriffstoken.

4. Sie sehen eine Liste aller Zugriffstoken mit ihrem Status. Klicken Sie auf einen Eintrag, den Sie anzeigen möchten, um die Details zu sehen.

   Sie können ein Zugriffstoken nicht erneut abrufen. Wenn Sie es verloren haben, müssen Sie ein neues Zugriffstoken erstellen.

Ein Zugriffstoken bearbeiten

STACKIT API

Parameter	Bedeutung	Beispiel
displayName	Ein Name für die Instanz des Telemetry Router. Bei diesem Endpunkt ist der Parameter optional.	my-telemetry-router
description	Eine optionale Beschreibung für Ihre Unterlagen	Meine Instanz des Telemetry Router

stackit curl -X PUT \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers/$TELEMETRY_ROUTER_ID/access-tokens/$ACCESS_TOKEN_ID" \
-H "Content-Type: application/json" \
--data '{
    "displayName": "<DISPLAY_NAME>",
    "description": "<DESCRIPTION>"
}'

Beispiel

stackit curl -X PUT \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9" \
-H "Content-Type: application/json" \
--data '{
    "displayName": "my-new-access-token-name",
    "description": "My new description for the access token"
}'

STACKIT Portal

Führen Sie die Schritte im Portal aus, um ein Telemetry Router-Zugriffstoken zu bearbeiten.

1. Klicken Sie in der Seitenleiste auf Telemetry Router.
2. Navigieren Sie zu der Instanz, für die Sie ein Zugriffstoken erstellen möchten, und klicken Sie auf den Eintrag.
3. Klicken Sie in der Seitenleiste auf Zugriffstoken.
4. Sie sehen eine Liste aller Zugriffstoken mit ihrem Status. Klicken Sie auf einen Eintrag, den Sie anzeigen möchten, um die Details zu sehen.
5. In dieser Detailansicht können Sie den Namen und die Beschreibung des Zugriffstokens ändern.
6. Klicken Sie nach dem Bearbeiten auf Speichern.

Ein Zugriffstoken löschen

STACKIT API

Um eine Instanz des Telemetry Router zu löschen, müssen Sie den DELETE-Endpunkt aufrufen.

stackit curl -X DELETE \
"https://telemetry-router.api.stackit.cloud/v1/projects/$PROJECT_ID/regions/$REGION_ID/telemetry-routers/$TELEMETRY_ROUTER_ID/access-tokens/$ACCESS_TOKEN_ID" \
-H "Content-Type: application/json"

Beispiel:

stackit curl -X DELETE \
"https://telemetry-router.api.stackit.cloud/v1/projects/16dbfb51-7a75-42d3-a51d-99f87f48cd32/regions/eu01/telemetry-routers/d5b5cdcc-c155-4d66-82ef-4289db8e4557/access-tokens/988d3545-68fb-47f2-acd7-b3ea96036ba9" \
-H "Content-Type: application/json"

STACKIT Portal

Führen Sie die Schritte im Portal aus, um ein Telemetry Router-Zugriffstoken zu erstellen.

1. Klicken Sie in der Seitenleiste auf Telemetry Router.
2. Navigieren Sie zu der Instanz, für die Sie ein Zugriffstoken erstellen möchten, und klicken Sie auf den Eintrag.
3. Klicken Sie in der Seitenleiste auf Zugriffstoken.
4. Sie sehen eine Liste aller Zugriffstoken mit ihrem Status. Navigieren Sie zu dem Eintrag, den Sie löschen möchten, und klicken Sie auf das Drei-Punkte-Menü.
5. Klicken Sie im Menü auf Löschen. Geben Sie den Namen des Tokens ein und klicken Sie auf Löschen.