Pernyataan pengesahan

Untuk mempelajari lebih lanjut cara menggunakan pernyataan pengesahan, lihat Membuat kebijakan pengesahan.

Pernyataan yang tersedia untuk membuat kebijakan pengesahan dijelaskan dalam tabel berikut. Kebijakan dapat memvalidasi pernyataan yang dibuat oleh image Confidential Space, container workload, dan instance VM.

Pernyataan gambar

Pernyataan Jenis Deskripsi

assertion.dbgstat

Berinteraksi dengan:

 Enumerasi

Memverifikasi bahwa image Confidential Space adalah versi debug atau produksi.

Nilai yang valid adalah sebagai berikut:

  • enable: Pastikan image debug sedang digunakan.
  • disabled-since-boot: Pastikan image produksi sedang digunakan.
Contoh

Kode berikut memverifikasi bahwa versi debug image Confidential Space sedang digunakan: 

assertion.dbgstat == "enable"

Kode berikut memverifikasi bahwa versi produksi image Confidential Space sedang digunakan: 

assertion.dbgstat == "disabled-since-boot"
assertion.submods.confidential_space.support_attributes Array string

Memverifikasi bahwa versi keamanan TEE adalah image Confidential Space produksi. Image Confidential Space debug tidak memiliki atribut dukungan yang ditetapkan.

Tabel berikut menjelaskan atribut dukungan yang ditemukan pada image Confidential Space produksi.

Atribut dukungan Deskripsi

LATEST

Image LATEST juga memiliki atribut dukungan berikut:

  • STABLE
  • USABLE

Masa aktif image: Sekitar satu bulan. Setelah itu, atribut dukungan LATEST akan dihapus.

Ini adalah versi terbaru image Confidential Space, serta didukung dan dipantau untuk mengetahui kerentanannya.

Untuk workload yang berjalan lama, sebaiknya jangan tentukan LATEST sebagai bagian dari kebijakan pengesahan Anda. Hal ini karena image Confidential Space mungkin diperbarui saat workload Anda berjalan, sehingga image Confidential Space yang Anda gunakan tidak lagi LATEST, dan menyebabkan workload Anda gagal dalam pengesahan saat token default Confidential Space diperbarui berikutnya.

STABLE

Image STABLE juga memiliki atribut dukungan berikut:

  • USABLE

Masa aktif gambar: Sekitar enam bulan. Mulai 1 April 2027, atribut dukungan STABLE akan dihapus setelah masa aktif image berakhir.

Image dengan atribut STABLE didukung dan dipantau untuk mengetahui kerentanan selama periode enam bulan. Sebaiknya tulis kebijakan pengesahan berdasarkan atribut STABLE.

Dalam kasus yang jarang terjadi, atribut STABLE dapat dihapus selama periode dukungan normal enam bulan, seperti saat kerentanan kritis ditemukan.

USABLE

Gambar yang hanya memiliki atribut USABLE masih dapat digunakan, tetapi dianggap tidak digunakan lagi. Image yang tidak digunakan lagi tidak didukung, dan berusia lebih dari enam bulan. Risiko dari penggunaan versi ini merupakan tanggung jawab Anda sendiri.

Image USABLE memiliki properti deprecated.deprecated. Nilainya adalah stempel waktu kapan image diperkirakan akan dihentikan penggunaannya. Properti image dapat dilihat dengan perintah gcloud compute images describe, atau dengan metode REST images.get. Contoh: 

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

Gambar yang hanya memiliki atribut ini akan menggunakan fitur pratinjau. Image EXPERIMENTAL hanya ditujukan untuk tujuan pengujian, dan tidak boleh digunakan dalam produksi.

Gambar EXPERIMENTAL tidak pernah memiliki atribut LATEST, STABLE, atau USABLE.

Sebaiknya selalu update image Confidential Space Anda. Untuk mempelajari cara mengupdate image Confidential Space, lihat Mengupdate image Confidential Space.

Contoh

Kode berikut memverifikasi bahwa versi stabil image Confidential Space sedang digunakan: 

