Jak skonfigurować token dostępu osobistego (PAT)

Wprowadzenie

Tokeny dostępu osobistego (PAT) umożliwiają lokalnemu użytkownikowi IAM OVHcloud uwierzytelnianie się w API OVHcloud i backendowych API produktów bez udostępniania danych logowania. PAT to token bearer, którego uprawnienia są określone przez polityki IAM przypisane do użytkownika.

W przeciwieństwie do danych logowania konta usługi, przeznaczonych do interakcji maszyna-maszyna, PAT są przeznaczone dla skryptów lub aplikacji działających w imieniu użytkownika lokalnego.

Ten przewodnik wyjaśnia, jak skonfigurować token dostępu osobistego (PAT) dla lokalnego użytkownika IAM OVHcloud.

Wymagania początkowe

• Posiadanie konta klienta OVHcloud.
• Posiadanie lokalnego użytkownika IAM lub uprawnień do jego utworzenia.
• Posiadanie polityk IAM przyznających użytkownikowi akcje wymagane w Twoim przypadku użycia.

Dostęp do Panelu klienta OVHcloud

• Link bezpośredni: Tożsamości IAM
• Ścieżka nawigacji: Tożsamość, bezpieczeństwo i operacje > Tożsamości

W praktyce

Zrozumienie tokenów dostępu osobistego

PAT są powiązane z jedną tożsamością użytkownika lokalnego. Gdy używasz PAT, wywołania API dziedziczą uprawnienia tego użytkownika zgodnie z przypisanymi mu politykami IAM.

Główne cechy:

• Schemat uwierzytelniania: token bearer (Authorization: Bearer <token>).
• Wygaśnięcie: domyślnie PAT nie wygasa. Opcjonalnie możesz ustawić datę wygaśnięcia podczas tworzenia.
• Unieważnienie: usuń PAT w dowolnym momencie, aby natychmiast cofnąć dostęp.
• Jednorazowe wyświetlenie: wartość tokena jest pokazywana tylko raz podczas tworzenia. Przechowuj ją w bezpiecznym miejscu.

Zapoznaj się z prezentacją tożsamości.

Utworzenie tokena dostępu osobistego

Zastąp {user} identyfikatorem użytkownika lokalnego (na przykład 1234-567-89/johnsmith).

W Panelu klienta OVHcloud

Za pomocą API OVHcloud

Za pomocą CLI OVHcloud

Na stronie Tożsamości IAM kliknij przycisk … na końcu wiersza użytkownika lokalnego, a następnie wybierz Zarządzanie tokenami.

Na stronie Zarządzanie tokenami kliknij Dodaj token, a następnie uzupełnij wymagane pola:

Pole	Szczegóły
Nazwa	Unikalna nazwa identyfikująca token (na przykład pat-my-script).
Opis	Krótki opis planowanego wykorzystania tokena.
Okres ważności	Opcjonalnie. Wyłącz przełącznik, aby utworzyć token bez daty wygaśnięcia, lub ustaw czas trwania albo stałą datę.

Kliknij Utwórz, aby wygenerować token.

Warning

Natychmiast skopiuj wartość tokena i przechowuj ją w bezpiecznym miejscu. Nie będzie wyświetlana ponownie.

Użyj następującego wywołania API:

🇪🇺EU▾

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

Z następującym payloadem (wprowadź własne wartości):

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

API zwraca odpowiedź podobną do poniższej:

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

Warning

Bezpiecznie zapisz wartość pola token. Nie będzie można jej później odzyskać.

Aby ustawić datę wygaśnięcia, dodaj pole expiresAt do payloadu w formacie RFC3339 (na przykład "expiresAt": "2026-12-31T23:59:59Z").

Użyj OVHcloud CLI, aby utworzyć PAT:

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

CLI zwraca wartość tokena:

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

Aby zapisać token bezpośrednio w zmiennej środowiskowej:

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

Aby utworzyć token wygasający po określonym czasie, użyj opcji --expiresIn (wartość w sekundach) lub --expiredAt (data w formacie RFC3339).

Użycie tokena dostępu osobistego

Użyj PAT jako tokena bearer w nagłówku Authorization żądań HTTP.

Aby pobrać informacje o koncie OVHcloud:

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

W zależności od lokalizacji konta użyj odpowiedniego endpointu API:

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

W przypadku backendowych API produktów, które nie obsługują schematu Bearer, możesz użyć uwierzytelniania hybrydowego, dodając prefiks pat_jwt_ do nazwy użytkownika i podając token jako hasło:

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

Zastąp <any_suffix> dowolnym ciągiem ASCII identyfikującym token.

Zarządzanie tokenami i ich unieważnianie

Wyświetlanie istniejących tokenów

W Panelu klienta OVHcloud

Za pomocą API OVHcloud

Za pomocą CLI OVHcloud

Na stronie Zarządzanie tokenami wyświetlana jest lista PAT przypisanych do użytkownika.

🇪🇺EU▾

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

ovhcloud iam user token list {user}

Usunięcie tokena

Usunięcie PAT natychmiast uniemożliwia jego dalsze wykorzystanie w wywołaniach API.

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

Sprawdź również

• Pierwsze kroki z API OVHcloud

Dołącz do grona naszych użytkowników.