טענות של טוקן אימות ב-Confidential Space

תלונות ברמה העליונה

בטבלה הבאה מתוארים התביעות ברמה העליונה באסימון האימות. הפריטים האלה תואמים למפרט OpenID Connect 1.0.

מידע נוסף על אסימוני אישור

מפתח סוג תיאור
כותרת
x5c String מופיע רק באסימוני PKI. שרשרת האישורים לאימות טוקנים של PKI. אפשר להוריד את אישור הבסיס מ נקודת הקצה לאימות טוקן PKI.
מטען ייעודי (payload) של נתוני JSON
attester_tcb מערך של מחרוזות

רכיב TCB (בסיס מחשוב מהימן) אחד או יותר. התביעה הזו נועדה לציין את המקור של הוכחת האימות.

במקרה של hwmodel claim "GCP_INTEL_TDX" ב-Confidential Space, הערך הוא ["INTEL"], מה שמציין ששורש המהימנות של האימות מגיע מטכנולוגיית חומרה ספציפית של Intel.

aud String

הקהל. באסימון ברירת המחדל שמשמש עם מאגר זהויות של כוח עבודה, הקהל הוא https://sts.googleapis.com. האסימון הזה מאוחזר כל שעה על ידי מרכז האפליקציות במופע של מכונה וירטואלית חסויה.

במקרה של אסימונים עם קהלים בהתאמה אישית, הקהל מועתק מהקהל בבקשת האסימון. האורך המקסימלי הוא 512 בייטים.

dbgstat String סטטוס הניפוי באגים של התמונה של Confidential Space. בתמונות בסביבת הייצור, הערך הוא disabled-since-boot. בתמונות לניפוי באגים, הערך הוא enabled.
eat_nonce מחרוזת או מערך של מחרוזות ערך nonce אחד או יותר עבור טוקן האימות. הערכים מוחזרים מאפשרויות האסימון שנשלחו בבקשה לאסימון מותאם אישית. כל ערך nonce צריך להיות בין 8 ל-88 בייט, כולל. אפשר להוסיף עד שישה ערכי nonce.
exp מספר שלם, חותמת זמן של Unix תאריך התפוגה שעד אליו הטוקן תקף לעיבוד. הערך הוא מספר JSON שמייצג את מספר השניות מ-1970-01-01T0:0:0Z, שנמדד ב-UTC, עד למועד התפוגה.
google_service_accounts מערך של מחרוזות חשבונות השירות שאומתו ומריצים את עומס העבודה של Confidential Space.
hwmodel ספירה

המזהה הייחודי של אסימון החומרה. צריך לציין אחד מהערכים הבאים:

  • GCP_AMD_SEV
  • GCP_AMD_SEV_ES
  • GCP_SHIELDED_VM
  • GCP_INTEL_TDX
https://aws.amazon.com/tags אובייקט טענות לגבי תגי חשבון משתמש ב-AWS
iat מספר שלם, חותמת זמן של Unix השעה שבה הונפק ה-JWT. הערך הוא מספר JSON שמייצג את מספר השניות מ-1970-01-01T0:0:0Z שנמדד ב-UTC עד לזמן הנפקת האישור.
iss String

הישות שהנפיקה את האסימון. כתובות ה-URI של המנפיקים התקפים הן:

  • Google Cloud Attestation: https://confidentialcomputing.googleapis.com
  • ‫Intel Trust Authority:‏ https://portal.trustauthority.intel.com
nbf מספר שלם, חותמת זמן של Unix הזמן שאחריו מותר לעבד את ה-JWT. הערך הוא מספר JSON שמייצג את מספר השניות מ-1970-01-01T0:0:0Z, שנמדד ב-UTC.
oemid Uint64 הערך משתנה בהתאם לשירות האימות. במקרה של אימות ב-Google Cloud, זהו מספר ארגוני פרטי (PEN) של Google, ‏ 11129.
secboot בוליאני האם ההפעלה המאובטחת מופעלת, כדי לוודא שהקושחה ומערכת ההפעלה מאומתות במהלך תהליך האתחול של המכונה הווירטואלית. הערך הזה תמיד יהיה true.
sub String הנושא, שהוא מזהה המכונה הווירטואלית המוגדר במלואו של המכונה הווירטואלית הסודית. לדוגמה, https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_ID. הפורמט הזה נקרא selfLink של המופע.
submods אובייקט אובייקט שמכיל תלונות שונות. מידע על תלונות של מודים משניים
tdx מערך של אובייקטים מערך של תלונות שונות. מידע על טענות של Intel TDX
swname String

השם של מערכת ההפעלה שאושרה למכונת ה-VM.

הערכים האפשריים הם CONFIDENTIAL_SPACE או GCE. הערך CONFIDENTIAL_SPACE מיועד לתמונות מוקשחות של Confidential Space ולתמונות של Confidential Space לניפוי באגים שעברו את כל תהליך האימות.
swversion מערך של מחרוזות

הגרסה של מערכת ההפעלה. הערך הוא מערך של מחרוזות שמכיל רק ערך אחד.

