So konfigurieren Sie ein Personal Access Token (PAT)

Ziel

Personal Access Tokens (PATs) ermöglichen es einem lokalen IAM-Benutzer von OVHcloud, sich bei der OVHcloud API und den Backend-APIs der Produkte zu authentifizieren, ohne seine Anmeldedaten weiterzugeben. Ein PAT ist ein Bearer-Token, dessen Berechtigungen durch die dem Benutzer zugeordneten IAM-Richtlinien definiert werden.

Im Gegensatz zu Service-Account-Zugangsdaten, die für Machine-to-Machine-Interaktionen konzipiert sind, sind PATs für Skripte oder Anwendungen gedacht, die im Namen eines lokalen Benutzers handeln.

Diese Anleitung erklärt, wie Sie ein Personal Access Token (PAT) für einen lokalen IAM-Benutzer von OVHcloud konfigurieren.

Voraussetzungen

• Sie verfügen über einen OVHcloud Kunden-Account.
• Sie verfügen über einen lokalen IAM-Benutzer oder über die Berechtigung, einen solchen zu erstellen.
• Sie verfügen über IAM-Richtlinien, die dem Benutzer die für Ihren Anwendungsfall erforderlichen Aktionen gewähren.

Zugriff auf das OVHcloud Kundencenter

• Direkter Link: IAM Identitäten
• Navigationspfad: Identität, Sicherheit und Operationen > Identitäten

In der praktischen Anwendung

Personal Access Tokens verstehen

PATs sind mit einer einzigen lokalen Benutzeridentität verknüpft. Wenn Sie ein PAT verwenden, erben API-Aufrufe die Rechte dieses Benutzers gemäß den auf ihn angewendeten IAM-Richtlinien.

Wesentliche Merkmale:

• Authentifizierungsschema: Bearer-Token (Authorization: Bearer <token>).
• Ablauf: Standardmäßig läuft ein PAT nicht ab. Sie können optional ein Ablaufdatum bei der Erstellung festlegen.
• Widerruf: Löschen Sie das PAT jederzeit, um den Zugriff sofort zu widerrufen.
• Einmalige Anzeige: Der Tokenwert wird nur einmal bei der Erstellung angezeigt. Bewahren Sie ihn sicher auf.

Weitere Informationen finden Sie in der Dokumentation zur Identitätsverwaltung.

Personal Access Token erstellen

Ersetzen Sie {user} durch die Anmeldung Ihres lokalen Benutzers (zum Beispiel 1234-567-89/johnsmith).

Über das OVHcloud Kundencenter

Über die OVHcloud API

Über die OVHcloud CLI

Rufen Sie auf der Seite IAM Identitäten am Ende der Zeile des lokalen Benutzers auf die Schaltfläche … und wählen Sie Token verwalten.

Klicken Sie auf der Seite Token verwalten auf Token hinzufügen und füllen Sie die erforderlichen Felder aus:

Feld	Details
Name	Ein eindeutiger Name zur Identifizierung des Tokens (zum Beispiel pat-my-script).
Beschreibung	Eine kurze Beschreibung der Verwendung des Tokens.
Ablaufdauer	Optional. Deaktivieren Sie den Schalter für ein Token ohne Ablaufdatum, oder legen Sie eine Dauer oder ein festes Datum fest.

Klicken Sie auf Erstellen, um das Token zu generieren.

Warning

Kopieren Sie den Tokenwert sofort und speichern Sie ihn an einem sicheren Ort. Er wird nicht erneut angezeigt.

Verwenden Sie den folgenden API-Aufruf:

🇪🇺EU▾

POST/me/identity/user/{user}/token

Mit folgender Payload (füllen Sie Ihre eigenen Werte ein):

{
  "description": "PAT for my automation script",
  "name": "pat-my-script"
}

Die API liefert eine Antwort in folgendem Format:

{
  "creation": "2025-11-13T10:38:44.658926311Z",
  "description": "PAT for my automation script",
  "expiresAt": null,
  "lastUsed": null,
  "name": "pat-my-script",
  "token": "eyJhbGciOiJ..."
}

Warning

Speichern Sie den Wert des Felds token sicher. Er kann später nicht mehr abgerufen werden.

Um ein Ablaufdatum festzulegen, fügen Sie der Payload ein Feld expiresAt im RFC3339-Format hinzu (zum Beispiel "expiresAt": "2026-12-31T23:59:59Z").

Verwenden Sie die OVHcloud CLI, um das PAT zu erstellen:

ovhcloud iam user token create {user} \
  --name pat-my-script \
  --description "PAT for my automation script"

Die CLI gibt den Tokenwert zurück:

✅ Token pat-my-script created successfully, value: eyJhbGciOiJ...

Um das Token direkt in einer Umgebungsvariable zu speichern:

PAT_TOKEN=$(ovhcloud iam user token create {user} \
  --name pat-my-script \
  --description "PAT for my automation script" \
  -o json | jq -r .details.token)
echo $PAT_TOKEN

Um ein Token zu erstellen, das nach einer festgelegten Dauer abläuft, verwenden Sie die Option --expiresIn (Wert in Sekunden) oder --expiredAt (RFC3339-Datum).

Personal Access Token verwenden

Verwenden Sie das PAT als Bearer-Token im Header Authorization Ihrer HTTP-Anfragen.

So rufen Sie Informationen zu Ihrem OVHcloud Kunden-Account ab:

curl -H "Authorization: Bearer <your_pat>" \
  https://eu.api.ovh.com/1.0/me

Je nach Standort Ihres Accounts verwenden Sie den entsprechenden API-Endpunkt:

• EU: https://eu.api.ovh.com/1.0/
• CA: https://ca.api.ovh.com/1.0/

Für Backend-APIs von Produkten, die das Bearer-Schema nicht unterstützen, können Sie eine hybride Authentifizierung verwenden, indem Sie den Benutzernamen mit pat_jwt_ prefixen und das Token als Passwort angeben:

curl -u "pat_jwt_<any_suffix>:<your_pat>" \
  https://<your_cluster>.logs.ovh.com:9200/_cluster/health?pretty

Ersetzen Sie <any_suffix> durch eine beliebige ASCII-Zeichenkette zur Identifizierung des Tokens.

Tokens verwalten und widerrufen

Vorhandene Tokens auflisten

Über das OVHcloud Kundencenter

Über die OVHcloud API

Über die OVHcloud CLI

Auf der Seite Token verwalten werden alle dem Benutzer zugeordneten PATs aufgelistet.

🇪🇺EU▾

GET/me/identity/user/{user}/token

ovhcloud iam user token list {user}

Token löschen

Das Löschen eines PAT verhindert sofort weitere API-Aufrufe mit diesem Token.

ovhcloud iam user token delete {user} pat-my-script

Weiterführende Informationen

• Erste Schritte mit der OVHcloud API

Treten Sie unserer User Community bei.