Come configurare un token di accesso personale (PAT)

Obiettivo

I token di accesso personali (PAT) consentono a un utente locale IAM OVHcloud di autenticarsi presso l'API OVHcloud e le API backend dei prodotti senza condividere le proprie credenziali di accesso. Un PAT è un token bearer i cui permessi sono definiti dalle politiche IAM associate all'utente.

A differenza delle credenziali di account di servizio, concepite per interazioni macchina a macchina, i PAT sono destinati a script o applicazioni che agiscono per conto di un utente locale.

Questa guida spiega come configurare un token di accesso personale (PAT) per un utente locale IAM OVHcloud.

Prerequisiti

• Disporre di un account cliente OVHcloud.
• Disporre di un utente locale IAM, o dei permessi per crearne uno.
• Disporre di politiche IAM che concedano all'utente le azioni necessarie per il tuo caso d'uso.

Accesso allo Spazio Cliente OVHcloud

• Link diretto: Identità IAM
• Percorso di navigazione: Identità, sicurezza e operazioni > Identità

Procedura

Comprendere i token di accesso personali

I PAT sono associati a una singola identità di utente locale. Quando utilizzi un PAT, le chiamate API ereditano i diritti di quell'utente in base alle politiche IAM a lui applicate.

Caratteristiche principali:

• Schema di autenticazione: token bearer (Authorization: Bearer <token>).
• Scadenza: per impostazione predefinita, un PAT non scade. Puoi opzionalmente definire una data di scadenza al momento della creazione.
• Revoca: elimina il PAT in qualsiasi momento per revocare immediatamente l'accesso.
• Visualizzazione unica: il valore del token viene mostrato una sola volta alla creazione. Conservalo in modo sicuro.

Consulta la presentazione delle identità.

Creare un token di accesso personale

Sostituisci {user} con l'identificativo del tuo utente locale (ad esempio, 1234-567-89/johnsmith).

Attraverso lo Spazio Cliente OVHcloud

Attraverso l'API OVHcloud

Attraverso la CLI OVHcloud

Dalla pagina Identità IAM, clicca sul pulsante … alla fine della riga dell'utente locale, quindi seleziona Gestire i token.

Nella pagina Gestire i token, clicca su Aggiungere un token, quindi compila i campi obbligatori:

Campo	Dettagli
Nome	Un nome univoco per identificare il token (ad esempio, pat-my-script).
Descrizione	Una breve descrizione dell'utilizzo previsto del token.
Data di scadenza	Facoltativo. Disattiva l'interruttore per un token senza scadenza, oppure imposta una durata o una data fissa.

Clicca su Crea per generare il token.

Warning

Copia immediatamente il valore del token e conservalo in un luogo sicuro. Non verrà più visualizzato.

Utilizza la seguente chiamata API:

🇪🇺EU▾

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

Con il seguente payload (inserisci i tuoi valori):

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

L'API restituisce una risposta simile alla seguente:

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

Warning

Conserva il valore del campo token in modo sicuro. Non potrai più recuperarlo in seguito.

Per definire una data di scadenza, aggiungi un campo expiresAt al payload in formato RFC3339 (ad esempio, "expiresAt": "2026-12-31T23:59:59Z").

Utilizza l'OVHcloud CLI per creare il PAT:

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

La CLI restituisce il valore del token:

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

Per memorizzare il token direttamente in una variabile d'ambiente:

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

Per creare un token che scada dopo una durata definita, utilizza l'opzione --expiresIn (valore in secondi) o --expiredAt (data in formato RFC3339).

Utilizzare un token di accesso personale

Utilizza il PAT come token bearer nell'header Authorization delle tue richieste HTTP.

Per recuperare le informazioni del tuo account OVHcloud:

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

A seconda della localizzazione del tuo account, utilizza l'endpoint API appropriato:

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

Per le API backend dei prodotti che non supportano lo schema Bearer, puoi utilizzare l'autenticazione ibrida prefissando il nome utente con pat_jwt_ e fornendo il token come password:

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

Sostituisci <any_suffix> con una stringa ASCII qualsiasi per identificare il token.

Gestire e revocare i token

Elencare i token esistenti

Attraverso lo Spazio Cliente OVHcloud

Attraverso l'API OVHcloud

Attraverso la CLI OVHcloud

Nella pagina Gestire i token, vengono elencati tutti i PAT associati all'utente.

🇪🇺EU▾

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

ovhcloud iam user token list {user}

Eliminare un token

L'eliminazione di un PAT impedisce immediatamente il suo utilizzo per ulteriori chiamate API.

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

Per saperne di più

• Iniziare a utilizzare le API OVHcloud

Contatta la nostra Community di utenti.