このページは Cloud Translation API によって翻訳されました。

フリートワークロードから API とサービスに対して認証する

このページでは、フリート Workload Identity 連携を使用して、Compute Engine API や AI Platform API などの Google Cloud APIs に対して認証を行うようにアプリケーションを構成する方法について説明します。

フリートの Workload Identity 連携とは

Workload Identity 連携を使用すると、認証情報をダウンロード、手動でローテーション、一般的な管理を行うことなく、クラスタ内のワークロードを Google Cloud に認証できます。代わりに、ワークロードは Google Cloud によって生成される有効期間の短いトークンを使用して認証されます。

GKE 用 Workload Identity 連携は、GKE クラスタで実行されているアプリケーションが ID を取得するプロジェクト全体の Workload Identity プールを提供します。フリート Workload Identity 連携は、クラスタが別のプロジェクトにあるか、Google Cloud の外部にあるかにかかわらず、GKE 用 Workload Identity 連携をすべてのフリートメンバークラスタに拡張します。フリートメンバーシップで Workload Identity 連携を有効にした登録済みクラスタは、フリート全体の Workload Identity プールを使用して ID を取得します。これにより、複数のプロジェクトにまたがって、フリート全体で Google Cloud APIs やその他のサービスに対する認証を構成できます。

一部のクラスタタイプでは、Connect Agent でフリートの Workload Identity 連携を使用し、フリートメンバーシップの一部として Google Cloud に対して認証できます。また、Cloud Service Mesh など、プロジェクト間で機能する GKE Enterprise 機能の一部を使用する必要があります。

Workload Identity 連携プールと ID の同一性

フリート Workload Identity 連携を使用すると、フリート内の各アプリケーションに、Google Cloud や開発する他のサービスに対する認証に使用できる個別の連携 ID が付与されます。アプリケーションは、IAM が認識できるプリンシパル ID を取得します。この ID の構文は次のとおりです。

PREFIX://iam.googleapis.com/projects/FLEET_PROJECT_NUMBER/locations/global/workloadIdentityPools/FLEET_PROJECT_ID.svc.id.goog/SELECTOR

この構文には次のフィールドがあります。

PREFIX: 選択したリソースに応じて IAM principal または principalSet。
FLEET_PROJECT_ID.svc.id.goog: フリートの Workload Identity プール。各フリートには、自動的に作成される 1 つの固定 Workload Identity プールがあります。
FLEET_PROJECT_NUMBER: フリートホストプロジェクトのプロジェクト番号。
SELECTOR: リソースセレクタ。サポートされているセレクタの一覧については、サポートされているプリンシパル ID をご覧ください。

フリート全体がフリートの Workload Identity プールを共有するため、他のプロジェクトやクラウドを含むフリート内の任意のアプリケーションに、クラスタごとにアクセスを管理することなく、同じリソースへのアクセス権を付与できます。他のフリート対応の機能と同様に、フリート Workload Identity 連携は同一性の原則に従います。つまり、同じ名前と Namespace を持つ Kubernetes オブジェクトは、異なるクラスタで同じものとして扱われます。

たとえば、同じフリート内の複数のクラスタにバックエンドがデプロイされたアプリケーションで Google Cloud API への認証が必要な場合、backend Namespace 内のすべてのワークロードがその API にアクセスできるようにアプリケーションを構成できます。フリートにおける同一性（ID の同一性など）の利用方法の詳細については、フリートの仕組みをご覧ください。

フリートの Workload Identity 連携を有効にすると、対応するプリンシパル ID を指定して、IAM 許可ポリシーでフリートのプリンシパルを参照できます。たとえば、許可ポリシーで特定の Kubernetes Namespace 内の特定の ServiceAccount を参照できます。その ServiceAccount を使用するすべてのアプリケーションは、IAM 許可ポリシーが適用される Google Cloud リソースにアクセスできます。

認証情報フロー

