הגדרת הצדקות גישה למפתחות באמצעות Cloud HSM
בדף הזה מוסבר איך להגדיר הצדקות לבקשות גישה למפתחות (KAJ) באמצעות Cloud HSM, בשביל גבולות הנתונים של יפן ב-Assured Workloads.
במהלך השלבים ליצירת תיקייה חדשה של Assured Workloads ל-Japan Data Boundary, אתם יכולים ליצור פרויקט חדש ואוסף מפתחות למפתחות הקריפטוגרפיים שלכם. אפשר להוסיף לאוסף המפתחות הזה מפתחות של Cloud HSM, וגם להגדיר מדיניות של הצדקות לגישה למפתחות כדי לשלוט בגישה לכל מפתח.
לפני שמתחילים
- האפשרות להשתמש ב-Key Access Justifications עם מפתחות Cloud HSM זמינה רק ל-Japan Data Boundary ב-Assured Workloads.
- ודאו שהאדמין הקצה לכם את אחד מהתפקידים הנדרשים בניהול הזהויות והרשאות הגישה (IAM) כדי ליצור ולנהל את כללי המדיניות של Key Access Justifications ואת מפתחות Cloud HSM עצמם.
הרשאות IAM נדרשות
כדי לקבל את ההרשאות שנדרשות ליצירה ולניהול של מפתחות Cloud HSM וכללי המדיניות שלהם בנושא הצדקות גישה למפתחות, בקשו מהאדמין להקצות לכם את התפקיד אדמין של Cloud KMS (roles/cloudkms.admin) ב-IAM בפרויקט שמכיל את אוסף המפתחות.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקיד המוגדר מראש הזה מכיל את ההרשאות שנדרשות כדי ליצור ולנהל מפתחות Cloud HSM ואת כללי המדיניות שלהם בנושא הצדקות לגישה למפתחות. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי ליצור ולנהל מפתחות Cloud HSM ואת כללי המדיניות שלהם בנושא הצדקות לגישה למפתחות, נדרשות ההרשאות הבאות:
-
cloudkms.cryptoKeys.create -
cloudkms.cryptoKeys.update -
cloudkms.cryptoKeys.get
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
הגדרת מפתח Cloud HSM עם הצדקות גישה למפתחות (KAJ)
כדי להגדיר הצדקות לגישה למפתחות באמצעות מפתח Cloud HSM, אתם יכולים לכלול את מדיניות הגישה למפתחות כפרמטר כשאתם יוצרים את המפתח, או לעדכן את המפתח באמצעות המדיניות אחרי שהמפתח נוצר.
יצירת מפתח ומדיניות חדשים
REST
יוצרים מפתח ומדיניות חדשים באמצעות ה-method cryptoKeys.create:
POST https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys?crypto_key_id=KEY_NAME
בבקשה, מחליפים את הערכים הזמניים לשמירת מקום (פלייסהולדר) הבאים:
- PROJECT_ID: מזהה הפרויקט שמכיל את אוסף המפתחות שבו רוצים להוסיף מפתח, לדוגמה
919698201234. - LOCATION: המיקום של אוסף המפתחות, לדוגמה
us-west1. - KEY_RING: השם של אוסף המפתחות שציינתם כשיצרתם את הפרויקט לניהול מפתחות ואת אוסף המפתחות של התיקייה ב-Assured Workloads, לדוגמה
my-key-ring. - KEY_NAME: השם של מפתח ה-HSM שרוצים ליצור, לדוגמה
my-hsm-key.
גוף הבקשה:
{ "purpose": "PURPOSE", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "ALGORITHM" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ ALLOWED_ACCESS_REASONS ] } }
בגוף הבקשה, מחליפים את הערכים הזמניים הבאים לשמירת מקום (placeholder):
- PURPOSE: המטרה של המפתח. לרשימה של מטרות שונות של מפתחות, ראו מטרות של מפתחות – לדוגמה,
ENCRYPT_DECRYPT. - ALGORITHM: האלגוריתם הקריפטוגרפי שבו משתמשים. במאמר אלגוריתמים של Cloud KMS מופיעה רשימה של האלגוריתמים הזמינים, למשל
GOOGLE_SYMMETRIC_ENCRYPTION. - ALLOWED_ACCESS_REASONS: מדיניות הצדקות הגישה למפתחות, שמגדירה אפס או יותר קודי הצדקה מותרים לגישה למפתח ההצפנה, לדוגמה
["CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION"].
בדוגמה הבאה, הבקשה וגוף הבקשה מאפשרים הצדקות גישה רק מכמה סיבות:
POST https://cloudkms.googleapis.com/v1/projects/919698201234/locations/us-west1/keyRings/my-key-ring/cryptoKeys?crypto_key_id=my-hsm-key
{ "purpose": "ENCRYPT_DECRYPT", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ "CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION" ] } }
עדכון מדיניות של מפתח קיים
REST
מעדכנים מפתח קיים ב-Cloud KMS באמצעות השיטה cryptoKeys.patch:
PATCH https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAME?update_mask=keyAccessJustificationsPolicy
בבקשה, מחליפים את הערכים הזמניים לשמירת מקום (פלייסהולדר) הבאים:
- PROJECT_ID: מזהה הפרויקט שמכיל את אוסף המפתחות של המפתח, לדוגמה
919698201234. - LOCATION: המיקום של אוסף המפתחות, לדוגמה
us-west1. - KEY_RING: השם של אוסף המפתחות שציינתם כשיצרתם את הפרויקט לניהול מפתחות ואת אוסף המפתחות של התיקייה ב-Assured Workloads, לדוגמה
my-key-ring. - KEY_NAME: השם של מפתח ה-HSM שרוצים לעדכן, לדוגמה
my-hsm-key.
גוף הבקשה:
{ "purpose": "PURPOSE", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "ALGORITHM" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ ALLOWED_ACCESS_REASONS ] } }
בגוף הבקשה, מחליפים את הערכים הזמניים הבאים לשמירת מקום (placeholder):
- PURPOSE: המטרה של המפתח. לרשימה של מטרות שונות של מפתחות, ראו מטרות של מפתחות – לדוגמה,
ENCRYPT_DECRYPT. - ALGORITHM: האלגוריתם הקריפטוגרפי שבו משתמשים. במאמר אלגוריתמים של Cloud KMS מופיעה רשימה של האלגוריתמים הזמינים, למשל
GOOGLE_SYMMETRIC_ENCRYPTION. - ALLOWED_ACCESS_REASONS: מדיניות הצדקות הגישה למפתחות, שמגדירה אפס או יותר קודי הצדקה מותרים לגישה למפתח ההצפנה, לדוגמה
["CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION"].
בדוגמה הבאה, הבקשה וגוף הבקשה מאפשרים הצדקות גישה רק מכמה סיבות:
PATCH https://cloudkms.googleapis.com/v1/projects/919698201234/locations/us-west1/keyRings/my-key-ring/cryptoKeys/my-hsm-key?keyAccessJustificationsPolicy{ "purpose": "ENCRYPT_DECRYPT", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ "CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION" ] } }
קבלת המדיניות של הצדקות גישה למפתחות (KAJ) של מפתח
REST
משיגים מטא-נתונים על מפתח קיים ב-Cloud KMS באמצעות השיטה cryptoKeys.get:
GET https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings/KEY_RING/cryptoKeys/KEY_NAMEבפרמטרים של הבקשה, מחליפים את הערכים הזמניים לשמירת מקום (placeholder) הבאים בערכים שלכם:
- PROJECT_ID: מזהה הפרויקט שמכיל את אוסף המפתחות של המפתח, לדוגמה
919698201234. - LOCATION: המיקום של אוסף המפתחות, לדוגמה
us-west1. - KEY_RING: השם של אוסף המפתחות שציינתם כשיצרתם את הפרויקט לניהול מפתחות ואת אוסף המפתחות של התיקייה ב-Assured Workloads, לדוגמה
my-key-ring. - KEY_NAME: השם של מפתח ה-HSM שרוצים לקבל, לדוגמה
my-hsm-key.
הבקשה הבאה לדוגמה מקבלת מטא-נתונים על מפתח ב-Cloud KMS:
GET https://cloudkms.googleapis.com/v1/projects/919698201234/locations/us-west1/keyRings/my-key-ring/cryptoKeys/my-hsm-keyגוף התשובה מכיל מטא-נתונים על המפתח, כולל keyAccessJustificationsPolicy.
לדוגמה:
{ "purpose": "ENCRYPT_DECRYPT", "versionTemplate": { "protectionLevel": "HSM", "algorithm": "GOOGLE_SYMMETRIC_ENCRYPTION" }, "keyAccessJustificationsPolicy": { "allowedAccessReasons": [ "CUSTOMER_INITIATED_ACCESS", "GOOGLE_INITIATED_SYSTEM_OPERATION" ] } }