בדף הזה מוסבר איך ליצור אוסף מפתחות ב-Cloud KMS. אוסף מפתחות הוא משאב הבסיס למפתחות ולגרסאות של מפתחות ב-Cloud KMS. כל מחזיק מפתחות קיים במיקום מסוים. מידע נוסף על משאבי Cloud KMS זמין במאמר משאבי Cloud KMS.
לפני שמתחילים
לפני שמבצעים את המשימות בדף הזה, צריך:
- Cloud de Confiance משאב פרויקט שיכיל את משאבי Cloud KMS. הפרויקט הזה נקרא פרויקט המפתחות. מומלץ שפרויקט המפתחות לא יכיל משאביCloud de Confiance אחרים. צריך להפעיל את Cloud KMS API בפרויקט המפתחות.
- שם המיקום שבו רוצים ליצור את מחזיק המפתחות. צריך לבחור מיקום שקרוב למשאבים האחרים ותומך ברמת ההגנה שבחרתם. כדי לראות את המיקומים הזמינים ואת רמות ההגנה שהם תומכים בהן, אפשר לעיין במאמר בנושא מיקומי Cloud KMS.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות ליצירת מחזיקי מפתחות, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM Cloud KMS Admin (roles/cloudkms.admin) בפרויקט או במשאב אב.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
זהו תפקיד שמוגדר מראש וכולל את ההרשאות שנדרשות ליצירת מחזיקי מפתחות. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי ליצור מחזיקי מפתחות, צריך את ההרשאות הבאות:
-
cloudkms.keyRings.create -
cloudkms.keyRings.get -
cloudkms.keyRings.list -
cloudkms.locations.get -
cloudkms.locations.list -
resourcemanager.projects.get
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
יצירת אוסף מפתחות
כדי ליצור מחזיק מפתחות למפתח החדש: אם רוצים להשתמש באוסף מפתחות קיים, אפשר ליצור מפתח.
המסוף
נכנסים לדף Key Management במסוף Cloud de Confiance .
לוחצים על Create key ring (יצירת מחזיק מפתחות).
בשדה Key ring name, מזינים שם לאוסף המפתחות.
בקטע מיקום מחזיק המפתחות, בוחרים מיקום כמו
"us-east1".לוחצים על יצירה.
gcloud
-
במסוף Cloud de Confiance , מפעילים את Cloud Shell.
-
בסביבה שלכם, מריצים את הפקודה
gcloud kms keyrings create:gcloud kms keyrings create KEY_RING \ --location LOCATIONמחליפים את מה שכתוב בשדות הבאים:
-
KEY_RING: השם של אוסף המפתחות שמכיל את המפתח. -
LOCATION: המיקום ב-Cloud KMS שבו נמצא אוסף המפתחות.
כדי לקבל מידע על כל הדגלים והערכים האפשריים, מריצים את הפקודה עם הדגל
--help. -
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את ה-SDK של Cloud KMS C# .
Go
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Go ולהתקין את Cloud KMS Go SDK.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח ב-Java ולהתקין את Cloud KMS Java SDK.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Cloud KMS Node.js SDK.
PHP
כדי להריץ את הקוד הזה, קודם צריך לקרוא על שימוש ב-PHP ב- Cloud de Confiance ולהתקין את Cloud KMS PHP SDK.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Python ולהתקין את Cloud KMS Python SDK.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Cloud KMS Ruby SDK.
API
בדוגמאות האלה נעשה שימוש ב-curl כלקוח HTTP כדי להדגים את השימוש ב-API. מידע נוסף על בקרת גישה זמין במאמר גישה ל-Cloud KMS API.
curl "https://cloudkms.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/keyRings?key_ring_id=KEY_RING" \
--request "POST" \
--header "authorization: Bearer TOKEN"
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט שמכיל את מחזיק המפתחות. -
KEY_RING: השם של אוסף המפתחות שמכיל את המפתח. -
LOCATION: המיקום ב-Cloud KMS שבו נמצא אוסף המפתחות.
מידע נוסף מופיע במאמרי העזרה של KeyRing.create API.