特定の Namespace 内のアプリケーションがフリート Workload Identity 連携を使用して認証できるようにするには、次の操作を行います。

次の情報が含まれる ConfigMap をその Namespace にデプロイします。
- Workload Identity プールとクラスタの ID プロバイダ。
- Kubernetes が ServiceAccount トークンをマウントする各 Pod 内のパス。このトークンは署名付き JSON Web Token（JWT）です。
この ConfigMap は、ワークロードのアプリケーションのデフォルト認証情報（ADC）ファイルとして機能します。
クラスタ内のプリンシパルのプリンシパル ID（Namespace 内の ServiceAccount など）に特定の Google Cloud リソースに対するアクセス権を付与する IAM 許可ポリシーを作成します。
Namespace 内のワークロードのポッド仕様に、次の構成があることを確認します。
- Pod 内の ConfigMap のマウントパスに設定された GOOGLE_APPLICATION_CREDENTIALS 環境変数。
- ServiceAccount トークンと作成した ConfigMap を含むプロジェクションボリューム。GOOGLE_APPLICATION_CREDENTIALS 環境変数で指定したパスにマウントされます。
- プロジェクションされたボリュームを参照するコンテナ内のボリュームマウント。

ワークロードが Google Cloud API 呼び出しを行うと、次の処理が行われます。

Google Cloud 認証ライブラリは、アプリケーションのデフォルト認証情報（ADC）を使用して認証情報を検索します。ADC は、GOOGLE_APPLICATION_CREDENTIALS 環境変数で指定したパスをチェックして、認証トークンを探します。
ADC 認証ライブラリは、ConfigMap 内のデータを使用して、Pod にマウントした ServiceAccount JWT を、ワークロードのプリンシパル ID を参照する Security Token Service の有効期間の短い連携トークンと交換します。
ADC は、連携トークンを API リクエストに含めます。
IAM 許可ポリシーは、Google Cloud リソースに対してリクエストされたオペレーションを実行することをプリンシパル ID に許可します。

フリートの Workload Identity 連携でサポートされているプリンシパル ID

次の表に、IAM 許可ポリシーで使用してフリート内のプリンシパルを参照できるセレクタを示します。

プリンシパル ID のタイプ構文

特定の Kubernetes ServiceAccount を使用するすべての Pod

プリンシパル ID のタイプ	構文
特定の Kubernetes ServiceAccount を使用するすべての Pod	名前で ServiceAccount を選択します。 principal://iam.googleapis.com/projects/`PROJECT_NUMBER`/locations/global/workloadIdentityPools/`PROJECT_ID`.svc.id.goog/subject/ns/`NAMESPACE`/sa/`SERVICEACCOUNT` 次のように置き換えます。 `PROJECT_NUMBER`: 数値のプロジェクト番号。プロジェクト番号を取得するには、プロジェクトを特定するをご覧ください。 `PROJECT_ID`: Google Cloud プロジェクト ID。 `NAMESPACE`: Kubernetes の Namespace。 `SERVICEACCOUNT`: Kubernetes ServiceAccount 名。 UID で ServiceAccount を選択します。 principal://iam.googleapis.com/projects/`PROJECT_NUMBER`/locations/global/workloadIdentityPools/`PROJECT_ID`.svc.id.goog/kubernetes.serviceaccount.uid/`SERVICEACCOUNT_UID` 次のように置き換えます。 `PROJECT_NUMBER`: 数値のプロジェクト番号。プロジェクト番号を取得するには、プロジェクトを特定するをご覧ください。 `PROJECT_ID`: フリートプロジェクト ID。 `SERVICEACCOUNT_UID`: API サーバー内の `ServiceAccount` オブジェクトの UID。

名前で ServiceAccount を選択します。

principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/PROJECT_ID.svc.id.goog/subject/ns/NAMESPACE/sa/SERVICEACCOUNT

次のように置き換えます。

