Google Cloud Attestation トークンのクレーム

このドキュメントでは、Google Cloud Attestation トークンのクレームについて説明します。トークンはエンティティ構成証明トークン（EAT）で、JSON ウェブトークン（JWT）としてエンコードされます。JWT は、https://jwt.io/ などのツールを使用してデコードできます。

クレームは、Google Cloud Attestation の well-known エンドポイントで定義されます。

デコードされたトークンの例

Google Cloud Attestation トークンのクレームは、Confidential VM インスタンスで使用されている Confidential Computing テクノロジーによって異なります。

AMD SEV

デコードされた AMD SEV 構成証明トークンの例を次に示します。

{
  "alg": "RS256",
  "kid": "6e66f1aededf736581df2599ee20387718978dcd",
  "typ": "JWT"
}.
{
  "aud": "AUDIENCE",
  "exp": 1715359550,
  "iat": 1715355950,
  "iss": "https://confidentialcomputing.googleapis.com",
  "nbf": 1698861565,
  "sub": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME",
  "eat_nonce": [
    "thisIsAcustomNonce",
    "thisIsAMuchLongerCustomNonceWithPaddingFor74Bytes0000000000000000000000000"
  ],
  "secboot": true,
  "oemid": 11129,
  "hwmodel": "GCP_AMD_SEV",
  "swname": "GCE",
  "eat_profile": "https://cloud.google.com/confidential-computing/confidential-vm/docs/token-claims",
  "submods": {
    "gce": {
      "zone": "ZONE",
      "project_id": "PROJECT_ID",
      "project_number": "PROJECT_NUMBER",
      "instance_name": "INSTANCE_NAME",
      "instance_id": "INSTANCE_ID"
    }
  },
  "google_service_accounts": [
    "470652426305-compute@developer.gserviceaccount.com"
  ]
}

インテル TDX

デコードされた Intel TDX 構成証明トークンの例を次に示します。

{
  "alg": "RS256",
  "kid": "6e66f1aededf736581df2599ee20387718978dcd",
  "typ": "JWT"
}.
{
  "aud": "AUDIENCE",
  "exp": 1715359550,
  "iat": 1715355950,
  "iss": "https://confidentialcomputing.googleapis.com",
  "nbf": 1698861565,
  "sub": "//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/INSTANCE_ID",
  "eat_nonce": "thisIsAcustomNonce",
  "secboot": true,
  "oemid": 11129,
  "hwmodel": "GCP_INTEL_TDX",
  "swname": "GCE",
  "dbgstat": "disabled-since-boot",
  "eat_profile": "https://cloud.google.com/confidential-computing/confidential-vm/docs/token-claims",
  "submods": {
    "gce": {
      "zone": "ZONE",
      "project_number": "PROJECT_NUMBER",
      "instance_id": "INSTANCE_ID"
    }
  },
  "tdx": {
    "gcp_attester_tcb_date": "2026-06-01T00:00:00Z",
    "tcb_evaluation_data_number": 17,
    "fmspc": "00806F000000",
    "tee_tcb_svn": "06010300000000000000000000000000",
    "pcesvn": 11,
    "sgx_tcb_comp_svn": "08080202040100060000000000000000",
    "xfam": "e702060000000000",
    "tdattributes": "0000000000000000",
    "mrtd": "c68518a0ebb42136c12b2275164f8c72f25fa9a343922286a41b52bc7e4c2787e35b7782b132454191a27e366bc33e8a",
    "rtmr0": "a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1a1",
    "rtmr1": "b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2b2",
    "rtmr2": "c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3c3",
    "rtmr3": "000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
  },
  "google_service_accounts": [
    "470652426305-compute@developer.gserviceaccount.com"
  ]
}

トークンのクレーム

次の表に、Google Cloud Attestation トークンの概要レベルのクレームを示します。これらのクレームは、OpenID Connect 1.0 仕様に準拠しています。

well-known エンドポイント値 説明
claims_supported トップレベルのクレームをご覧ください。
id_token_signing_alg_values_supported トークンでサポートされている署名アルゴリズム（alg 値）。Confidential VM は RS256 アルゴリズムをサポートしています。
issuer

Confidential VM が発行者識別子として使用する HTTPS スキーム。

値は https://confidentialcomputing.googleapis.com です。
jwks_uri

トークン署名の検証に使用される公開鍵のパス。これらの鍵は Cloud Storage バケットに公開できます。

jwks_uri 鍵は、 https://www.googleapis.com/service_accounts/v1/metadata/jwk/signer@confidentialspace-sign.iam.gserviceaccount.com で確認できます。

値の例は https://example.storage.googleapis.com/jwks.json です。
response_types_supported サポートされている Confidential VM レスポンス タイプのリスト。Confidential VM は id_token をサポートしています。
scopes_supported Confidential VM インスタンスがサポートする OAuth 2.0 スコープ値。Confidential VM は openid のみをサポートします。
subject_types_supported Confidential VM がサポートするサブジェクト識別子タイプ。Confidential VM は public をサポートしています。

トップレベルのクレーム

次の表に、Google Cloud Attestation トークンでサポートされている最上位のクレームを示します。

クレーム タイプ 説明
aud 文字列

対象者。Workload Identity プールで使用されるデフォルトのトークンの場合、オーディエンスは https://sts.googleapis.com です。このトークンは、Confidential VM インスタンスのランチャーによって 1 時間ごとに取得されます。

