このページでは、gcloud CLI にログインするためのさまざまな方法について説明します。Google Cloud CLI は、 Trusted Cloud by S3NS管理に使用できるコマンドライン ツールです。ほとんどのサービスは gcloud CLI をサポートしています。
ローカル開発環境でアプリケーションのデフォルト認証情報（ADC）をサポートするクライアント ライブラリまたはサードパーティ開発ツールを使用する場合は、ローカル環境で ADC を設定する必要があります。詳細については、ローカル開発環境用のアプリケーションのデフォルト認証情報を設定するをご覧ください。
gcloud CLI に対する認証方法と使用方法は、ツールの実行場所によって異なります。
ローカル環境
ほとんどのユースケースでは、ユーザー認証情報を使用して gcloud CLI にログインできますが、サービス アカウントを使用することもできます。
次の表は、gcloud CLI へのログイン オプションと、ツールが Google API の認証と認可に使用する認証情報への影響を示しています。
gcloud CLI にログインする前に、構成でcore/universe_domain プロパティを設定する必要があります。
gcloud config set universe_domain s3nsapis.fr
| 認証情報の種類 | 認証コマンド | 注 | 詳細 |
|---|---|---|---|
| ユーザー認証情報 |
|
Workforce Identity 連携により、外部 ID プロバイダ（IdP）によって管理されているユーザーは、 Trusted Cloud リソースにアクセスできます。 | |
| サービス アカウント |
gcloud auth login --cred-file=WORKLOAD_IDENTITY_FEDERATION_CREDENTIAL_FILE
|
Workload Identity 連携を使用すると、 Trusted Cloud の外部で実行されているワークロードから Trusted Cloud リソースにアクセスできます。 | ワークロードの認証を行う |
gcloud auth login --cred-file=SERVICE_ACCT_KEY
|
サービス アカウント キーを使用するとリスクが高くなるため、この方法はおすすめしません。 Google API の認可にサービス アカウントを使用する場合は、ユーザー認証情報で gcloud CLI にログインし、サービス アカウントの権限借用を使用します。 |
Trusted Cloud コンピューティング リソース
Compute Engine 仮想マシンなどの Trusted Cloud コンピューティング リソースで gcloud CLI を使用する場合、メタデータ サーバーを使用して gcloud CLI の認証情報と構成情報がホスティング コンピューティング リソースから取得されるため、gcloud CLI の初期化やログインを行う必要はありません。
| 認証情報の種類 | 認証コマンド | 注 | 詳細 |
|---|---|---|---|
| サービス アカウント | 該当なし | gcloud CLI では、コンピューティング リソースに関連付けられたサービス アカウントが、すべての Google API の認証と認可に使用されます。 | サービス アカウントが接続されたリソースの ADC を設定する |
gcloud CLI 認証構成と ADC 構成
gcloud CLI にログインするときは、gcloud auth login コマンドを使用して、gcloud CLI に対するプリンシパルを認証します。gcloud CLI は、そのプリンシパルを使用して、 Trusted Cloud のリソースとサービスを管理するための認証と認可を行います。これが gcloud CLI 認証構成です。
gcloud CLI を使用して ADC を構成する場合は、gcloud auth application-default login コマンドを使用します。このコマンドは、指定したプリンシパルを使用して、ローカル環境の ADC を構成します。これが ADC 構成です。
gcloud CLI 認証構成は ADC 構成とは異なります。同じプリンシパル、または、異なるプリンシパルを使用することができます。gcloud CLI は、ADC を使用して Trusted Cloud リソースにアクセスしません。
次の表に、2 つのコマンドとその動作を示します。
| コマンド | 説明 |
|---|---|
gcloud auth login
|
Trusted Cloud サービスへのアクセスの認証と認可に使用される認証情報を受け入れます。 |
gcloud auth application-default login
|
コマンドに指定した認証情報に基づいて、ローカル ADC ファイルを生成します。 |
通常は、同じアカウントで gcloud CLI にログインして ADC を構成しますが、必要に応じて別のアカウントを使用することもできます。
次のステップ
- ADC が認証情報を検出する仕組みを確認する。
- Cloud クライアント ライブラリを使用して認証する。
- 認証方法を確認する。