Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

認證斷言

資料協作者

如要進一步瞭解如何使用認證斷言，請參閱「建立認證政策」。

下表詳細列出可用於建構認證政策的斷言。政策可以驗證 Confidential Space 映像檔、工作負載容器和 VM 執行個體提出的斷言。

圖片聲明

斷言類型說明

assertion.dbgstat

互動對象：

工作負載運算子： --image-family 值。

Enumeration

確認 Confidential Space 映像檔是偵錯或正式版本。

有效值如下：

enable：確認是否正在使用偵錯映像檔。
disabled-since-boot：確認使用的是正式版映像檔。

範例

下列程式碼會驗證是否正在使用 Confidential Space 映像檔的偵錯版本：

assertion.dbgstat == "enable"

下列程式碼會驗證是否使用正式版 Confidential Space 映像檔：

assertion.dbgstat == "disabled-since-boot"

assertion.submods.confidential_space.support_attributes

字串陣列

驗證 TEE 的安全性版本是否為正式版 Confidential Space 映像檔。偵錯 Confidential Space 映像檔未設定支援屬性。

下表說明正式版 Confidential Space 映像檔的支援屬性。

支援屬性說明

LATEST

LATEST 映像檔也包含下列支援屬性：

STABLE
USABLE

映像檔生命週期：約一個月。之後，系統會移除 LATEST 支援屬性。

這是最新版本的 Confidential Space 映像檔，可獲得支援，並會受到監控，以防出現安全漏洞。

如果是長時間執行的工作負載，建議您不要在認證政策中指定 LATEST。這是因為 Confidential Space 映像檔可能會在工作負載執行期間更新，導致您使用的 Confidential Space 映像檔不再是 LATEST，並在下次重新整理 Confidential Space 預設權杖時，導致工作負載無法通過認證。

STABLE

STABLE 映像檔也包含下列支援屬性：

USABLE

映像檔生命週期：約六個月。2027 年 4 月 1 日起，STABLE 支援屬性會在映像檔生命週期結束後移除。

系統會支援具有 STABLE 屬性的映像檔，並監控安全漏洞六個月。建議您根據 STABLE 屬性編寫認證政策。

在極少數情況下，STABLE 屬性可能會在正常的六個月支援期限內移除，例如發現重大安全漏洞時。

USABLE

僅含 USABLE 屬性的圖片仍可使用，但已視為淘汰。不支援已淘汰的映像檔，且映像檔已超過六個月。您必須自行承擔使用風險。

USABLE 圖片具有 deprecated.deprecated 屬性。其值為預期淘汰映像檔的時間戳記。您可以使用 gcloud compute images describe 指令或 images.get REST 方法查看圖片屬性。例如：

gcloud compute images describe confidential-space-240800 \
    --format=json \
    --project=confidential-space-images

EXPERIMENTAL

只有這項屬性的映像檔會使用預先發布版功能。EXPERIMENTAL 映像檔僅供測試，不應用於正式環境。

EXPERIMENTAL 圖片一律不含 LATEST、STABLE 或 USABLE 屬性。

建議您將 Confidential Space 映像檔保持在最新狀態。如要瞭解如何更新 Confidential Space 映像檔，請參閱「更新 Confidential Space 映像檔」。

重要事項：如果發生重大安全漏洞等事件，Confidential Space 映像檔可能會遭到撤銷。撤銷映像檔時，認證權杖中的 swname 宣告會設為 GCE，或工作負載在要求權杖時收到 RIMS_VALIDATION_FAILED 訊息。

範例

下列程式碼會驗證是否使用穩定版 Confidential Space 映像檔：

"STABLE" in assertion.submods.confidential_space.support_attributes

assertion.swname

Enumeration

驗證在認證實體上執行的軟體。這個值一律為 CONFIDENTIAL_SPACE。

範例

assertion.swname == "CONFIDENTIAL_SPACE"

assertion.swversion

字串陣列

驗證 Confidential Space 映像檔的軟體版本。建議您改用 assertion.submods.confidential_space.support_attributes 指定最新版本的映像檔。

範例

int(assertion.swversion[0]) == 230103

容器斷言

斷言類型說明