PROJECT_NUMBER: 数値のプロジェクト番号。プロジェクト番号を取得するには、プロジェクトを特定するをご覧ください。
PROJECT_ID: Google Cloud プロジェクト ID。
NAMESPACE: Kubernetes の Namespace。
SERVICEACCOUNT: Kubernetes ServiceAccount 名。

UID で ServiceAccount を選択します。

principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/PROJECT_ID.svc.id.goog/kubernetes.serviceaccount.uid/SERVICEACCOUNT_UID

次のように置き換えます。

PROJECT_NUMBER: 数値のプロジェクト番号。プロジェクト番号を取得するには、プロジェクトを特定するをご覧ください。
PROJECT_ID: フリートプロジェクト ID。
SERVICEACCOUNT_UID: API サーバー内の ServiceAccount オブジェクトの UID。

始める前に

次のコマンドラインツールがインストールされていることを確認します。
- 最新バージョンの Google Cloud CLI、Google Cloud とやり取りするためのコマンドラインツールである gcloud が含まれています。
- kubectl
Google Cloud を操作するシェル環境として Cloud Shell を使用する場合は、これらのツールがインストールされます。
プロジェクトで使用する gcloud CLI が初期化されていることを確認します。

クラスタを準備する

フリートのアプリケーションが連携 ID を受け取るには、アプリケーションが実行されているクラスタがフリートに登録され、フリートの Workload Identity 連携を使用するように正しく構成されている必要があります。以降のセクションでは、さまざまなタイプのクラスタにフリートの Workload Identity 連携を設定する方法について説明します。

GKE

GKE クラスタの場合は、次の操作を行います。

Google Kubernetes Engine クラスタで Workload Identity Federation for GKE を有効にします（有効になっていない場合）。
フリートにクラスタを登録します。

クラスタの作成プロセスとフリートの登録プロセスで、GKE 用 Workload Identity 連携を有効にすることもできます。

Google Cloud の外部にあるクラスタ

次のタイプのクラスタは、フリート Workload Identity 連携を自動的に有効にし、クラスタの作成時にフリートに登録されます。

VMware 上の Google Distributed Cloud（ソフトウェアのみ）
ベアメタル上の Google Distributed Cloud（ソフトウェアのみ）
GKE on AWS
GKE on Azure

接続クラスタ

GKE Multi-Cloud API を使用して登録された EKS 接続クラスタおよび AKS 接続クラスタは、デフォルトで有効になっているフリート Workload Identity 連携に登録されています。必要な要件を満たしている場合、フリートの Workload Identity 連携を有効にしてその他の接続クラスタを登録できます。クラスタの登録にあるクラスタタイプに応じた手順に沿います。

アプリケーションでフリートの Workload Identity 連携を使用する

次の手順では、フリート Workload Identity 連携を使用するように登録済みクラスタ内のワークロードを構成する方法について説明します。

クラスタの Workload Identity プールと ID プロバイダの名前を確認します。
```
gcloud container fleet memberships describe MEMBERSHIP_ID \
    --project=FLEET_PROJECT_ID \
    --format="table(authority.identityProvider,authority.workloadIdentityPool,name)"
```
次のように置き換えます。
- MEMBERSHIP_ID: クラスタのメンバーシップ名。多くの場合、これはクラスタの名前です。
- FLEET_PROJECT_ID: フリートホストプロジェクトのプロジェクト ID。
出力は次のようになります。
```
IDENTITY_PROVIDER: IDENTITY_PROVIDER
WORKLOAD_IDENTITY_POOL: WORKLOAD_IDENTITY_POOL
NAME: projects/FLEET_PROJECT_ID/locations/MEMBERSHIP_LOCATION/memberships/MEMBERSHIP_ID
```
この出力には次の情報が含まれます。
- IDENTITY_PROVIDER: クラスタの ID プロバイダ。
- MEMBERSHIP_LOCATION: フリートメンバーシップのロケーション。通常は、クラスタのロケーションと同じです。
- WORKLOAD_IDENTITY_POOL: フリートに関連付けられている Workload Identity プールの名前。この値の構文は FLEET_PROJECT_ID.svc.id.goog です。
Kubernetes Namespace を作成します。default Namespace など、既存の Namespace を使用することもできます。
```
kubectl create namespace NAMESPACE
```
NAMESPACE は Namespace の名前に置き換えます。
Namespace に新しい Kubernetes ServiceAccount を作成します。Namespace 内の default ServiceAccount など、既存の ServiceAccount を使用することもできます。
```
kubectl create serviceaccount KSA_NAME \
    --namespace=NAMESPACE
```
KSA_NAME は、ServiceAccount の名前に置き換えます。

