Concepts de jetons d'accès à l'identité d'un serveur bare metal

Un jeton d'accès à l'identité du serveur bare metal fournit un justificatif de sécurité pour l'accès au service de métadonnées. Il s'agit d'un jeton signé contenant un ensemble de revendications basées sur les informations relatives au serveur bare metal et sur les informations transmises dans la requête de jeton.

Pour accéder à l'identité du serveur bare metal, faites un appel à PUT "http://api.metadata.cloud.ibm.com /identity/v1/token en utilisant l'API du service de métadonnées qui invoque le nom d'hôte du serveur bare metal. La communication entre le serveur bare metal et le service de métadonnées ne quitte jamais l'hôte. Vous obtenez le jeton à partir du serveur bare metal. Si l'accès sécurisé au service de métadonnées du serveur bare metal est activé sur votre serveur bare metal, utilisez le protocole https au lieu du protocole http.

Dans la demande, vous indiquez un délai d'expiration pour le jeton. La durée par défaut est de 5 minutes, mais vous pouvez définir une durée plus courte ou plus longue (de 5 secondes à 1 heure).

La réponse (une charge utile JSON) contient le jeton d'accès d'identité du serveur bare metal. Utilisez ce jeton pour accéder au service de métadonnées.

Vous pouvez également générer un jeton IAM à partir de ce jeton et utiliser l'API pour appeler des services compatibles avec IAM. Pour plus d'informations, voir Générer un jeton IAM à partir d'un jeton d'accès à l'identité d'un serveur bare metal.

Acquisition d'un jeton d'accès à l'identité d'un serveur bare metal

À l'aide de l'API du service de métadonnées, faites un appel à PUT "http://api.metadata.cloud.ibm.com /identity/v1/token pour obtenir un jeton d'accès à l'identité du serveur bare metal. L'exemple suivant utilise jq pour analyser la réponse JSON de l'API, puis extraire la valeur du jeton d'accès d'identité du serveur bare metal. Vous pouvez utiliser votre analyseur syntaxique JSON préféré.

Dans l’exemple, la valeur renvoyée par la commande CURL est le jeton d’accès d’identité du serveur bare metal, qui est extrait par jq et placé dans la variable d’environnement identity_token. Utilisez cette variable dans un appel GET au service de métadonnées pour atteindre le point de terminaison métadonnées. Pour plus d'informations, voir Récupérer les métadonnées de votre serveur bare metal en cours d'exécution.

L'exemple utilise jq comme analyseur syntaxique, un outil tiers sous licence MIT. Certains systèmes d'exploitation ne l'incluent pas par jq défaut. Installez-le avant jq utilisation ou remplacez-le par un autre analyseur 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 réponse JSON suivante indique la chaîne de caractères du jeton d'accès d'identité du serveur bare metal, la date et l'heure de sa création, la date et l'heure de son expiration, ainsi que l'heure d'expiration que vous avez définie. N'oubliez pas que le jeton expire dans 5 minutes.

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