--- title: "Jak skonfigurować token dostępu osobistego (PAT)" description: "Dowiedz się, jak tworzyć, używać i unieważniać tokeny dostępu osobistego (PAT) dla lokalnych użytkowników IAM OVHcloud za pośrednictwem Panelu klienta, API lub CLI" url: https://docs.ovhcloud.com/pl/guides/manage-and-operate/iam/configure-personal-access-token-pat lang: pl lastUpdated: 2026-06-24 --- # Jak skonfigurować token dostępu osobistego (PAT) ## Wprowadzenie Tokeny dostępu osobistego (PAT) umożliwiają [lokalnemu użytkownikowi IAM OVHcloud](/pl/guides/account-and-service-management/account-information/ovhcloud-users-management.md) 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](/pl/guides/account-and-service-management/account-information/iam-policy-ui.md) przypisane do użytkownika. W przeciwieństwie do [danych logowania konta usługi](/pl/guides/manage-and-operate/api/manage-service-account.md), 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](/pl/guides/account-and-service-management/account-information/ovhcloud-account-creation.md). - Posiadanie [lokalnego użytkownika IAM](/pl/guides/account-and-service-management/account-information/ovhcloud-users-management.md) lub uprawnień do jego utworzenia. - Posiadanie [polityk IAM](/pl/guides/account-and-service-management/account-information/iam-policy-ui.md) 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 `). - **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](/pl/guides/manage-and-operate/iam/identities-management.md). :::info Jeśli potrzebujesz danych logowania do zautomatyzowanych integracji produkcyjnych niepowiązanych z użytkownikiem ludzkim, użyj [konta usługi](/pl/guides/manage-and-operate/api/manage-service-account.md). ::: ### Utworzenie tokena dostępu osobistego Zastąp `{user}` identyfikatorem użytkownika lokalnego (na przykład `1234-567-89/johnsmith`). **W Panelu klienta OVHcloud** Na stronie Tożsamości IAM kliknij przycisk … na końcu wiersza użytkownika lokalnego, a następnie wybierz Zarządzanie tokenami. ![Opcja Zarządzanie tokenami w menu akcji użytkownika lokalnego](/images/manage-and-operate/iam/configure-personal-access-token-pat/PAT_manage_token_button.png)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ę. | ![Formularz tworzenia tokena z polami nazwa, opis i okres ważności](/images/manage-and-operate/iam/configure-personal-access-token-pat/PAT_creation_form.png)Kliknij Utwórz, aby wygenerować token. :::warning Natychmiast skopiuj wartość tokena i przechowuj ją w bezpiecznym miejscu. Nie będzie wyświetlana ponownie. ::: **Za pomocą API OVHcloud** Użyj następującego wywołania API: 🇪🇺EU▾ [POST/me/identity/user/{user}/token](https://eu.api.ovh.com/console/?section=/me&branch=v1#post-/me/identity/user/-user-/token) Z następującym payloadem (wprowadź własne wartości): ```json { "description": "PAT for my automation script", "name": "pat-my-script" } ``` API zwraca odpowiedź podobną do poniższej: ```json { "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"`). **Za pomocą CLI OVHcloud** Użyj [OVHcloud CLI](/pl/guides/manage-and-operate/cli/getting-started.md), aby utworzyć PAT: ```bash ovhcloud iam user token create {user} \ --name pat-my-script \ --description "PAT for my automation script" ``` CLI zwraca wartość tokena: ```bash ✅ Token pat-my-script created successfully, value: eyJhbGciOiJ... ``` Aby zapisać token bezpośrednio w zmiennej środowiskowej: ```bash 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: ```bash curl -H "Authorization: Bearer " \ 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: ```bash curl -u "pat_jwt_:" \ https://.logs.ovh.com:9200/_cluster/health?pretty ``` Zastąp `` dowolnym ciągiem ASCII identyfikującym token. ### Zarządzanie tokenami i ich unieważnianie #### Wyświetlanie istniejących tokenów **W Panelu klienta OVHcloud** Na stronie **Zarządzanie tokenami** wyświetlana jest lista PAT przypisanych do użytkownika. ![Strona Zarządzanie tokenami z listą tokenów dostępu osobistego użytkownika lokalnego](/images/manage-and-operate/iam/configure-personal-access-token-pat/PAT_Manage_token.png) **Za pomocą API OVHcloud** 🇪🇺EU▾ [GET/me/identity/user/{user}/token](https://eu.api.ovh.com/console/?section=/me&branch=v1#get-/me/identity/user/-user-/token) **Za pomocą CLI OVHcloud** ```bash ovhcloud iam user token list {user} ``` #### Usunięcie tokena Usunięcie PAT natychmiast uniemożliwia jego dalsze wykorzystanie w wywołaniach API. **W Panelu klienta OVHcloud** Na stronie **Zarządzanie tokenami** kliknij przycisk … na końcu wiersza tokena, a następnie wybierz Usuń. Kliknij Usuń w oknie potwierdzenia, aby unieważnić token. **Za pomocą API OVHcloud** 🇪🇺EU▾ [DELETE/me/identity/user/{user}/token/{name}](https://eu.api.ovh.com/console/?section=/me&branch=v1#delete-/me/identity/user/-user-/token/-name-) Zastąp `{name}` nazwą tokena (na przykład `pat-my-script`). **Za pomocą CLI OVHcloud** ```bash ovhcloud iam user token delete {user} pat-my-script ``` ## Sprawdź również - [Pierwsze kroki z API OVHcloud](/pl/guides/manage-and-operate/api/first-steps.md) Dołącz do [grona naszych użytkowników](https://community.ovhcloud.com/).