Bare-Metal-Server-Identitätszugriffstoken-Konzepte

Ein Bare-Metal-Server-Identitätszugriffstoken bietet eine Sicherheitsberechtigung für den Zugriff auf den Metadatendienst. Es handelt sich um ein signiertes Token mit einer Reihe von Claims, die auf Informationen zum Bare-Metal-Server sowie auf Informationen basieren, die in der Token-Anfrage übermittelt werden.

Um auf die Bare-Metal-Server-Identität zuzugreifen, führen Sie einen PUT "http://api.metadata.cloud.ibm.com /identity/v1/token-Aufruf durch, indem Sie die API des Metadatendienstes verwenden, die den Hostnamen des Bare-Metal-Servers aufruft. Die Kommunikation zwischen dem Bare-Metal-Server und dem Metadatendienst verlässt nie den Host. Sie erwerben das Token innerhalb des Bare Metal Servers. Wenn der sichere Zugriff auf den Bare-Metal-Server-Metadatendienst auf Ihrem Bare-Metal-Server aktiviert ist, verwenden Sie das Protokoll https anstelle des Protokolls http.

In der Anfrage geben Sie eine Verfallszeit für das Token an. Die Standardeinstellung beträgt 5 Minuten, Sie können jedoch festlegen, dass die Gültigkeit früher oder später abläuft (5 Sekunden bis 1 Stunde).

Die Antwort (eine JSON-Nutzlast) enthält das Zugriffstoken für den Bare-Metal-Server. Verwenden Sie das Token, um auf den Metadatenservice zuzugreifen.

Sie können aus diesem Token auch ein IAM-Token generieren und die API nutzen, um IAM-fähige Dienste aufzurufen. Weitere Informationen finden Sie unter Erzeugen eines IAM-Tokens aus einem Bare-Metal-Server-Identitätszugriffstoken.

Erwerb eines Bare-Metal-Server-Identitätszugriffstokens

Rufen Sie über die API des Metadatendienstes PUT "http://api.metadata.cloud.ibm.com /identity/v1/token auf, um ein Bare-Metal-Server-Identitätszugriffstoken zu erhalten. Im folgenden Beispiel wird verwendet, um jq die JSON-API-Antwort zu analysieren und anschließend den Wert des Identitätszugriffstokens für den Bare-Metal-Server zu extrahieren. Sie können Ihren bevorzugten JSON-Parser verwenden.

Im Beispiel ist der Rückgabewert des CURL-Befehls das Identitätszugriffstoken des Bare-Metal-Servers, das extrahiert und jq in die identity_token Umgebungsvariable abgelegt wird. Sie verwenden diese Variable in einem GET-Aufruf an den Metadatenservice, um den Metadatenendpunkt zu erreichen. Weitere Informationen finden Sie unter Abrufen von Metadaten von Ihrem laufenden Bare-Metal-Server.

Im Beispiel wird jq als Parser verwendet, ein Drittanbietertool, das unter der MIT-Lizenz lizenziert wird. Einige Betriebssysteme enthalten dies standardmäßig jq nicht. Installieren Sie diese vor jq der Verwendung oder verwenden Sie einen anderen JSON-Parser.

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)'`

Die folgende JSON-Antwort enthält die Zeichenfolge des Identitätszugriffstokens für den Bare-Metal-Server sowie Datum und Uhrzeit der Erstellung, Datum und Uhrzeit des Ablaufs und die von Ihnen festgelegte Ablaufzeit. Denken Sie daran, dass der Token in 5 Minuten abläuft.

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