"STABLE" in assertion.submods.confidential_space.support_attributes
assertion.swname Enumerasi

Memverifikasi software yang berjalan pada entitas pengesahan. Nilainya selalu CONFIDENTIAL_SPACE.

Contoh
assertion.swname == "CONFIDENTIAL_SPACE"
assertion.swversion Array string

Memverifikasi versi software image Confidential Space. Sebaiknya gunakan assertion.submods.confidential_space.support_attributes untuk menargetkan versi terbaru image.

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

Pernyataan container

Pernyataan Jenis Deskripsi

assertion.submods.container.cmd_override

Berinteraksi dengan:

 Array string

Memverifikasi perintah dan parameter CMD yang digunakan dalam image workload.

Contoh

Kode berikut memverifikasi bahwa CMD image workload belum ditimpa: 

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

Kode berikut memverifikasi bahwa program adalah satu-satunya konten dalam penggantian CMD: 

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

assertion.submods.container.env

Berinteraksi dengan:

 Objek JSON

Memverifikasi bahwa variabel lingkungan dan nilainya telah diteruskan secara eksplisit ke container.

Contoh

Kode berikut memverifikasi bahwa variabel lingkungan example-env-1 ditetapkan ke value-1, dan example-env-2 ditetapkan ke value-2. 

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

assertion.submods.container.env_override

Berinteraksi dengan:

 String

Memverifikasi apakah operator workload telah menimpa variabel lingkungan dalam container.

Contoh

Kode berikut memverifikasi bahwa operator workload belum mengganti variabel lingkungan example: 

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

Kode berikut memverifikasi bahwa operator workload belum menimpa variabel lingkungan apa pun: 

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

Memverifikasi ringkasan image container workload. Dengan menentukan kondisi ini, beberapa pihak dapat menyetujui workload yang diizinkan untuk mengakses data mereka.

Contoh
assertion.submods.container.image_digest == "sha256:837ccb607e312b170fac7383d7ccfd61fa5072793f19a25e75fbacb56539b86b"
assertion.submods.container.image_id String

Memverifikasi ID image container workload.

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

assertion.submods.container.image_reference

Berinteraksi dengan:

 String

Memverifikasi lokasi container workload yang berjalan di atas image Confidential Space.

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

assertion.submods.container.image_signatures

Berinteraksi dengan:

 Objek JSON

Memverifikasi bahwa image memiliki tanda tangan tertentu atau ditandatangani oleh kunci publik dan algoritma penandatanganan. Menentukan kondisi ini memungkinkan beberapa pihak menyetujui workload yang diizinkan untuk mengakses data mereka.

Pernyataan dapat menyertakan elemen berikut:

  • key_id: Sidik jari heksadesimal kunci publik. Untuk mendapatkan sidik jari, Anda dapat menjalankan perintah berikut: 

    openssl pkey -pubin -in public_key.pem -outform DER | openssl sha256

    Dengan public_key.pem adalah kunci publik Anda dalam format PEM.

  • signature: Tanda tangan atas payload yang terkait dengan container yang ditandatangani dan yang mengikuti format Simple Signing.

  • signature_algorithm: Algoritma yang digunakan untuk menandatangani kunci. Salah satu dari berikut ini:

    • RSASSA_PSS_SHA256 (RSASSA-PSS dengan ringkasan SHA-256)
    • RSASSA_PKCS1V15_SHA256 (RSASSA-PKCS1 v1_5 dengan ringkasan SHA-256)
    • ECDSA_P256_SHA256 (ECDSA pada Kurva P-256 dengan ringkasan SHA-256)
