בדף הזה מוסבר איך לערוך את המטא-נתונים של סוד. אפשר לעדכן הרבה מאפיינים של סוד, כמו סוג ההצפנה, מדיניות הרוטציה, תאריך התפוגה, תוויות והתראות על אירועים. אפשר גם להוסיף הערות ולהגדיר כינויים לגרסאות סודיות. אי אפשר לערוך את השם או הערך של הסוד ואת מדיניות השכפול. כדי להוסיף ערך חדש לסוד, צריך ליצור גרסה חדשה של הסוד.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לעדכון המטא-נתונים של סוד, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM Secret Manager Admin (roles/secretmanager.admin) בסוד או בפרויקט.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
עריכת סוד
כדי לערוך סוד, משתמשים באחת מהשיטות הבאות:
המסוף
-
נכנסים לדף Secret Manager במסוף Google Cloud .
-
כדי לערוך סוד, משתמשים באחת מהאפשרויות הבאות:
-
ברשימה, מאתרים את הסוד ולוחצים על התפריט Actions שמשויך לסוד הזה. בתפריט פעולות, לוחצים על עריכה.
-
לוחצים על שם הסוד כדי לעבור לדף הפרטים של הסוד. בדף הפרטים של הסוד, לוחצים על עריכת הסוד.
-
-
בדף עריכת הסוד, מעדכנים את מאפייני הסוד לפי הצורך ואז לוחצים על עדכון הסוד.
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- SECRET_ID: מזהה הסוד
- KEY: מפתח התווית
- VALUE: הערך התואם של התווית
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud secrets update SECRET_ID \ --update-labels=KEY=VALUE
Windows (PowerShell)
gcloud secrets update SECRET_ID ` --update-labels=KEY=VALUE
Windows (cmd.exe)
gcloud secrets update SECRET_ID ^ --update-labels=KEY=VALUE
התשובה מחזירה את הסוד המעודכן.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט Google Cloud
- SECRET_ID: מזהה הסוד
- KEY: מפתח התווית
- VALUE: הערך התואם של התווית
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=labels
גוף בקשת JSON:
{'labels': {'KEY': 'VAL'}}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=labels"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=labels" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID",
"createTime": "2024-09-02T07:14:00.281541Z",
"labels": {
"key": "value"
},
"etag": "\"16211dc7d040b1\""
}
C#
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת C# ולהתקין את Secret Manager C# SDK. ב-Compute Engine או ב-GKE, צריך לעבור אימות באמצעות ההיקף cloud-platform.
Go
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Go ולהתקין את Secret Manager Go SDK. ב-Compute Engine או ב-GKE, צריך לעבור אימות באמצעות ההיקף cloud-platform.
Java
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח ב-Java ולהתקין את Secret Manager Java SDK. ב-Compute Engine או ב-GKE, צריך לעבור אימות באמצעות ההיקף cloud-platform.
Node.js
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Node.js ולהתקין את Secret Manager Node.js SDK. ב-Compute Engine או ב-GKE, צריך לעבור אימות באמצעות ההיקף cloud-platform.
PHP
כדי להריץ את הקוד הזה, קודם צריך לקרוא על שימוש ב-PHP ב-Google Cloud ולהתקין את Secret Manager PHP SDK. ב-Compute Engine או ב-GKE, צריך לעבור אימות באמצעות ההיקף cloud-platform.
Python
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח בשפת Python ולהתקין את Secret Manager Python SDK. ב-Compute Engine או ב-GKE, צריך לעבור אימות באמצעות ההיקף cloud-platform.
Ruby
כדי להריץ את הקוד הזה, קודם צריך להגדיר סביבת פיתוח של Ruby ולהתקין את Secret Manager Ruby SDK. ב-Compute Engine או ב-GKE, צריך לעבור אימות באמצעות ההיקף cloud-platform.
עריכת הרשאות ותוויות למספר סודות
אפשר לערוך הרשאות ותוויות של כמה סודות באמצעות מסוף Google Cloud .
-
נכנסים לדף Secret Manager במסוף Google Cloud .
-
בדף Secret Manager, בוחרים את הסודות שרוצים לערוך את ההרשאות והתוויות שלהם.
-
אם חלונית המידע סגורה, לוחצים על הצגת חלונית המידע כדי להציג אותה.
-
ההרשאות והתוויות שהוגדרו לכל הסודות מוצגות בחלונית המידע בכרטיסיות המתאימות. עוברים לכרטיסיות הנפרדות ומעדכנים את הערכים לפי הצורך.
-
כשמסיימים, לוחצים על שמירה.
המאמרים הבאים
- איך מנהלים את הגישה לסודות
- איך מגדירים לוחות זמנים להחלפת סודות
- איך מגדירים התראות על סודות
- איך מפעילים מפתחות הצפנה בניהול הלקוח (CMEK) ב-Secret Manager