ב-Agent Retrieval (לשעבר חיפוש וקטורי 2.0) אתם יכולים להגן על הנתונים במנוחה באמצעות מפתחות קריפטוגרפיים שמנוהלים דרך Cloud Key Management Service. השילוב הזה מאפשר לכם לשלוט במפתחות שמשמשים להצפנת תוכן הליבה של הלקוחות, כולל היכולת לבצע רוטציה של המפתחות האלה ולבטל אותם.
כברירת מחדל, הנתונים מוצפנים באמצעות ברירות המחדל של הפלטפורמה שמנוהלת על ידי Google. מפתחות CMEK מאפשרים לכם לשלוט ישירות במפתחות ההצפנה.
מידע נוסף זמין במסמכי התיעוד בנושא מפתחות הצפנה בניהול הלקוח (CMEK).
דרישות מוקדמות ומגבלות
כדי להשתמש ב-CMEK עם אוספים, צריך לעמוד בדרישות המוקדמות ובמגבלות הבאות:
מפתח Cloud KMS חייב להיות באותו אזור של Google Cloud האוסף שעליו הוא מגן. לדוגמה, אוסף באזור
us-central1חייב להשתמש במפתח Cloud KMS שנמצא ב-us-central1.אתם צריכים להקצות לחשבון השירות לכל מוצר ולכל פרויקט (P4) את התפקיד
cryptoKeyEncrypterDecrypterבמפתח Cloud KMS. חשבון השירות P4 הוא בפורמט הבא:service-${CONSUMER_PROJECT_NUMBER}@gcp-sa-vectorsearch.iam.gserviceaccount.com
יצירת אוסף שמוגן באמצעות CMEK
אחרי שתעמדו בכל הדרישות המוקדמות, תוכלו להשתמש ב-CLI של gcloud, ב-API בארכיטקטורת REST או ב-Python SDK כדי ליצור אוסף חדש עם CMEK.
באמצעות ה-CLI של gcloud
מציינים את מזהה המשאב המלא של מפתח Cloud KMS באמצעות הארגומנט --kms-key:
gcloud vector-search collections create [COLLECTION_ID] \
--kms-key projects/[KMS_PROJECT_ID]/locations/[REGION]/keyRings/[KEY_RING]/cryptoKeys/[KEY]
שימוש ב-API בארכיטקטורת REST
כוללים את encryption_spec בגוף הבקשה של POST:
{
"encryption_spec": {
"crypto_key_name": "projects/[PROJECT_ID]/locations/[REGION]/keyRings/[KEY_RING]/cryptoKeys/[KEY]"
}
}
שימוש ב-Python SDK
באמצעות Python SDK:
request = vectorsearch_v1beta.CreateCollectionRequest(
parent=f"projects/{PROJECT_ID}/locations/{LOCATION}",
collection_id=collection_id,
collection={
"data_schema": {...},
"vector_schema": {...},
# Specifies the customer-managed encryption key spec for a Collection
"encryption_spec": {
"crypto_key_name": f"projects/{PROJECT_ID}/locations/{LOCATION}/keyRings/{KEY_RING}/cryptoKeys/{KEY}"
}
},
)
operation = vector_search_service_client.create_collection(request=request)
operation.result()
העברת אובייקטים של נתונים מאוסף ללא CMEK לאוסף עם CMEK
אי אפשר להפעיל CMEK באוספים קיימים. במקום זאת, צריך להעביר את אובייקטי הנתונים לאוסף חדש שבו מופעל CMEK.
כדי לעשות את זה:
ייצוא של אובייקטי הנתונים מאוסף קיים לקטגוריה של Cloud Storage.
יוצרים אוסף חדש עם CMEK מופעל.
מייבאים את אובייקטי הנתונים לאוסף.
רוטציית מפתחות
כשמבצעים רוטציה של מפתח ב-Cloud KMS, נתונים חדשים מוצפנים באמצעות גרסת המפתח הראשית, ונתונים קיימים נשארים מוצפנים באמצעות הגרסה הקודמת. לפרטים נוספים, ראו רוטציית מפתחות.
ביטול מפתחות
ביטול או השבתה של מפתח משביתים את האוסף באופן מיידי. אינדקסי ה-ANN המשויכים מוסרים באופן אוטומטי והנתונים בזיכרון נמחקים. פעולות קריאה, כתיבה וחיפוש באוסף ייכשלו.
האוספים לא מופעלים מחדש באופן אוטומטי אם המפתח משוחזר.
משאבים שתומכים ב-CMEK
אלה המשאבים של Gemini Enterprise Agent Platform שמוצפנים באמצעות CMEK. התמיכה של CMEK בתכונות בגרסת טרום-השקה (Preview) נמצאת גם היא בסטטוס גרסת טרום-השקה (Preview).
| משאב | חומר הלימוד מוצפן | קישורים למאמרי עזרה |
|---|---|---|
| קבוצת נתונים | כל הנתונים שמיובאים על ידי המשתמשים (לדוגמה, תוכן טקסט) עבור DataItems ו-Annotations.
תוכן שנוצר על ידי משתמשים, כמו AnnotationSpecs, ColumnSpecs. |
יצירת מערך נתונים לאימון מודלים של סיווג ורגרסיה
יצירת מערך נתונים לאימון מודלים של חיזוי |
| אינדקס | כל קובצי הנתונים שמשמשים לחיפוש וקטורי באינדקסים של Gemini Enterprise Agent Platform שמאוחסנים ב-Cloud Storage, ב-Pub/Sub ובאחסון פנימי. צריך ליצור את Index ו-IndexEndpoint עם אותו מפתח.
כל האינדקסים באוסף חייבים להיווצר עם אותו מפתח. |
ניהול אינדקסים ב-חיפוש וקטורי: ניהול אינדקסים ב-חיפוש וקטורי 2 |
| אוספים | אוספים משמשים לאחסון אובייקטים קשורים של נתונים. | ניהול אוספים ב-חיפוש וקטורי 2 |
| DataObjects | אוספים מאחסנים נתונים כאובייקטים נפרדים של JSON שנקראים אובייקטים של נתונים. | ניהול אובייקטים של נתונים ב-Vector Search 2 |