Contoh
['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

Berinteraksi dengan:

 Enumerasi

Memverifikasi kebijakan mulai ulang peluncur container saat workload berhenti.

Nilai yang valid adalah sebagai berikut:

  • Never (default)
  • Always
  • OnFailure
Contoh
assertion.submods.container.restart_policy == "Never"

Pernyataan VM

Pernyataan Jenis Deskripsi

assertion.google_service_accounts

Berinteraksi dengan:

 Array string

Memverifikasi bahwa akun layanan yang ditentukan terhubung ke VM yang menjalankan workload, atau telah dicantumkan menggunakan tee-impersonate-service-accounts dalam metadata VM.

Contoh
workload-service-account@my-project.iam.gserviceaccount.com in assertion.google_service_accounts
assertion.hwmodel String

Memverifikasi teknologi Confidential Computing yang mendasarinya. Platform yang didukung adalah sebagai berikut:

  • GCP_AMD_SEV
  • INTEL_TDX
Contoh
assertion.hwmodel == "GCP_AMD_SEV"

assertion.submods.confidential_space.monitoring_enabled

Berinteraksi dengan:

 Boolean

Memverifikasi status pemantauan pada entitas pengesahan.

Contoh
assertion.submods.confidential_space.monitoring_enabled.memory == true
assertion.submods.gce.instance_id String

Memverifikasi ID instance VM.

Contoh
assertion.submods.gce.instance_id == "0000000000000000000"
assertion.submods.gce.instance_name String

Memverifikasi nama instance VM.

Contoh
assertion.submods.gce.instance_name == "workload-vm"
assertion.submods.gce.project_id String

Memverifikasi bahwa VM menjalankan project Google Cloud dengan project ID yang ditentukan.

Contoh
assertion.submods.gce.project_id == "project-id"
assertion.submods.gce.project_number String

Memverifikasi bahwa VM berjalan di project Google Cloud dengan nomor project yang ditentukan.

Contoh
assertion.submods.gce.project_number == "00000000000"

assertion.submods.gce.zone

Berinteraksi dengan:

 String

Memverifikasi bahwa VM berjalan di zona yang ditentukan.

Contoh
assertion.submods.gce.zone == "us-central1-a"

assertion.submods.nvidia_gpu.cc_feature

Berinteraksi dengan:

 Enumerasi

Memverifikasi fitur Confidential Computing yang didukung oleh GPU NVIDIA. Hanya mode passthrough GPU tunggal (SPT) yang didukung di Confidential Space, sehingga nilainya selalu SPT.

Untuk mengetahui informasi selengkapnya tentang dukungan NVIDIA Confidential Computing, lihat NVIDIA Trusted Computing Solutions (PDF).

Contoh
assertion.submods.nvidia_gpu.cc_feature == "SPT"

assertion.submods.nvidia_gpu.cc_mode

Berinteraksi dengan:

 Enumerasi

Memverifikasi status driver Confidential Computing NVIDIA. Nilai yang valid adalah sebagai berikut:

  • OFF: tidak ada fitur Confidential Computing NVIDIA yang aktif.
  • ON: hardware, firmware, dan software NVIDIA H100 telah sepenuhnya mengaktifkan fitur confidential computing.
  • DEVTOOLS: GPU berada dalam mode confidential computing parsial yang cocok dengan alur kerja mode ON, tetapi menonaktifkan perlindungan keamanan.
Contoh
assertion.submods.nvidia_gpu.cc_mode == "ON"

assertion.submods.nvidia_gpu.gpus

Berinteraksi dengan:

 Array objek

Memverifikasi klaim untuk setiap GPU NVIDIA yang di-attestasi. Confidential Space hanya mendukung satu klaim GPU.

Objek gpus mirip dengan yang berikut ini:

{
  "hwmodel": "GCP_NVIDIA_H100",
  "ueid": "490457405999046854973671575630853621547794591064",
  "l4_serial_number": "1216669666319372030078",
  "driver_version": "570.00",
  "vbios_version": "96.00.9F.00.01"
}
Contoh

Kode berikut memverifikasi bahwa model hardware GPU pertama adalah NVIDIA H100 yang berjalan di Google Cloud: 

assertion.submods.nvidia_gpu.gpus[0].hwmodel == "GCP_NVIDIA_H100"

Kode berikut memverifikasi bahwa klaim pengesahan memiliki klaim terkait GPU: 

has(assertion.submods.nvidia_gpu.gpus)