仮想サーバー・インスタンス・コンピュート・リソース ID としてのログイン

トラステッド・プロファイルを使用して、コンピュート・リソース内で実行中のアプリケーション用に微細化された許可をセットアップできます。 その結果、コンピュート・リソース用にサービス ID や API キーを作成する必要がなくなります。 IBM Cloud CLI は、 IBM Cloud Virtual Server Instance (VSI) for VPC compute resource を使用して、 IBM Cloud へのログインと認証をサポートします。

トラステッド・プロファイルの管理、およびコンピュート・リソースとの信頼の確立について詳しくは、コンピュート・リソースとの信頼の確立を参照してください。

CLI を使用したログイン

IBM Cloud CLI で VPC コンピュート・リソース ID ログイン・フィーチャーのために仮想サーバー・インスタンスを使用するには、VSI 上の VPC サービス用のインスタンス・メタデータ・サービスを有効にして、インスタンスをトラステッド・プロファイルにリンクする必要があります。 インスタンス・メタデータ・サービスの有効化について詳しくは、VPC 用のインスタンス・メタデータについてを参照してください。 有効化され、VSI が信頼されたプロファイルにリンクされると、CLI は Instance Identity token service を使用して JSON Web トークンを取得し、IAM トークンと交換できる。

ibmcloud ks cluster config を含む VPC コンピュート・リソースとしてログインしている場合、特定の IBM Cloud Kubernetes Service CLI コマンドは現在サポートされていません。

CLI を使用したログイン

VPC VSI オプションを使用してログインする場合、オプションで、ログイン時に入力するトラステッド・プロファイル・パラメーターを指定できます。 提供された場合、CLI は IBM Cloud への認証にこの信頼されたプロファイルを使用します。 そうでない場合は、インスタンスのプロビジョニング中にリンクされた、VSIのデフォルトのリンクされた信頼できるプロファイルが使用される。

CLIを使用して、以下のいずれかの方法でVSIコンピュートリソースとしてログインできます：

  • トラステッド・プロファイルをパラメーターで指定します。

    1. --vpc-cri オプションを ibmcloud login コマンドに指定します。
    2. --profile オプションを ibmcloud login コマンドに指定して、インスタンスがリンクされているトラステッド IAM プロファイルの ID または CRN を入力します。
    ibmcloud login --vpc-cri --profile <profile_id_or_crn_string>

  • IBMCLOUD_CR_PROFILE 環境変数を使用して、信頼できるプロファイルを提供する。

    システムで環境変数を設定することにより、トラステッド・プロファイルを入力することができます。 例えば、IBMCLOUD_CR_PROFILE=profile_id_or_crn と設定します。ここで、profile_id_or_crn は、VSI がリンクされている IAM トラステッド・プロファイルの ID または CRN です。 環境変数を設定した後は、CLI から ibmcloud login --vpc-cri を指定するだけです。

  • 仮想サービス・インスタンスのデフォルトのリンク済みトラステッド・プロファイルを使用します。

    1. --vpc-cri オプションを ibmcloud login コマンドに指定します。
    ibmcloud login --vpc-cri

VPC インスタンス・メタデータ・サービスが セキュア・アクセス用に設定されている場合は、環境変数 IBMCLOUD_CR_VPC_URL=https://api.metadata.cloud.ibm.com を設定して、ログイン前にサービスのデフォルト URL を上書きしてください。

VPC用のプライベートエンドポイントを使用してVSIコンピュートリソースとしてログインしたい場合は、 --vpc フラグを指定し、APIエンドポイントを に設定する必要があります。 を指定し、APIエンドポイントを private.cloud.ibm.com に設定する必要があります。 この例では、信頼されたプロファイルは環境変数 IBMCLOUD_CR_PROFILE=profile_id_or_crn を設定することで提供される：

  ibmcloud login --vpc-cri --vpc -a private.cloud.ibm.com

プライベート・エンドポイントを使用した CLI へのログインについて詳しくは、プライベート・エンドポイントを使用した CLI へのログインを参照してください。 プライベート API エンドポイントを使用するための VPC 接続の構成については、「 プライベートエンドポイントゲートウェイの構成（VPC の使用に必要） 」を参照してください。

その結果として開始されるログイン・セッションは 60 分間有効となります。