カスタム オーディエンスを含むトークンの場合、オーディエンスはトークン リクエストのオーディエンスからエコーされます。最大長は 512 バイトです。
dbgstat 文字列 ハードウェアのデバッグ ステータス。AMD SEV では使用できません。
eat_nonce 文字列または文字列配列 構成証明トークンの 1 つ以上のノンス。値は、カスタム トークン リクエストで送信されたトークン オプションからエコーされます。各ノンスは 10 ～ 74 バイトの範囲内である必要があります。最大 6 個のノンスを指定できます。
eat_profile 文字列 トークン スキーマを定義するエンティティ証明書トークン（EAT）プロファイルの URI。値は https://cloud.google.com/confidential-computing/confidential-vm/docs/token-claims です。
exp 整数、Unix タイムスタンプ トークンの処理が許可されない有効期限。値は、1970-01-01T0:0:0Z から有効期限までの秒数を UTC で測定した JSON 数値です。
google_service_accounts 文字列配列 Confidential VM ワークロードを実行している検証済みのサービス アカウント。
hwmodel 文字列

ハードウェア トークンの固有識別子。識別子は次のいずれかの値にする必要があります。

  • GCP_AMD_SEV
  • GCP_AMD_SEV_ES
  • GCP_SHIELDED_VM
  • GCP_INTEL_TDX
iat 整数、Unix タイムスタンプ JWT が発行された日時。値は、1970-01-01T0:0:0Z から問題発生時刻までの秒数を UTC で測定した JSON 数値です。
iss 文字列 トークンの発行者。https://confidentialcomputing.googleapis.com に設定されます。
nbf 整数、Unix タイムスタンプ JWT の処理が許可される時刻。値は、UTC で測定された 1970-01-01T0:0:0Z からの秒数を表す JSON 数値です。
oemid Uint64 Google の プライベート エンタープライズ番号（PEN）（11129）。
secboot ブール値 セキュアブートが有効になっているかどうか。セキュアブートが有効になっている場合、VM のブートプロセス中にファームウェアとオペレーティング システムが認証されます。
sub 文字列

仮想マシン インスタンスを識別するサブジェクト:

  • AMD SEV インスタンスの場合、これはインスタンスの selfLink URL（https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME）です。
  • Intel TDX インスタンスの場合、これは不変の数値 ID を含む Compute Engine リソース名（//compute.googleapis.com/projects/PROJECT_NUMBER/zones/ZONE/instances/INSTANCE_ID）です。
submods 配列 さまざまなクレームの配列。サブモジュールのクレームをご覧ください。
swname 文字列

VM の承認済みオペレーティング システムの名前。

値は常に GCE です。
tdx オブジェクト Intel TDX インスタンスのクレームを含むオブジェクト。インテル TDX の主張をご覧ください。

Intel TDX の請求

次の表に、Intel TDX インスタンスの Google Cloud Attestation トークンの tdx クレームを示します。

クレーム タイプ 説明
tcb_evaluation_data_number Uint32 Intel TCB Info から、プラットフォームの FMSPC に関連付けられた単調増加の Intel TCB 評価データ番号。
gcp_attester_tcb_date 文字列 Intel TCB 評価ベースラインのタイムスタンプ（UTC）。
mrtd1 文字列（16 進数） 初期の信頼できるドメインのコンテンツと仮想ファームウェア（OVMF）の測定。
rtmr01 文字列（16 進数） ランタイム測定レジスタ 0（仮想ファームウェア構成とシステム パラメータ）。
rtmr1 文字列（16 進数） ランタイム測定レジスタ 1（ゲスト OS のブートローダーとカーネルの測定値）。
rtmr2 文字列（16 進数） ランタイム測定レジスタ 2（初期 RAM ディスク（initramfs）とカーネル コマンドライン）。
rtmr3 文字列（16 進数） ランタイム測定レジスタ 3（お客様のランタイム拡張機能とアプリケーション）。
fmspc 文字列（16 進数） Intel Provisioning Certification Service（PCS）ルックアップ用の 6 バイトの Family-Model-Stepping SKU。
tee_tcb_svn 文字列（16 進数） トラスト ドメインが起動されたときの TDX TCB コンポーネントのセキュリティ バージョン番号の 16 バイト配列。
pcesvn Uint16 プロビジョニング認証エンクレーブ（PCE）の SVN。
sgx_tcb_comp_svn 文字列（16 進数） Intel SGX TCB コンポーネントのセキュリティ バージョン番号の 16 バイト配列。
xfam 文字列（16 進数） 有効な CPU 拡張機能の 8 バイトのマスク。
tdattributes 文字列（16 進数） TD 実行属性の 8 バイトのビットマップ。
1 アクセス ポリシーでこれらの測定値を使用しないでください。基盤となるインフラストラクチャの変更（ファームウェアの更新など）の影響を受けます。このような変更はいつでも発生する可能性があります。これらの測定値は、主に透明性を確保するために提供されています。

サブモジュールの申し立て

次の表に、Google Cloud Attestation トークンの submods クレームを示します。

クレーム タイプ 説明
gce オブジェクト Compute Engine の請求をご覧ください。

Compute Engine の請求

次の表に、Google Cloud Attestation トークンの gce クレームの説明を示します。

クレーム タイプ 説明
instance_id 文字列 VM インスタンス ID。
instance_name 文字列 VM インスタンス名。
project_id 文字列 VM が実行されているプロジェクトの プロジェクト ID。
project_number 文字列 VM が実行されているプロジェクトのプロジェクト番号。
zone 文字列 Confidential VM インスタンスが実行されている Compute Engine ゾーン。

次のステップ