בדף הזה מוסבר איך להגדיר השמדה מושהית של גרסאות סודיות, איך לעדכן או להסיר את משך ההשהיה של ההשמדה ואיך לשחזר גרסאות סודיות שמתוזמנות להשמדה.
כברירת מחדל, כשמשתמש בוחר להשמיד גרסת סוד ב-Secret Manager, חומר הסוד מושמד באופן מיידי וסופי. עם זאת, משתמשים עם תפקיד אדמין ב-Secret Manager יכולים להגדיר השמדה מושהית של גרסאות סודות, כדי לוודא שגרסת הסוד לא תושמד מיד עם קבלת הבקשה ותישאר ניתנת לשחזור למשך זמן שניתן להגדרה.
כשמשביתים את ההשמדה המושהית של סוד ומשמידים גרסה של סוד, קורה הדבר הבא:
-
הגרסה מושבתת, ולכן אי אפשר להשתמש בה.
-
המערכת מתזמנת את הגרסה להשמדה סופית בסיום תקופת ההשהיה.
-
אחרי שתקופת ההשהיה מסתיימת, גרסת הסוד נמחקת באופן סופי ובלתי הפיך.
יתרונות
התכונה הזו מספקת את היתרונות הבאים:
-
שכבת הגנה נוספת מפני השמדה מקרית או זדונית של חומר סודי קריטי. כל משתמש עם התפקיד Secret Manager Secret Version Manager יכול להשמיד גרסת סוד. אי אפשר לבטל את הפעולה הזו. אם מגדירים השמדה מושהית, אפשר למנוע השמדה מיידית של גרסאות סודיות. אתם יכולים להעניק למשתמשים את רמת הגישה המינימלית שנדרשת לניהול מחזור החיים של גרסאות סודות, כדי שתוכלו לעקוב אחרי מידע אישי רגיש ולמנוע השמדה בשוגג שלו.
-
השמדה של גרסת סוד מפעילה
SECRET_VERSION_DESTROY_SCHEDULEDהתראה לנושאי Pub/Sub שהוגדרו בסוד. משתמשים עם תפקיד אדמין ב-Secret Manager יכולים לבטל את ההשמדה המתוזמנת ולשחזר את גרסת הסוד על ידי הפעלה או השבתה של גרסת הסוד.
לפני שמתחילים
-
מפעילים את Secret Manager API, אם הוא עדיין לא מופעל.
תפקידים שנדרשים להפעלת ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד 'בעלים' (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד 'אדמין בממשק Service Usage' (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים -
מגדירים אימות.
צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:
המסוף
כשמשתמשים במסוף Cloud de Confiance כדי לגשת לשירותים Cloud de Confiance by S3NS ולממשקי ה-API, לא צריך להגדיר אימות.
gcloud
התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:
gcloud initREST
כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.
התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.
מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Cloud de Confiance .
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות להגדרת השמדה מושהית של גרסאות סודות, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין של Secret Manager (roles/secretmanager.admin) בסוד.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
הגדרה של השמדה מושהית
אפשר להפעיל את ההשמדה המושהית של גרסת סוד כשיוצרים את הסוד או כשמעדכנים את הסוד. כדי להגדיר השמדה מושהית, משתמשים באחת מהשיטות הבאות:
המסוף
-
נכנסים לדף Secret Manager במסוף Cloud de Confiance .
-
בדף Secret Manager, לוחצים על Create secret.
-
בדף יצירת Secret, מזינים שם ל-Secret בשדה שם.
-
מזינים ערך לסוד (לדוגמה,
abcd1234). אפשר גם להעלות קובץ טקסט שמכיל את ערך הסוד באמצעות האפשרות העלאת קובץ. הפעולה הזו יוצרת באופן אוטומטי את הגרסה הסודית. -
עוברים לקטע Delay secret version destroy (דחיית השמדה של גרסת סוד) ומסמנים את התיבה Set duration for delayed destruction (הגדרת משך זמן לדחיית ההשמדה).
-
בשדה משך ההשהיה של ההשמדה, מזינים את משך הזמן בימים. הערך המינימלי שאפשר להזין הוא יום אחד, והערך המקסימלי הוא 1,000 ימים.
-
לוחצים על יצירת סוד.
כדי להפעיל את התכונה הזו בסוד קיים, עוברים לדף Edit secret ומגדירים את משך ההשהיה של ההשמדה.
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- SECRET_ID: המזהה של הסוד.
- TTL_DURATION: משך ההשהיה של השמדת הגרסאות של הסוד. אפשר להזין את משך הזמן בכל פורמט, למשל ימים, שעות או שניות. המשך המינימלי הנדרש הוא יום אחד, והמשך המקסימלי הוא 1,000 ימים.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud secrets create SECRET_ID --version-destroy-ttl=TTL_DURATION
Windows (PowerShell)
gcloud secrets create SECRET_ID --version-destroy-ttl=TTL_DURATION
Windows (cmd.exe)
gcloud secrets create SECRET_ID --version-destroy-ttl=TTL_DURATION
התשובה תכיל את הסוד החדש שנוצר.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט ב- Cloud de Confiance by S3NS .
- SECRET_ID: המזהה של הסוד.
- TTL_DURATION: משך ההשהיה של השמדת הגרסאות של הסוד. מזינים את משך הזמן בשניות. הערה: משך הזמן המינימלי הוא יום אחד, ומשך הזמן המקסימלי הוא 1,000 ימים.
ה-method של ה-HTTP וכתובת ה-URL:
POST https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets?secretId=SECRET_ID
גוף בקשת JSON:
{"replication": {"automatic": {}}, "version_destroy_ttl":"TTL_DURATION"}כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-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?secretId=SECRET_ID"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets?secretId=SECRET_ID" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name":"projects/PROJECT_ID/secrets/SECRET_ID",
"replication":{
"automatic":{
}
},
"createTime":"2023-10-16T17:10:16.345401Z",
"etag":"\"1607d90ee3d84c\"",
"versionDestroyTtl":"TTL_DURATION"
}
השמדה מושהית לא חלה בתרחישים הבאים:
-
כשמוחקים סוד, כל החומר שקשור לסוד וגרסאות הסוד הרלוונטיות נמחקים באופן מיידי.
-
אם מגדירים תאריך תפוגה לסוד והתוקף שלו פג, כל הגרסאות של הסוד נמחקות באופן מיידי, גם אם הפעלתם את האפשרות למחיקה מושהית של הסוד.
עדכון משך ההשהיה של ההשמדה
כדי לעדכן את משך ההשהיה של ההשמדה, משתמשים באחת מהשיטות הבאות:
המסוף
-
נכנסים לדף Secret Manager במסוף Cloud de Confiance .
-
כדי לערוך סוד, משתמשים באחת מהשיטות הבאות:
-
לוחצים על פעולות ליד הסוד שרוצים לערוך, ואז לוחצים על עריכה.
-
לוחצים על שם הסוד כדי לעבור לדף הפרטים של הסוד. בדף הפרטים של הסוד, לוחצים על עריכת הסוד.
-
-
בדף Edit secret, עוברים לקטע Delay secret version destroy. מעדכנים את משך העיכוב לפי הצורך ולוחצים על עדכון הסוד.
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- SECRET_ID: מזהה הסוד
- TTL_DURATION: משך ההשהיה של השמדת הגרסאות של הסוד
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud secrets update SECRET_ID --version-destroy-ttl=TTL_DURATION
Windows (PowerShell)
gcloud secrets update SECRET_ID --version-destroy-ttl=TTL_DURATION
Windows (cmd.exe)
gcloud secrets update SECRET_ID --version-destroy-ttl=TTL_DURATION
התשובה תכיל את הסוד החדש שנוצר.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט Cloud de Confiance by S3NS
- SECRET_ID: מזהה הסוד
- TTL_DURATION: משך ההשהיה של השמדת הגרסאות של הסוד
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=version_destroy_ttl
גוף בקשת JSON:
{
"version_destroy_ttl":"TTL_DURATION"
}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
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=version_destroy_ttl"
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=version_destroy_ttl" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name":"projects/PROJECT_ID/secrets/SECRET_ID",
"replication":{
"automatic":{
}
},
"createTime":"2023-10-16T17:10:16.345401Z",
"etag":"\"1607d90ee3d84c\"",
"versionDestroyTtl":"TTL_DURATION"
}
גרסאות הסודות שיושפעו מהעיכוב בהשמדה תלויות בגורמים הבאים:
-
כשמגדירים השמדה מושהית לסוד בפעם הראשונה, משך ההשהיה של ההשמדה משפיע על כל הגרסאות הפעילות (מופעלות ומושבתות) של הסוד.
-
כשמעדכנים את משך ההשהיה של ההשמדה או מסירים אותו, השינויים משתקפים רק בגרסאות חדשות של סודות שבהן מתבצע ניסיון להשמדה. גרסאות הסודות שכבר נקבע להן מועד השמדה ימשיכו להיות מושמדות במועד השמדה שנקבע.
השבתת השמדה מושהית
כדי להשבית את ההשמדה המאוחרת של גרסאות, משתמשים באחת מהשיטות הבאות:
המסוף
-
נכנסים לדף Secret Manager במסוף Cloud de Confiance .
-
כדי לערוך סוד, משתמשים באחת מהשיטות הבאות:
-
לוחצים על פעולות ליד הסוד שרוצים לערוך, ואז לוחצים על עריכה.
-
לוחצים על שם הסוד כדי לעבור לדף הפרטים של הסוד. בדף הפרטים של הסוד, לוחצים על עריכת הסוד.
-
-
בדף Edit secret, עוברים לקטע Delay secret version destroy. מבטלים את הסימון בתיבה הגדרת משך הזמן להשמדה מושהית ולוחצים על עדכון ה-Secret.
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- SECRET_ID: מזהה הסוד
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud secrets update SECRET_ID --remove-version-destroy-ttl
Windows (PowerShell)
gcloud secrets update SECRET_ID --remove-version-destroy-ttl
Windows (cmd.exe)
gcloud secrets update SECRET_ID --remove-version-destroy-ttl
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט Cloud de Confiance by S3NS
- SECRET_ID: מזהה הסוד
ה-method של ה-HTTP וכתובת ה-URL:
PATCH https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID?updateMask=version_destroy_ttl
גוף בקשת JSON:
{}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
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=version_destroy_ttl"
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=version_destroy_ttl" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name":"projects/PROJECT_ID/secrets/SECRET_ID",
"replication":{
"automatic":{
}
},
"createTime":"2023-10-16T17:10:16.345401Z",
"etag":"\"1607d90ee3d84c\""
}
תזמון של גרסאות של סודות להשמדה מאוחרת
כדי לתזמן השמדה מושהית של גרסה סודית, משתמשים באחת מהשיטות הבאות:
המסוף
-
נכנסים לדף Secret Manager במסוף Cloud de Confiance .
-
בדף Secret Manager, לוחצים על סוד כדי לגשת לגרסאות שלו. צריך להגדיר בסוד הזה השמדה מושהית של גרסאות.
-
בדף הפרטים של הסוד, בכרטיסייה גרסאות, בוחרים את גרסת הסוד שרוצים להשמיד.
-
לוחצים על פעולות ואז על השמדה.
-
בתיבת הדו-שיח לאישור שמופיעה, מזינים את מזהה ה-Secret כדי לאשר, ואז לוחצים על Schedule selected versions for destruction (תזמון מחיקה של הגרסאות שנבחרו).
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- SECRET_VERSION_ID: מזהה הגרסה או מזהה הגרסה המלא
- SECRET_ID: מזהה הסוד
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID
Windows (PowerShell)
gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID
Windows (cmd.exe)
gcloud secrets versions destroy SECRET_VERSION_ID --secret=SECRET_ID
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט Cloud de Confiance by S3NS
- SECRET_ID: מזהה הסוד
- VERSION_ID: מזהה הגרסה או מזהה הגרסה המלא
ה-method של ה-HTTP וכתובת ה-URL:
POST https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID:destroy
גוף בקשת JSON:
{}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-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/versions/VERSION_ID:destroy"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID:destroy" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name":"projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
"createTime":"2023-10-16T17:21:55.920036Z",
"state":"DISABLED",
"replicationStatus":{
"automatic":{
}
},
"etag":"\"1607d8b2fc1cf4\"",
"scheduledDestroyTime":"2023-10-16T17:26:57.459395960Z"
}
הגרסה הסודית מושבתת מיד ונקבע לה מועד להשמדה אחרי שתוקף משך ההשהיה של ההשמדה יפוג. התאריך והשעה המדויקים שבהם הגרסה תושמד מופיעים בעמודה Scheduled for destruction on (מתוכנן להשמדה בתאריך) בטבלה Versions (גרסאות).
שחזור גרסאות של סודות
אפשר לשחזר גרסת סוד שמתוזמנת להשמדה על ידי הפעלה או השבתה של גרסת הסוד.
הפעלת גרסת סוד שמתוזמנת להשמדה
כדי להפעיל גרסה של סוד שמתוכננת להשמדה, משתמשים באחת מהשיטות הבאות:
המסוף
-
נכנסים לדף Secret Manager במסוף Cloud de Confiance .
-
בדף Secret Manager, לוחצים על סוד כדי לגשת לגרסאות שלו.
-
בדף הפרטים של הסוד, בכרטיסייה Versions, בוחרים את גרסת הסוד שמתוזמנת להשמדה.
-
לוחצים על פעולות ואז על הפעלה.
-
בתיבת הדו-שיח לאישור שמופיעה, לוחצים על הפעלת הגרסאות שנבחרו.
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- SECRET_VERSION_ID: מזהה הגרסה או מזהה הגרסה המלא
- SECRET_ID: מזהה הסוד
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID
Windows (PowerShell)
gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID
Windows (cmd.exe)
gcloud secrets versions enable SECRET_VERSION_ID --secret=SECRET_ID
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט Cloud de Confiance by S3NS
- SECRET_ID: מזהה הסוד
- VERSION_ID: מזהה הגרסה או מזהה הגרסה המלא
ה-method של ה-HTTP וכתובת ה-URL:
POST https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID:enable
גוף בקשת JSON:
{}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-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/versions/VERSION_ID:enable"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID:enable" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name":"projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
"createTime":"2023-10-16T17:21:55.920036Z",
"state":"ENABLED",
"replicationStatus":{
"automatic":{
}
},
"etag":"\"1607d8b3e8e1bc\""
}
השבתה של גרסת סוד שמתוזמנת להשמדה
כדי להשבית גרסה של סוד שמתוזמנת להשמדה, משתמשים באחת מהשיטות הבאות:
המסוף
-
נכנסים לדף Secret Manager במסוף Cloud de Confiance .
-
בדף Secret Manager, לוחצים על סוד כדי לגשת לגרסאות שלו.
-
בדף הפרטים של הסוד, בכרטיסייה Versions, בוחרים את גרסת הסוד שמתוזמנת להשמדה.
-
לוחצים על פעולות ואז על השבתה.
-
בתיבת הדו-שיח לאישור שמופיעה, לוחצים על השבתת הגרסאות שנבחרו.
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- SECRET_VERSION_ID: מזהה הגרסה או מזהה הגרסה המלא
- SECRET_ID: מזהה הסוד
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID
Windows (PowerShell)
gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID
Windows (cmd.exe)
gcloud secrets versions disable SECRET_VERSION_ID --secret=SECRET_ID
התשובה מכילה את הגרסה המושבתת של הסוד.
REST
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- PROJECT_ID: מזהה הפרויקט Cloud de Confiance by S3NS
- SECRET_ID: מזהה הסוד
- VERSION_ID: מזהה הגרסה או מזהה הגרסה המלא
ה-method של ה-HTTP וכתובת ה-URL:
POST https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID:disable
גוף בקשת JSON:
{}
כדי לשלוח את הבקשה עליכם לבחור אחת מהאפשרויות הבאות:
curl
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
curl -X POST \
-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/versions/VERSION_ID:disable"
PowerShell
שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID:disable" | Select-Object -Expand Content
אתם אמורים לקבל תגובת JSON שדומה לזו:
{
"name":"projects/PROJECT_ID/secrets/SECRET_ID/versions/VERSION_ID",
"createTime":"2023-10-16T17:21:55.920036Z",
"state":"DISABLED",
"replicationStatus":{
"automatic":{
}
},
"etag":"\"1607d8b3e8e1bc\""
}