Conceptos de token de acceso a la identidad del servidor de metal desnudo

Un token de acceso a la identidad del servidor bare metal proporciona una credencial de seguridad para acceder al servicio de metadatos. Se trata de un token firmado con un conjunto de reclamaciones basadas en la información sobre el servidor bare metal y en la información que se transmite en la solicitud del token.

Para acceder a la identidad del servidor bare metal, realice una llamada a PUT "http://api.metadata.cloud.ibm.com /identity/v1/token utilizando la API del servicio de metadatos que invoca el nombre de host del servidor bare metal. La comunicación entre el servidor bare metal y el servicio de metadatos nunca sale del host. El token se adquiere desde el servidor bare metal. Si el acceso seguro al servicio de metadatos del servidor bare metal está activado en el servidor bare metal, utilice el protocolo https en lugar del protocolo http.

En la solicitud, se especifica una fecha de caducidad para el token. El valor por defecto es de 5 minutos, pero puedes especificar que caduque antes o después (entre 5 segundos y 1 hora).

La respuesta (una carga JSON) contiene el token de acceso de identidad del servidor bare metal. Utilice esta señal para acceder al servicio de metadatos.

También puede generar un token de IAM a partir de este token y utilizar la API para llamar a servicios compatibles con IAM. Para obtener más información, consulte Generación de un token de IAM a partir de un token de acceso a la identidad de un servidor bare metal.

Adquisición de un token de acceso a la identidad de un servidor bare metal

Utilizando la API del servicio de metadatos, realice una llamada a PUT "http://api.metadata.cloud.ibm.com /identity/v1/token para obtener un token de acceso a la identidad del servidor bare metal. En el siguiente ejemplo se utiliza jq para analizar la respuesta de la API JSON y, a continuación, extraer el valor del token de acceso de identidad del servidor físico. Puede utilizar su analizador JSON favorito.

En el ejemplo, el valor devuelto por el comando CURL es el token de acceso de identidad del servidor bare metal, que se extrae mediante jq y se coloca en la variable de entorno identity_token. Esta variable se especifica en una llamada de GET al servicio de metadatos para alcanzar el punto final de metadatos. Para obtener más información, consulte Recuperar metadatos de su servidor bare metal en ejecución.

El ejemplo utiliza jq como analizador, una herramienta de terceros con licencia de MIT. Algunos sistemas operativos no lo incluyen de jq forma predeterminada. Instálalo jq antes de utilizarlo o sustitúyelo por otro analizador JSON.

identity_token=`curl -X PUT "http://api.metadata.cloud.ibm.com /identity/v1/token?version=2025-06-30"\
  -H "Metadata-Flavor: ibm"\
  -d '{
        "expires_in": 3600
      }' | jq -r '(.access_token)'`

La siguiente respuesta JSON muestra la cadena de caracteres del token de acceso de identidad del servidor bare metal, la fecha y la hora en que se creó, la fecha y la hora en que caduca, y la hora de caducidad que has establecido. Ten en cuenta que el token caduca en 5 minutos.

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IlZTSS1DUl91cy1lYXN0X2I5...",
  "created_at": "2022-08-08T11:08:39.363Z",
  "expires_at": "2022-08-08T11:13:39.363Z",
  "expires_in": 3600
}