斷言	類型	說明
`assertion.submods.container.cmd_override` 互動對象：工作負載作者： `allow_cmd_override` 啟動政策。工作負載運算子： `tee-cmd` 中繼資料變數。	字串陣列	驗證工作負載映像檔中使用的 CMD 指令和參數。範例下列程式碼會驗證工作負載映像檔的 CMD 未遭到覆寫： `size(assertion.submods.container.cmd_override) == 0` 下列程式碼會驗證 `program` 是 CMD 覆寫中的唯一內容： `assertion.submods.container.cmd_override == ['program']`
`assertion.submods.container.env` 互動對象：工作負載作者： `allow_env_override` 啟動政策。工作負載運算子： `tee-env-ENVIRONMENT_VARIABLE_NAME` 中繼資料變數。	JSON 物件	確認環境變數及其值已明確傳遞至容器。範例下列程式碼會驗證環境變數 `example-env-1` 是否設為 `value-1`，以及 `example-env-2` 是否設為 `value-2`。 `assertion.submods.container.env == {"example-env-1": "value-1", "example-env-2": "value-2"}`
`assertion.submods.container.env_override` 互動對象：工作負載作者： `allow_env_override` 啟動政策。工作負載運算子： `tee-env-ENVIRONMENT_VARIABLE_NAME` 中繼資料變數。	字串	驗證工作負載運算子是否已覆寫容器中的環境變數。範例下列程式碼會驗證工作負載運算子未覆寫 `example` 環境變數： `!has(assertion.submods.container.env_override.example)` 下列程式碼會驗證工作負載運算子是否未覆寫任何環境變數： `size(assertion.submods.container.env_override) == 0`
`assertion.submods.container.image_digest`	字串	驗證工作負載容器的映像檔摘要。指定這項條件後，多方就能就可存取其資料的授權工作負載達成共識。範例 `assertion.submods.container.image_digest == "sha256:837ccb607e312b170fac7383d7ccfd61fa5072793f19a25e75fbacb56539b86b"`
`assertion.submods.container.image_id`	字串	驗證工作負載容器的映像檔 ID。範例 `assertion.submods.container.image_id == "sha256:652a44b0e911271ba07cf2915cd700fdfa50abd62a98f87a57fdebc59843d93f"`
`assertion.submods.container.image_reference` 互動對象：工作負載運算子： `tee-image-reference` 中繼資料變數。	字串	驗證在 Confidential Space 映像檔上執行的工作負載容器位置。範例 `assertion.submods.container.image_reference == "us-docker.pkg.dev/PROJECT_ID/WORKLOAD_CONTAINER:latest"`
`assertion.submods.container.image_signatures` 互動對象：工作負載運算子： `tee-signed-image-repos` 中繼資料變數。	JSON 物件	驗證映像檔是否具有特定簽章，或是否由公開金鑰和簽署演算法簽署。指定這項條件後，多方就能就可存取其資料的授權工作負載達成共識。斷言可包含下列元素： `key_id`：公開金鑰的十六進位指紋。如要取得指紋，請執行下列指令： `openssl pkey -pubin -in public_key.pem -outform DER \| openssl sha256` 其中 `public_key.pem` 是 PEM 格式的公開金鑰。 `signature`：與已簽署容器相關聯，且遵循簡易簽署格式的酬載簽章。 `signature_algorithm`：用於簽署金鑰的演算法。下列其中一項： `RSASSA_PSS_SHA256` (採用 SHA-256 摘要的 RSASSA-PSS) `RSASSA_PKCS1V15_SHA256` (RSASSA-PKCS1 v1_5，採用 SHA-256 摘要) `ECDSA_P256_SHA256` (含有 SHA-256 摘要的 P-256 曲線 ECDSA) 範例 `['ECDSA_P256_SHA256:PUBLIC_KEY_FINGERPRINT'].exists(fingerprint, fingerprint in assertion.submods.container.image_signatures.map(sig, sig.signature_algorithm+':'+sig.key_id))`
`assertion.submods.container.restart_policy` 互動對象：工作負載運算子： `tee-restart-policy` 中繼資料變數。	Enumeration	驗證容器啟動器在工作負載停止時的重新啟動政策。有效值如下： `Never` (預設) `Always` `OnFailure` 範例 `assertion.submods.container.restart_policy == "Never"`

assertion.submods.container.cmd_override