次のマニフェストを adc-config-map.yaml として保存します。この ConfigMap には、ワークロードの ADC 構成が含まれています。

kind: ConfigMap
apiVersion: v1
metadata:
  namespace: NAMESPACE
  name: my-cloudsdk-config
data:
  config: |
    {
      "type": "external_account",
      "audience": "identitynamespace:WORKLOAD_IDENTITY_POOL:IDENTITY_PROVIDER",
      "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
      "token_url": "https://sts.googleapis.com/v1/token",
      "credential_source": {
        "file": "/var/run/secrets/tokens/gcp-ksa/token"
      }
    }

ConfigMap をデプロイします。
```
kubectl create -f adc-config-map.yaml
```

次のマニフェストを workload-config.yaml として保存します。

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
  namespace:  NAMESPACE
spec:
  serviceAccountName: KSA_NAME
  containers:
  - name: sample-container
    image: google/cloud-sdk:slim
    command: ["sleep","infinity"]
    env:
    - name: GOOGLE_APPLICATION_CREDENTIALS
      value: /var/run/secrets/tokens/gcp-ksa/google-application-credentials.json
    volumeMounts:
    - name: gcp-ksa
      mountPath: /var/run/secrets/tokens/gcp-ksa
      readOnly: true
  volumes:
  - name: gcp-ksa
    projected:
      defaultMode: 420
      sources:
      - serviceAccountToken:
          path: token
          audience: WORKLOAD_IDENTITY_POOL
          expirationSeconds: 172800
      - configMap:
          name: my-cloudsdk-config
          optional: false
          items:
          - key: "config"
            path: "google-application-credentials.json"

このワークロードをデプロイすると、Pod の gcp-ksa ボリュームに次のデータが含まれます。

google-application-credentials.json という名前のファイルとしてデプロイした ConfigMap 内のデータ。このファイルは ADC 認証情報構成ファイルです。
Kubernetes ServiceAccount トークン（token）。Kubernetes は、ServiceAccount の署名付き JWT を予測された ServiceAccount トークンファイルとしてマウントします。

Pod 内のコンテナは、gcp-ksa ボリュームを /var/run/secrets/tokens/gcp-ksa パスにマウントし、そのパスで認証情報構成 JSON ファイルを検索するように ADC を構成します。

ワークロードをデプロイします。
```
kubectl apply -f workload-config.yaml
```

代替手段: IAM サービスアカウントの権限借用

また、クラスタ内の Kubernetes ServiceAccount を構成して、IAM サービスアカウントの権限借用を行い、IAM サービスアカウントが実行できる承認済みアクションを実行することもできます。このアプローチでは、IAM と Kubernetes の両方でサービスアカウントのペアを管理する必要があるため、メンテナンスのオーバーヘッドが増加する可能性があります。

ほとんどのシナリオでは、アプリケーションでフリート Workload Identity 連携を使用するの手順に沿って、IAM 許可ポリシーで Kubernetes プリンシパルを直接参照し、Google Cloud リソースへのアクセス権を付与することをおすすめします。

