הגדרת מפתחות הצפנה בניהול הלקוח (CMEK) לארגזי חול

הצפנת נתונים במנוחה של ארגז חול באמצעות מפתח Cloud Key Management Service שבבעלותכם ובשליטתכם.

סקירה כללית

כברירת מחדל, Google Cloud מצפינה את הנתונים במנוחה באמצעות Google-owned and Google-managed encryption keys. מפתחות הצפנה בניהול הלקוח (CMEK) מאפשרים ליצור ולנהל מפתח הצפנה של Cloud KMS, כדי שתוכלו לבדוק את השימוש בו, להחליף אותו, להשבית או להשמיד אותו, וכך להפוך את הנתונים המוגנים לבלתי קריאים.

ארגז החול של Gemini Enterprise Agent Platform מריץ את הקוד, הדפדפן או הקונטיינר בהתאמה אישית של הסוכן בסביבה מבודדת. הסביבה הזו כותבת את תוכן הלקוח בדיסק, ואפשר ליצור נקודות ביקורת לתמונות מצב שמוגנות על ידי CMEK כשמפעילים אותו במכונה הראשית של Gemini Enterprise Agent Platform בארגז החול.

אפשר להגדיר CMEK לסביבות ה-Sandbox של Gemini Enterprise Agent Platform רק כשיוצרים את המכונה של Gemini Enterprise Agent Platform. מפתח ה-CMEK מאבטח את המכונה של Gemini Enterprise Agent Platform ואת משאבי המשנה שלה, כולל סביבות ה-sandbox, התבניות ותמונות המצב.

מה מוצפן באמצעות CMEK בארגז החול

כשמפעילים את CMEK במכונה הראשית של Gemini Enterprise Agent Platform, המשטחים במצב מנוחה של ארגז החול מוצפנים באמצעות המפתח שלכם:

  • דיסק אתחול של צומת GKE / מערכת קבצים בסיסית: קבצים שהסשן כותב בזמן הריצה ומצב בזיכרון שמועבר לדפים בדיסק (CMEK של דיסק אתחול של צומת).
  • קטגוריית Cloud Storage של תמונת מצב: נקודות ביקורת של דיסק וזיכרון של ארגז חול (תמונות מצב) (הצפנת ברירת מחדל של קטגוריה).

מטא-נתונים של משאבים (שמות, תוויות, מצב, פרטי חיבור), משתני סביבה וכתובות אימייל של חשבונות שירות לא מוצפנים באמצעות מפתח CMEK.

כדי להצפין קובצי אימג' בהתאמה אישית של קונטיינרים, צריך להגדיר CMEK במאגר Artifact Registry שלכם.

מגבלות ושיקולים

  • ב-CMEK ב-Gemini Enterprise Agent Platform יש תמיכה רק במפתחות לאזור יחיד. אין תמיכה במפתחות במספר אזורים, בשני אזורים ובאופן גלובלי.
  • אי אפשר לשנות את המפתח אחרי שיוצרים את המכונה של Gemini Enterprise Agent Platform. כדי להשתמש במפתח אחר, צריך ליצור מכונה חדשה של Gemini Enterprise Agent Platform. יש תמיכה ברוטציה לגרסאות חדשות של אותו מפתח, והיא מיושמת באופן אוטומטי.
  • אם משביתים או משמידים את גרסת המפתח, או מבטלים את התפקיד "הצפנה/פענוח", אי אפשר להקצות או להמשיך את ארגזי החול, והכתיבה של קובצי snapshot נכשלת. כדי לשחזר את המשאבים בארגז החול, צריך לשחזר את הגישה למפתח.

לפני שמתחילים

  • צריך להיות לכם אוסף מפתחות ומפתח של Cloud KMS, או שאתם צריכים ליצור אותם. מומלץ לשמור את המפתחות בפרויקט נפרד מעומסי העבודה של Gemini Enterprise Agent Platform, שמנוהל על ידי אדמין אחר.
  • מוודאים שיש לכם את התפקידים שמאפשרים ליצור ולנהל מפתחות (roles/cloudkms.admin) וליצור את המכונה של Gemini Enterprise Agent Platform.
  • אם עדיין לא עשיתם את זה, צרו סוכן שירות של Agent Runtime:

    # Create the service agent if needed
    gcloud beta services identity create \
        --service=aiplatform.googleapis.com \
        --project=PROJECT_ID
    

יצירת מפתח Cloud KMS

יוצרים מפתח לאזור אחד באותו אזור שבו נמצא המכונה של Gemini Enterprise Agent Platform:

# Key ring (once per region)
gcloud kms keyrings create sandbox-keyring \
    --location=REGION

# Key
gcloud kms keys create sandbox-key \
    --location=REGION \
    --keyring=sandbox-keyring \
    --purpose=encryption

מחליפים את מה שכתוב בשדות הבאים:

  • ‫REGION: האזור Google Cloud של המכונה של Gemini Enterprise Agent Platform (לדוגמה, us-central1).

איך נותנים לסוכן השירות של Agent Platform גישה למפתח

מקצים לסוכן השירות של Agent Runtime את התפקיד 'הצפנה/פענוח של מפתח CryptoKey ב-Cloud KMS' (roles/cloudkms.cryptoKeyEncrypterDecrypter) במפתח:

# Grant Encrypter/Decrypter on the key
gcloud kms keys add-iam-policy-binding sandbox-key \
    --location=REGION \
    --keyring=sandbox-keyring \
    --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-aiplatform-re.iam.gserviceaccount.com" \
    --role="roles/cloudkms.cryptoKeyEncrypterDecrypter"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_NUMBER: מספר הפרויקט ב- Google Cloud .

הפעלת CMEK במכונה של Agent Platform

מגדירים את encryption_spec.kms_key_name כשיוצרים את המכונה של Gemini Enterprise Agent Platform. כל תבנית של ארגז חול וכל ארגז חול שיוצרים במסגרתה יורשים את המפתח הזה.

Python SDK

import vertexai

client = vertexai.Client(project="PROJECT_ID", location="REGION",
                        http_options={"api_version": "v1beta1"})
agent_instance = client.agent_engines.create(
    config={
        "encryption_spec": {
            "kms_key_name":
                "projects/PROJECT_ID/locations/REGION/keyRings/sandbox-keyring/cryptoKeys/sandbox-key"
        }
    },
)

REST

באמצעות ה-API בארכיטקטורת REST, מגדירים את אותו הערך ב-reasoningEngines.encryptionSpec.kmsKeyName בזמן היצירה:

curl -X POST \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  https://REGION-aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/REGION/reasoningEngines \
  -d '{
    "display_name": "cmek-protected-engine",
    "encryption_spec": {
      "kms_key_name": "projects/PROJECT_ID/locations/REGION/keyRings/sandbox-keyring/cryptoKeys/sandbox-key"
    }
  }'

יצירת ארגז חול ואימות ההגדרה של CMEK

  1. יוצרים את התבנית לארגז החול ואת ארגז החול במכונה של Gemini Enterprise Agent Platform שמוגנת באמצעות CMEK.
  2. כדי לוודא שהמכונה של Gemini Enterprise Agent Platform מדווחת על המפתח ב-encryption_spec.kms_key_name, מבקשים את פרטי המכונה.
  3. אופציונלי: בודקים את יומני הביקורת של Cloud KMS כדי לוודא שפעולות ההצפנה והפענוח מתרחשות כשארגזי החול מתחילים לפעול וכשתמונות המצב נכתבות.

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