互動對象：

工作負載作者： allow_cmd_override 啟動政策。
工作負載運算子： tee-cmd 中繼資料變數。

字串陣列

驗證工作負載映像檔中使用的 CMD 指令和參數。

範例

下列程式碼會驗證工作負載映像檔的 CMD 未遭到覆寫：

size(assertion.submods.container.cmd_override) == 0

下列程式碼會驗證 program 是 CMD 覆寫中的唯一內容：

assertion.submods.container.cmd_override == ['program']

assertion.submods.container.env

互動對象：

工作負載作者： allow_env_override 啟動政策。
工作負載運算子： tee-env-ENVIRONMENT_VARIABLE_NAME 中繼資料變數。

JSON 物件

確認環境變數及其值已明確傳遞至容器。

範例

下列程式碼會驗證環境變數 example-env-1 是否設為 value-1，以及 example-env-2 是否設為 value-2。

assertion.submods.container.env == {"example-env-1": "value-1", "example-env-2": "value-2"}

assertion.submods.container.env_override

互動對象：

工作負載作者： allow_env_override 啟動政策。
工作負載運算子： tee-env-ENVIRONMENT_VARIABLE_NAME 中繼資料變數。

字串

驗證工作負載運算子是否已覆寫容器中的環境變數。

範例

下列程式碼會驗證工作負載運算子未覆寫 example 環境變數：

!has(assertion.submods.container.env_override.example)

下列程式碼會驗證工作負載運算子是否未覆寫任何環境變數：

size(assertion.submods.container.env_override) == 0

assertion.submods.container.image_digest

字串

驗證工作負載容器的映像檔摘要。指定這項條件後，多方就能就可存取其資料的授權工作負載達成共識。

範例

assertion.submods.container.image_digest == "sha256:837ccb607e312b170fac7383d7ccfd61fa5072793f19a25e75fbacb56539b86b"

assertion.submods.container.image_id

字串

驗證工作負載容器的映像檔 ID。

範例

assertion.submods.container.image_id == "sha256:652a44b0e911271ba07cf2915cd700fdfa50abd62a98f87a57fdebc59843d93f"

assertion.submods.container.image_reference

互動對象：

工作負載運算子： tee-image-reference 中繼資料變數。

字串

驗證在 Confidential Space 映像檔上執行的工作負載容器位置。

範例

assertion.submods.container.image_reference == "us-docker.pkg.dev/PROJECT_ID/WORKLOAD_CONTAINER:latest"

assertion.submods.container.image_signatures

互動對象：

工作負載運算子： tee-signed-image-repos 中繼資料變數。

JSON 物件

驗證映像檔是否具有特定簽章，或是否由公開金鑰和簽署演算法簽署。指定這項條件後，多方就能就可存取其資料的授權工作負載達成共識。

斷言可包含下列元素：

key_id：公開金鑰的十六進位指紋。如要取得指紋，請執行下列指令：
```
openssl pkey -pubin -in public_key.pem -outform DER | openssl sha256
```
其中 public_key.pem 是 PEM 格式的公開金鑰。
signature：與已簽署容器相關聯，且遵循簡易簽署格式的酬載簽章。
signature_algorithm：用於簽署金鑰的演算法。下列其中一項：
- RSASSA_PSS_SHA256 (採用 SHA-256 摘要的 RSASSA-PSS)
- RSASSA_PKCS1V15_SHA256 (RSASSA-PKCS1 v1_5，採用 SHA-256 摘要)
- ECDSA_P256_SHA256 (含有 SHA-256 摘要的 P-256 曲線 ECDSA)

範例

['ECDSA_P256_SHA256:PUBLIC_KEY_FINGERPRINT'].exists(fingerprint, fingerprint in assertion.submods.container.image_signatures.map(sig, sig.signature_algorithm+':'+sig.key_id))

assertion.submods.container.restart_policy

互動對象：

工作負載運算子： tee-restart-policy 中繼資料變數。

Enumeration

驗證容器啟動器在工作負載停止時的重新啟動政策。

有效值如下：

Never (預設)
Always
OnFailure

範例

assertion.submods.container.restart_policy == "Never"

VM 斷言

