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

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

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

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

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 エンドポイントをprivate.cloud.ibm.comに設定する必要がある。 この例では、信頼されたプロファイルは環境変数 IBMCLOUD_CR_PROFILE=profile_id_or_crn を設定することで提供された：

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

プライベート・エンドポイントを使用した CLI へのログインについて詳しくは、プライベート・エンドポイントを使用した CLI へのログインを参照してください。

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