הגרסה היא בפורמט YYYYMM##, כאשר ## הוא מונה של מספר התמונות שפורסמו לפני התמונה שבה נעשה שימוש באותו חודש.

טענות לגבי תגי ישויות ב-AWS

בטבלה הבאה מתוארות ההצהרות AWS_PrincipalTag באסימון האימות. התלונות האלה מופיעות ב-https://aws.amazon.com/tags claims, באובייקט principal_tags בטוקן האימות. מידע על מבנה הטענה https://aws.amazon.com/tags מופיע במאמר טענות של תגי AWS principal.

מפתח סוג תיאור
confidential_space.support_attributes מערך של מחרוזות

תביעה נגזרת של מאפייני תמיכה. זהו ייצוג של התביעות המקוריות כמחרוזת משורשרת.

לדוגמה, אם התביעות המקוריות הן Latest, Stable ו-Usable, המאפיין הזה מכיל את הערך LATEST=STABLE=USABLE. אם התלונה המקורית היא רק Usable, המאפיין הזה מכיל USABLE.

container.image_digest מערך של מחרוזות

מידע על טענות (claims) של קונטיינרים של עומסי עבודה

חתימות וערכי גיבוב של קובצי אימג' של קונטיינר לא מופיעים יחד בטוקן אחד. אם אתם משתמשים ב-container.image_digest במדיניות שלכם ב-AWS, אתם צריכים להסיר את כל ההפניות אל container.signatures.key_ids.

container.signatures.key_id מערך של מחרוזות

רשימה משורשרת של מזהי מפתחות חתימה של קובץ אימג' של קונטיינר. השדה הזה מייצג כמה מזהים של מפתחות חתימה שמצורפים למחרוזת אחת במערך.

לדוגמה, אם יש לכם מזהי מפתחות aKey1, zKey2 ו-bKey3, ההצהרה הזו מכילה את הערך aKey1=bKey3=zKey2.

חתימות וערכי גיבוב של קובצי אימג' של קונטיינר לא מופיעים יחד בטוקן אחד. אם אתם משתמשים ב-container.signatures.key_ids במדיניות שלכם ב-AWS, אתם צריכים להסיר את כל ההפניות אל container.image_digest.

מידע נוסף על הצהרות חתימה של קובץ אימג' של קונטיינר זמין במאמר בנושא מדיניות AWS עם הצהרות חתימה של קובץ אימג' של קונטיינר.

gce.project_id מערך של מחרוזות מידע נוסף על תביעות ב-Compute Engine
gce.zone מערך של מחרוזות מידע נוסף על תביעות ב-Compute Engine

תלונות בנושא Intel TDX

בטבלה הבאה מתוארים הטענות tdx באסימון האימות.

מפתח סוג תיאור
gcp_attester_tcb_status String

ערך מחרוזת שמייצג את סטטוס רמת ה-TCB של Google Cloud הפלטפורמה שנבדקת. מידע נוסף על tcbStatus זמין במסמכי התיעוד של Intel בנושא Provisioning Certification Service API.

הטענה הזו מציינת שגרסת ה-TCB של TDX הייתה עדכנית בהשוואה לערכי ההפניה של Intel כש-Google התחילה את השקת הקושחה. עם זאת, היא לא מבטיחה שהצי של Google יישאר מעודכן עם ערכי ההפניה של TCB בזמן אמת של Intel.

gcp_attester_tcb_date String תאריך ה-TCB של הפלטפורמה Google Cloud שנבדקה. ערך השעה הוא UTC בפורמט ISO 8601 (YYYY-MM-DDThh:mm:ssZ).
tcb_evaluation_data_number Uint32

מספר סידורי שמייצג את הגרסה של נתוני ההערכה של TCB. ‫Intel מגדילה את המספר הזה בכל פעם שהנתונים מתעדכנים.

מידע נוסף על tcbEvaluationDataNumber זמין במסמכי התיעוד של Intel בנושא Provisioning Certification Service API.

תלונות לגבי תת-מודים

בטבלה הבאה מתוארים הטענות submods באסימון האימות.

מפתח סוג תיאור
confidential_space.support_attributes מערך של מחרוזות המערך יכול להכיל את הערכים EXPERIMENTAL,‏ USABLE,‏ STABLE ו-LATEST. מידע נוסף זמין במאמר מחזור החיים של תמונות Confidential Space.
confidential_space.monitoring_enabled אובייקט בעמודה הזו מוצג סוג המעקב אחרי המערכת שמופעל. הערך יכול להיות {"memory":false} או {"memory":true}.
container אובייקט תלונות על הפרת זכויות יוצרים בקונטיינרים של עומסי עבודה
gce אובייקט מידע נוסף על תביעות ב-Compute Engine
nvidia_gpu אובייקט מידע על תביעות בנושא GPU של NVIDIA

טענות לגבי Compute Engine

בטבלה הבאה מתוארים הטענות gce באסימון האימות.