クラスタの Workload Identity プールと ID プロバイダの名前を確認します。
```
gcloud container fleet memberships describe MEMBERSHIP_ID \
    --project=FLEET_PROJECT_ID \
    --format="table(authority.identityProvider,authority.workloadIdentityPool,name)"
```
次のように置き換えます。
- MEMBERSHIP_ID: クラスタのメンバーシップ名。多くの場合、これはクラスタの名前です。
- FLEET_PROJECT_ID: フリートホストプロジェクトのプロジェクト ID。
出力は次のようになります。
```
IDENTITY_PROVIDER: IDENTITY_PROVIDER
WORKLOAD_IDENTITY_POOL: WORKLOAD_IDENTITY_POOL
NAME: projects/FLEET_PROJECT_ID/locations/MEMBERSHIP_LOCATION/memberships/MEMBERSHIP_ID
```
この出力には次の情報が含まれます。
- IDENTITY_PROVIDER: クラスタの ID プロバイダ。
- MEMBERSHIP_LOCATION: メンバーシップのロケーション。通常は、クラスタのロケーションと同じです。
- WORKLOAD_IDENTITY_POOL: フリートに関連付けられている Workload Identity プールの名前。この値の構文は FLEET_PROJECT_ID.svc.id.goog です。
アプリケーションが権限借用できる IAM サービスアカウントを作成します。既存の IAM サービスアカウントを使用することもできます。
```
gcloud iam service-accounts create IAM_SA_NAME \
    --project=IAM_SA_PROJECT_ID
```
次のように置き換えます。
- IAM_SA_NAME: IAM サービスアカウントの名前。
- IAM_SA_PROJECT_ID: IAM サービスアカウントを含むプロジェクトのプロジェクト ID。これはフリートホストプロジェクトとは異なる場合があります。
必要な IAM 許可ポリシーを追加して、Google Cloud APIs にアクセスするために必要な権限を IAM サービスアカウントに付与します。これは、gcloud iam service-accounts add-iam-policy-binding を使用するか、別の方法で行います。Google Cloud APIs の使用に必要な権限は各サービスのドキュメント、必要な権限を含む事前定義ロールの一覧はロールについてをご覧ください。
Namespace に Kubernetes ServiceAccount を作成します。既存の Kubernetes ServiceAccount と任意の Namespace（default ServiceAccount と default Namespace など）を使用することもできます。
```
kubectl create serviceaccount KSA_NAME \
    --namespace=NAMESPACE
```
次のように置き換えます。
- KSA_NAME: ServiceAccount の名前。
- NAMESPACE: Namespace の名前。

クラスタ内の特定の Namespace の Kubernetes ServiceAccount が IAM サービスアカウントの権限を借用できるようにする IAM 許可ポリシーを作成します。

gcloud iam service-accounts add-iam-policy-binding IAM_SA_NAME@IAM_SA_PROJECT_ID.iam.gserviceaccount.com \
    --project=IAM_SA_PROJECT_ID \
    --role=roles/iam.workloadIdentityUser \
    --member="serviceAccount:WORKLOAD_IDENTITY_POOL[NAMESPACE/KSA_NAME]"

WORKLOAD_IDENTITY_POOL は、Workload Identity プールの名前に置き換えます。

次のマニフェストを adc-config-map.yaml として保存します。この ConfigMap には、ワークロードの ADC 構成が含まれています。

kind: ConfigMap
apiVersion: v1
metadata:
  namespace: K8S_NAMESPACE
  name: my-cloudsdk-config
data:
  config: |
    {
      "type": "external_account",
      "audience": "identitynamespace:WORKLOAD_IDENTITY_POOL:IDENTITY_PROVIDER",
      "service_account_impersonation_url": "https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/IAM_SA_NAME@GSA_PROJECT_ID.iam.gserviceaccount.com:generateAccessToken",
      "subject_token_type": "urn:ietf:params:oauth:token-type:jwt",
      "token_url": "https://sts.googleapis.com/v1/token",
      "credential_source": {
        "file": "/var/run/secrets/tokens/gcp-ksa/token"
      }
    }

次のように置き換えます。

IAM_SA_NAME: 権限借用する IAM サービスアカウントの名前。
IAM_SA_PROJECT_ID: IAM サービスアカウントのプロジェクト ID。

