Cómo configurar un token de acceso personal (PAT)

Objetivo

Los tokens de acceso personales (PAT) permiten que un usuario local IAM de OVHcloud se autentique en la API de OVHcloud y en las API backend de los productos sin compartir sus credenciales de acceso. Un PAT es un token bearer cuyos permisos están definidos por las políticas IAM asociadas al usuario.

A diferencia de las credenciales de cuenta de servicio, diseñadas para interacciones máquina a máquina, los PAT están destinados a scripts o aplicaciones que actúan en nombre de un usuario local.

Esta guía explica cómo configurar un token de acceso personal (PAT) para un usuario local IAM de OVHcloud.

Requisitos

• Disponer de una cuenta de cliente OVHcloud.
• Disponer de un usuario local IAM, o de permisos para crear uno.
• Disponer de políticas IAM que concedan al usuario las acciones necesarias para su caso de uso.

Acceso al área de cliente de OVHcloud

• Enlace directo: Identidades IAM
• Ruta de navegación: Identidad, seguridad y operaciones > Identidades

Procedimiento

Comprender los tokens de acceso personales

Los PAT están asociados a una única identidad de usuario local. Cuando utiliza un PAT, las llamadas a la API heredan los derechos de ese usuario según las políticas IAM que se le aplican.

Características principales:

• Esquema de autenticación: token bearer (Authorization: Bearer <token>).
• Caducidad: por defecto, un PAT no caduca. Puede definir opcionalmente una fecha de caducidad al crearlo.
• Revocación: elimine el PAT en cualquier momento para revocar el acceso de forma inmediata.
• Visualización única: el valor del token solo se muestra una vez al crearlo. Guárdelo de forma segura.

Consulte la presentación de identidades.

Crear un token de acceso personal

Sustituya {user} por el identificador de su usuario local (por ejemplo, 1234-567-89/johnsmith).

A través del área de cliente de OVHcloud

A través de la API

A través de la CLI

Desde la página Identidades IAM, haga clic en el botón … al final de la fila del usuario local y seleccione Gestionar los tokens.

En la página Gestionar tokens, haga clic en Añadir un token y complete los campos obligatorios:

Campo	Detalles
Nombre	Un nombre único para identificar el token (por ejemplo, pat-my-script).
Descripción	Una breve descripción del uso previsto del token.
Período de expiración	Opcional. Desactive el interruptor para un token sin caducidad, o defina una duración o una fecha fija.

Haga clic en Crear para generar el token.

Warning

Copie inmediatamente el valor del token y guárdelo en un lugar seguro. No se volverá a mostrar.

Utilice la siguiente llamada a la API:

🇪🇺EU▾

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

Con la siguiente carga útil (introduzca sus propios valores):

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

La API devuelve una respuesta similar a la siguiente:

{
  "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 el valor del campo token de forma segura. No podrá recuperarlo más adelante.

Para definir una fecha de caducidad, añada un campo expiresAt a la carga útil en formato RFC3339 (por ejemplo, "expiresAt": "2026-12-31T23:59:59Z").

Utilice la OVHcloud CLI para crear el PAT:

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

La CLI devuelve el valor del token:

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

Para almacenar el token directamente en una variable de entorno:

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 crear un token que caduque tras una duración determinada, utilice la opción --expiresIn (valor en segundos) o --expiredAt (fecha en formato RFC3339).

Utilizar un token de acceso personal

Utilice el PAT como token bearer en la cabecera Authorization de sus solicitudes HTTP.

Para recuperar la información de su cuenta de OVHcloud:

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

Según la ubicación de su cuenta, utilice el endpoint de API correspondiente:

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

Para las API backend de productos que no admiten el esquema Bearer, puede utilizar la autenticación híbrida prefijando el nombre de usuario con pat_jwt_ y proporcionando el token como contraseña:

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

Sustituya <any_suffix> por una cadena ASCII cualquiera para identificar el token.

Gestionar y revocar tokens

Listar los tokens existentes

A través del área de cliente de OVHcloud

A través de la API

A través de la CLI

En la página Gestionar tokens, se muestra la lista de PAT asociados al usuario.

🇪🇺EU▾

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

ovhcloud iam user token list {user}

Eliminar un token

La eliminación de un PAT impide de forma inmediata su uso para nuevas llamadas a la API.

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

Más información

• Primeros pasos con las API de OVHcloud

Interactúe con nuestra comunidad de usuarios.