הגדרת הצדקות גישה למפתחות באמצעות Cloud HSM

בדף הזה מוסבר איך להגדיר הצדקות לבקשות גישה למפתחות (KAJ) באמצעות Cloud HSM, בשביל גבולות הנתונים של יפן ב-Assured Workloads.

במהלך השלבים ליצירת תיקייה חדשה של Assured Workloads ל-Japan Data Boundary, אתם יכולים ליצור פרויקט חדש ואוסף מפתחות למפתחות הקריפטוגרפיים שלכם. אפשר להוסיף לאוסף המפתחות הזה מפתחות של 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"
    ]
  }
}

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