次のマニフェストを workload-config.yaml として保存します。

apiVersion: v1
kind: Pod
metadata:
  name: my-pod
  namespace:  K8S_NAMESPACE
spec:
  serviceAccountName: KSA_NAME
  containers:
  - name: my-container
    image: my-image
    command: ["sleep","infinity"]
    env:
      - name: GOOGLE_APPLICATION_CREDENTIALS
        value: /var/run/secrets/tokens/gcp-ksa/google-application-credentials.json
    volumeMounts:
    - name: gcp-ksa
      mountPath: /var/run/secrets/tokens/gcp-ksa
      readOnly: true
  volumes:
  - name: gcp-ksa
    projected:
      defaultMode: 420
      sources:
      - serviceAccountToken:
          path: token
          audience: WORKLOAD_IDENTITY_POOL
          expirationSeconds: 172800
      - configMap:
          name: my-cloudsdk-config
          optional: false
          items:
            - key: "config"
              path: "google-application-credentials.json"

このワークロードをデプロイすると、Pod の gcp-ksa ボリュームに次のデータが含まれます。

google-application-credentials.json という名前のファイルとしてデプロイした ConfigMap 内のデータ。このファイルは ADC 認証情報構成ファイルです。
Kubernetes ServiceAccount トークン（token）。Kubernetes は、ServiceAccount の署名付き JWT を予測された ServiceAccount トークンファイルとしてマウントします。

ワークロードをデプロイします。
```
kubectl apply -f workload-config.yaml
```

フリートの Workload Identity 連携の設定を確認する

このセクションでは、Cloud Storage バケットを作成し、フリート Workload Identity 連携を使用する Pod からバケットにアクセスします。これらの手順を実行する前に、アプリケーションでフリート Workload Identity 連携を使用するの手順に沿って、Workload Identity 連携が構成されていることを確認します。

このセクションでは、IAM サービスアカウントの権限借用方法を使用して Workload Identity 連携を確認する方法については説明しません。

プロジェクト番号を確認します。

gcloud projects describe FLEET_PROJECT_ID \
    --format="value(projectNumber)"

出力は次のようになります。

1234567890

Cloud Storage バケットを作成します。
```
gcloud storage buckets create gs://FLEET_PROJECT_ID-test-bucket \
    --location=LOCATION
```
LOCATION は、Google Cloud のロケーションに置き換えます。
作成したサービスアカウントにバケットへのアクセスを許可する IAM 許可ポリシーを作成します。
```
gcloud storage buckets add-iam-policy-binding gs://FLEET_PROJECT_ID-test-bucket \
    --condition=None \
    --role=roles/storage.objectViewer \
    --member=principal://iam.googleapis.com/projects/FLEET_PROJECT_NUMBER/locations/global/workloadIdentityPools/FLEET_PROJECT_ID.svc.id.goog/subject/ns/NAMESPACE/sa/KSA_NAME
```
次のように置き換えます。
- FLEET_PROJECT_NUMBER: 数値のプロジェクト番号。
- FLEET_PROJECT_ID: プロジェクト ID。
- NAMESPACE: 前のセクションの Pod を実行する Kubernetes Namespace の名前。
- KSA_NAME: 前のセクションの Pod が使用する Kubernetes ServiceAccount の名前。
ベストプラクティス: ワークロードがアクセスする必要がある特定のリソースに対して最小限の権限を付与する IAM 許可ポリシーを作成します。

Pod でシェルセッションを作成します。

kubectl exec -it pods/my-pod --namespace=NAMESPACE -- /bin/bash

バケット内のオブジェクトを一覧表示してみます。

curl -X GET -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
"https://storage.googleapis.com/storage/v1/b/FLEET_PROJECT_ID-test-bucket/o"

次のような出力が表示されます。

{
  "kind": "storage#objects"
}

コードからの認証