מפתח סוג תיאור
instance_id String מזהה מכונת ה-VM.
instance_name String שם מכונת ה-VM.
project_id String מזהה הפרויקט של הפרויקט שבו המכונה הווירטואלית פועלת.
project_number String מספר הפרויקט שבו מכונת ה-VM פועלת.
zone String התחום (zone) של Compute Engine שבו פועלת מכונת Confidential VM.

תביעות בנושא NVIDIA GPU

בטבלה הבאה מתוארים הטענות nvidia_gpu באסימון האימות.

מפתח סוג תיאור
cc_feature ספירה

ה-Confidential Computing נתמך על ידי GPU של NVIDIA. ב-Confidential Space יש תמיכה רק במצב העברת GPU יחיד (SPT), ולכן הערך תמיד יהיה SPT.

מידע נוסף על תמיכה ב-Confidential Computing של NVIDIA זמין במאמר NVIDIA Trusted Computing Solutions (פתרונות מחשוב מהימן של NVIDIA) (PDF).

cc_mode ספירה

הסטטוס של Confidential Computing ב-GPU של NVIDIA. הטענה הזו מאשרת רק את מנהל ההתקן של ה-GPU, ולא את כל מכשיר ה-GPU.

הערך יכול להיות אחד מהערכים הבאים:

  • ‫OFF: אף אחת מהתכונות של NVIDIA Confidential Computing לא פעילה.
  • ‫ON: החומרה, הקושחה והתוכנה של NVIDIA H100 הפעילו באופן מלא את התכונות של מחשוב חסוי.
  • ‫DEVTOOLS: ה-GPU נמצא במצב Confidential Computing חלקי שתואם לתהליכי העבודה של מצב ON, אבל אמצעי ההגנה מושבתים.
gpus מערך של אובייקטים

מידע על חומרה ותוכנה של GPU

טענות לגבי חומרה ותוכנה של GPU

מפתח סוג תיאור
driver_version String

גרסת הדרייבר של NVIDIA שפועלת במכונה וירטואלית סודית. לדוגמה, 590.48.01.

hwmodel ספירה

ארכיטקטורת NV_GPU. יש תמיכה רק ב-H100 של NVIDIA, ולכן הערך תמיד יהיה GCP_NVIDIA_H100.

l4_serial_number מחרוזת הקסדצימלית

המספר הסידורי של שרשרת האישורים של אימות NVIDIA GPU ברמה הרביעית.

ueid מחרוזת הקסדצימלית

מזהה הישות האוניברסלי בהתאם ל-RFC 9711. זהו מזהה מכשיר ייחודי למכשיר NVIDIA GPU מאומת.

vbios_version String

גרסת ה-VBIOS של ה-GPU של NVIDIA שאומתה. לדוגמה, 96.00.CF.00.01.

תביעות על קונטיינרים של עומסי עבודה

בטבלה הבאה מתוארים הטענות container באסימון האימות. מידע נוסף על הטענות האלה זמין במאמר בנושא טענות אימות.

מפתח סוג תיאור
args מערך של מחרוזות הערך המלא של argv שהמאגר מופעל איתו. התביעה הזו כוללת את נתיב נקודת הכניסה של הקונטיינר וארגומנטים נוספים של שורת הפקודה.
cmd_override מערך של מחרוזות הפקודות והפרמטרים של CMD שבהם נעשה שימוש בתמונת עומס העבודה.
env אובייקט משתני הסביבה והערכים שלהם שהועברו באופן מפורש למאגר.
env_override אובייקט משתני הסביבה שהוחלפו במאגר התגים.
image_digest String התקציר של תמונת הקונטיינר של עומס העבודה.
image_id String מזהה התמונה של קונטיינר עומס העבודה.
image_reference String המיקום של מאגר עומס העבודה שפועל ב-Confidential Space.
image_signatures מערך של אובייקטים ראו תלונות בנושא חתימות של קובצי אימג' של קונטיינרים.
restart_policy ספירה מדיניות ההפעלה מחדש של מפעיל הקונטיינר כשהעומס מופסק. הערכים התקפים הם Always,‏ OnFailure ו-Never. ברירת המחדל היא Never.

תלונות על חתימות של קובצי אימג' של קונטיינרים

בטבלה הבאה מתוארים התביעות image_signatures באסימון האימות.

מפתח סוג תיאור
key_id String

טביעת האצבע ההקסהדצימלית של המפתח הציבורי. כדי לקבל את טביעת האצבע, מריצים את הפקודה הבאה: 

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

כאשר public_key.pem הוא המפתח הציבורי בפורמט PEM.

signature String החתימה בקידוד base64 של מטען ייעודי (payload) שמשויך למאגר החתום ושעומד ב פורמט החתימה הפשוט.
signature_algorithm ספירה

האלגוריתם שמשמש לחתימת המפתח. אחת מהאפשרויות הבאות:

  • ‫RSASSA_PSS_SHA256 (RSASSA-PSS עם תמצית SHA-256 )
  • ‫RSASSA_PKCS1V15_SHA256 (RSASSA-PKCS1 v1_5 עם תקציר SHA-256)
  • ‫ECDSA_P256_SHA256 (ECDSA על עקומת P-256 עם תמצית SHA-256)

המאמרים הבאים