Concetti di token di accesso all'identità del server Bare Metal

Un token di accesso all'identità del server bare metal fornisce una credenziale di sicurezza per l'accesso al servizio di metadati. Si tratta di un token firmato con una serie di richieste basate sulle informazioni del server bare metal e sulle informazioni trasmesse nella richiesta del token.

Per accedere all'identità del server bare metal, effettuare una chiamata a PUT "http://api.metadata.cloud.ibm.com /identity/v1/token utilizzando l'API del servizio Metadata che richiama il nome host del server bare metal. La comunicazione tra il server bare metal e il servizio di metadati non si allontana mai dall'host. Il token viene acquisito dal server bare metal. Se l'accesso sicuro al servizio di metadati del server bare metal è abilitato sul server bare metal, utilizzare il protocollo https invece del protocollo http.

Nella richiesta, si specifica un tempo di scadenza per il token. L'impostazione predefinita è di 5 minuti, ma è possibile specificare che la scadenza sia anticipata o posticipata (da 5 secondi a 1 ora).

La risposta (un payload JSON) contiene il token di accesso all'identità del server bare metal. Utilizzare questo token per accedere al servizio di metadati.

È anche possibile generare un token IAM da questo token e utilizzare l'API per chiamare i servizi abilitati IAM. Per ulteriori informazioni, vedere Generazione di un token IAM da un token di accesso all'identità di un server bare metal.

Acquisizione di un token di accesso all'identità di un server bare metal

Utilizzando l'API del servizio Metadata, effettuare una chiamata a PUT "http://api.metadata.cloud.ibm.com /identity/v1/token per ottenere un token di accesso all'identità del server bare metal. L'esempio seguente utilizza jq per analizzare la risposta API JSON e quindi estrarre il valore del token di accesso all'identità del server bare metal. È possibile utilizzare il parser JSON preferito.

Nell'esempio, il valore di ritorno del comando CURL è il token di accesso all'identità del server bare metal, che viene estratto da jq e inserito nella variabile d'ambiente identity_token. Si usa specificare questa variabile in una chiamata GET al servizio di metadati per raggiungere l'endpoint dei metadati. Per ulteriori informazioni, vedere Recuperare i metadati dal server bare metal in esecuzione.

L'esempio utilizza jq come parser, uno strumento di terze parti distribuito sotto licenza MIT. Alcuni sistemi operativi non includono di default il programma “ jq ”. Prima dell'uso, installare jq oppure sostituirlo con un altro parser 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 seguente risposta JSON mostra la stringa di caratteri del token di accesso all'identità del server bare metal, la data e l'ora di creazione, la data e l'ora di scadenza e il tempo di scadenza impostato. Tenete presente che il token scade tra 5 minuti.

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