斷言	類型	說明
`assertion.google_service_accounts` 互動對象：工作負載運算子： `tee-impersonate-service-accounts` 中繼資料變數和 `--service-account` 值。	字串陣列	確認指定的服務帳戶已連結至執行工作負載的 VM，或已列在 VM 中繼資料的 `tee-impersonate-service-accounts` 中。範例 `workload-service-account@my-project.iam.gserviceaccount.com in assertion.google_service_accounts`
`assertion.hwmodel`	字串	驗證基礎機密運算技術。支援的平台如下： `GCP_AMD_SEV` `INTEL_TDX` 範例 `assertion.hwmodel == "GCP_AMD_SEV"`
`assertion.submods.confidential_space.monitoring_enabled` 互動對象：工作負載作者： `monitoring_memory_allow` 啟動政策。工作負載運算子： `tee-monitoring-memory-enable` 中繼資料變數。	布林值	驗證認證實體的監控狀態。範例 `assertion.submods.confidential_space.monitoring_enabled.memory == true`
`assertion.submods.gce.instance_id`	字串	驗證 VM 執行個體 ID。範例 `assertion.submods.gce.instance_id == "0000000000000000000"`
`assertion.submods.gce.instance_name`	字串	驗證 VM 執行個體的名稱。範例 `assertion.submods.gce.instance_name == "workload-vm"`
`assertion.submods.gce.project_id`	字串	確認 VM 正在執行 Google Cloud 專案，且專案 ID 與指定 ID 相符。範例 `assertion.submods.gce.project_id == "project-id"`
`assertion.submods.gce.project_number`	字串	確認 VM 是在具有指定專案編號的 Google Cloud 專案中執行。範例 `assertion.submods.gce.project_number == "00000000000"`
`assertion.submods.gce.zone` 互動對象：工作負載運算子： `--zone` 值。	字串	確認 VM 是否在指定可用區中運作。範例 `assertion.submods.gce.zone == "us-central1-a"`
`assertion.submods.nvidia_gpu.cc_feature` 互動對象：工作負載運算子： `tee-install-gpu-driver` 中繼資料變數。	Enumeration	驗證 NVIDIA GPU 支援的機密運算功能。機密空間僅支援單一 GPU 直通 (SPT) 模式，因此值一律為 `SPT`。如要進一步瞭解 NVIDIA 機密運算支援，請參閱 NVIDIA Trusted Computing Solutions (PDF)。範例 `assertion.submods.nvidia_gpu.cc_feature == "SPT"`
`assertion.submods.nvidia_gpu.cc_mode` 互動對象：工作負載運算子： `tee-install-gpu-driver` 中繼資料變數。	Enumeration	驗證 NVIDIA 機密運算驅動程式的狀態。有效值如下： `OFF`：未啟用任何 NVIDIA 機密運算功能。 `ON`：NVIDIA H100 硬體、韌體和軟體已完全啟用機密運算功能。 `DEVTOOLS`：GPU 處於部分機密運算模式，與 `ON` 模式的工作流程相符，但會停用安全防護機制。範例 `assertion.submods.nvidia_gpu.cc_mode == "ON"`
`assertion.submods.nvidia_gpu.gpus` 互動對象：工作負載運算子： `tee-install-gpu-driver` 中繼資料變數。	物件陣列	驗證每個已認證 NVIDIA GPU 的聲明。Confidential Space 僅支援單一 GPU 宣告。 `gpus` 物件與下列內容類似： { "hwmodel": "GCP_NVIDIA_H100", "ueid": "490457405999046854973671575630853621547794591064", "l4_serial_number": "1216669666319372030078", "driver_version": "570.00", "vbios_version": "96.00.9F.00.01" } 範例下列程式碼會驗證第一個 GPU 硬體模型是否為在 Google Cloud上執行的 NVIDIA H100： `assertion.submods.nvidia_gpu.gpus[0].hwmodel == "GCP_NVIDIA_H100"` 下列程式碼會驗證認證聲明是否包含 GPU 相關聲明： `has(assertion.submods.nvidia_gpu.gpus)`

認證斷言 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

圖片聲明

範例

範例

範例

範例

容器斷言

範例

範例

範例

範例

範例

範例

範例

範例

VM 斷言

範例

範例

範例

範例

範例

範例

範例

範例

範例

範例

範例

認證斷言