Como configurar um token de acesso pessoal (PAT)

Objetivo

Os tokens de acesso pessoal (PAT) permitem que um utilizador local IAM da OVHcloud se autentique na API da OVHcloud e nas API backend dos produtos sem partilhar as suas credenciais de acesso. Um PAT é um token bearer cujas permissões são definidas pelas políticas IAM associadas ao utilizador.

Ao contrário das credenciais de conta de serviço, concebidas para interações máquina a máquina, os PAT destinam-se a scripts ou aplicações que atuam em nome de um utilizador local.

Este guia explica como configurar um token de acesso pessoal (PAT) para um utilizador local IAM da OVHcloud.

Requisitos

• Ter uma conta de cliente OVHcloud.
• Ter um utilizador local IAM, ou permissões para criar um.
• Ter políticas IAM que concedam ao utilizador as ações necessárias para o seu caso de uso.

Acesso à Área de Cliente OVHcloud

• Ligação direta: Identidades IAM
• Caminho de navegação: Identidade, Segurança e Operações > Identidades

Instruções

Compreender os tokens de acesso pessoal

Os PAT estão associados a uma única identidade de utilizador local. Quando utiliza um PAT, as chamadas API herdam os direitos desse utilizador de acordo com as políticas IAM que lhe são aplicadas.

Características principais:

• Esquema de autenticação: token bearer (Authorization: Bearer <token>).
• Expiração: por predefinição, um PAT não expira. Pode opcionalmente definir uma data de expiração aquando da criação.
• Revogação: elimine o PAT a qualquer momento para revogar imediatamente o acesso.
• Apresentação única: o valor do token só é apresentado uma vez na criação. Guarde-o de forma segura.

Consulte a apresentação das identidades.

Criar um token de acesso pessoal

Substitua {user} pelo identificador do seu utilizador local (por exemplo, 1234-567-89/johnsmith).

Via Área de Cliente OVHcloud

Via API OVHcloud

Via CLI OVHcloud

Na página Identidades IAM, clique no botão … no final da linha do utilizador local e selecione Gerir os tokens.

Na página Manage Tokens, clique em Adicionar um token e preencha os campos obrigatórios:

Campo	Detalhes
Nome	Um nome único para identificar o token (por exemplo, pat-my-script).
Descrição	Uma breve descrição da utilização prevista do token.
Duração de expiração	Opcional. Desative o interruptor para um token sem expiração, ou defina uma duração ou uma data fixa.

Clique em Criar para gerar o token.

Warning

Copie imediatamente o valor do token e guarde-o num local seguro. Não será apresentado novamente.

Utilize a seguinte chamada API:

🇪🇺EU▾

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

Com a seguinte carga útil (preencha com os seus valores):

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

A API devolve uma resposta semelhante à seguinte:

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

Warning

Guarde o valor do campo token de forma segura. Não será possível recuperá-lo mais tarde.

Para definir uma data de expiração, adicione um campo expiresAt à carga útil no formato RFC3339 (por exemplo, "expiresAt": "2026-12-31T23:59:59Z").

Utilize a OVHcloud CLI para criar o PAT:

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

A CLI devolve o valor do token:

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

Para armazenar o token diretamente numa variável de 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

Para criar um token que expire após uma duração definida, utilize a opção --expiresIn (valor em segundos) ou --expiredAt (data no formato RFC3339).

Utilizar um token de acesso pessoal

Utilize o PAT como token bearer no cabeçalho Authorization dos seus pedidos HTTP.

Para recuperar as informações da sua conta OVHcloud:

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

Consoante a localização da sua conta, utilize o endpoint API adequado:

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

Para API backend de produtos que não suportam o esquema Bearer, pode utilizar autenticação híbrida prefixando o nome de utilizador com pat_jwt_ e fornecendo o token como palavra-passe:

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

Substitua <any_suffix> por uma cadeia ASCII qualquer para identificar o token.

Gerir e revogar tokens

Listar tokens existentes

Via Área de Cliente OVHcloud

Via API OVHcloud

Via CLI OVHcloud

Na página Manage Tokens, é apresentada a lista de PAT associados ao utilizador.

🇪🇺EU▾

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

ovhcloud iam user token list {user}

Eliminar um token

A eliminação de um PAT impede imediatamente a sua utilização para novas chamadas API.

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

Quer saber mais?

• Primeiros passos com as API OVHcloud

Fale com a nossa comunidade de utilizadores.