Cloud クライアントライブラリを使用する場合、認証ライブラリは ADC を使用して、Google Cloud サービスの認証に使用する認証情報を自動的に検索します。Workload Identity 連携をサポートする Cloud クライアントライブラリを使用する必要があります。以下に、Cloud クライアントライブラリの必要な最小バージョンと、現在のバージョンを確認する手順を示します。

C++

C++ 用 Google Cloud クライアントライブラリのほとんどは、grpc::GoogleDefaultCredentials() を呼び出して作成される ChannelCredentials オブジェクトを使用して ID 連携をサポートしています。この認証情報を初期化するには、バージョン 1.36.0 以降の gRPC でクライアントライブラリを構築する必要があります。

C++ 用 Cloud Storage クライアントライブラリは、gRPC ではなく REST API を使用するため、ID 連携をサポートしていません。

Go

Go 用クライアントライブラリは、golang.org/x/oauth2 モジュールのバージョン v0.0.0-20210218202405-ba52d332ba99 以降を使用している場合、ID 連携をサポートします。

クライアントライブラリが使用しているこのモジュールのバージョンを確認するには、次のコマンドを実行します。

cd $GOPATH/src/cloud.google.com/go
go list -m golang.org/x/oauth2

Java

Java 用クライアントライブラリは、com.google.auth:google-auth-library-oauth2-http アーティファクトのバージョン 0.24.0 以降を使用している場合、ID 連携をサポートします。

クライアントライブラリで使用しているこのアーティファクトのバージョンを確認するには、アプリケーションディレクトリで次の Maven コマンドを実行します。

mvn dependency:list -DincludeArtifactIds=google-auth-library-oauth2-http

Node.js

Node.js 用クライアントライブラリは、google-auth-library パッケージのバージョン 7.0.2 以降を使用している場合、ID 連携をサポートします。

クライアントライブラリで使用されているこのパッケージのバージョンを確認するには、アプリケーションディレクトリで次のコマンドを実行します。

npm list google-auth-library

GoogleAuth オブジェクトを作成するときに、プロジェクト ID を指定できます。また、GoogleAuth で自動的にプロジェクト ID を検出することもできます。プロジェクト ID を自動的に検出するには、構成ファイルのサービスアカウントに、プロジェクト上でブラウザのロール（roles/browser）または同等の権限を持つロールが付与されている必要があります。詳細については、google-auth-library パッケージの README をご覧ください。

Python

Python 用クライアントライブラリは、google-auth パッケージのバージョン 1.27.0 以降を使用している場合、ID 連携をサポートします。

クライアントライブラリで使用されているこのパッケージのバージョンを確認するには、パッケージがインストールされている環境で次のコマンドを実行します。

pip show google-auth

認証クライアントのプロジェクト ID を指定するには、GOOGLE_CLOUD_PROJECT 環境変数を設定するか、クライアントがプロジェクト ID を自動的に検出するようにします。プロジェクト ID を自動的に検出するには、構成ファイルのサービスアカウントに、プロジェクト上でブラウザのロール（roles/browser）または同等の権限を持つロールが付与されている必要があります。詳細については、google-auth パッケージのユーザーガイドをご覧ください。

次のステップ

フリート Workload Identity 連携を使用する際のフリート整理に関するベストプラクティスを確認する。

フリート ワークロードから API とサービスに対して認証する

フリートの Workload Identity 連携とは

Workload Identity 連携プールと ID の同一性

認証情報フロー

フリートの Workload Identity 連携でサポートされているプリンシパル ID

始める前に

クラスタを準備する

GKE

Google Cloud の外部にあるクラスタ

接続クラスタ

アプリケーションでフリートの Workload Identity 連携を使用する

代替手段: IAM サービス アカウントの権限借用

フリートの Workload Identity 連携の設定を確認する

コードからの認証

C++

Go

Java

Node.js

Python

次のステップ

フリートワークロードから API とサービスに対して認証する

代替手段: IAM サービスアカウントの権限借用