בדף הזה מוסבר איך להגדיר כללי מדיניות של ניהול זהויות והרשאות גישה (IAM) בתיקיות מנוהלות, כדי לקבל בקרת גישה מפורטת לקבוצות ספציפיות של אובייקטים בתוך קטגוריה.
אם אתם מחפשים שיטות אחרות לבקרת גישה, תוכלו להיעזר במקורות המידע הבאים:
במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך לקבוע את הגישה לקטגוריות שלמות ולאובייקטים שבתוכן.
במאמר רשימות של בקרת גישה מוסבר איך לנהל את הגישה לאובייקטים ספציפיים בקטגוריות בדרך אחרת.
מידע נוסף על בקרת הגישה למשאבים של Cloud Storage זמין במאמר סקירה כללית של בקרת הגישה.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות להגדרה ולניהול של מדיניות IAM לתיקיות מנוהלות, צריך לבקש מהאדמין להקצות לכם את התפקיד "אדמין של תיקיות אחסון" (roles/storage.folderAdmin) ב-IAM בקטגוריה שמכילה את התיקיות המנוהלות.
התפקיד הזה מכיל את ההרשאות הבאות, שנדרשות כדי להגדיר ולנהל את מדיניות ה-IAM של תיקיות מנוהלות:
storage.managedFolders.getIamPolicystorage.managedFolders.setIamPolicy
אפשר לקבל את ההרשאות האלה גם באמצעות תפקידים בהתאמה אישית.
במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך מקצים תפקידים לקטגוריות.
הגדרת מדיניות IAM בתיקייה מנוהלת
המסוף
- במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים להגדיר לה מדיניות IAM.
בדף Bucket details, לוחצים על סמל האפשרויות הנוספות בחלונית Folder browser, ליד התיקייה המנוהלת שרוצים להגדיר לה מדיניות IAM.
כדי לשלוט בגישה בתוך תיקייה או תיקייה מדומה, פועלים לפי השלבים שמפורטים בקטע יצירת תיקייה מנוהלת כדי להפעיל את הניהול בתיקייה או בתיקייה המדומה.
לוחצים על עריכת הגישה.
בחלונית Permissions for
MANAGED_FOLDER_NAME, לוחצים על Add principal .בשדה New principals, מזינים את חשבון המשתמש שרוצים לתת לו גישה. מידע נוסף על חשבונות המשתמשים שאפשר לכלול מופיע במאמר מזהים של חשבונות משתמשים.
בקטע Assign roles, משתמשים בתפריט הנפתח Select a role כדי לציין את רמת הגישה שרוצים לתת לחשבון המשתמש.
לוחצים על Save.
שורת הפקודה
כדי לתת גישה לתיקייה מנוהלת, אפשר להשתמש באחת מהפקודות הבאות:
gcloud storage managed-folders add-iam-policy-binding: הוספת קישור תפקיד יחיד לחשבון משתמש במדיניות ה-IAM הקיימת של התיקייה המנוהלת. קישורים שכבר קיימים במדיניות לא משתנים. לא צריך ליצור קובץ מדיניות כדי להשתמש בפקודה הזו.
gcloud storage managed-folders set-iam-policy: מחליפה את כל מדיניות ה-IAM של התיקייה המנוהלת במדיניות שאתם מגדירים בקובץ JSON. כל הקישורים שלא נכללים בקובץ ה-JSON יוסרו מהתיקייה המנוהלת.
כדי להוסיף קישור תפקיד למדיניות ה-IAM של תיקייה מנוהלת, מריצים את הפקודה gcloud storage managed-folders add-iam-policy-binding:
gcloud storage managed-folders add-iam-policy-binding gs://BUCKET_NAME/MANAGED_FOLDER_NAME --member=PRINCIPAL_IDENTIFIER --role=IAM_ROLE
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים לתת לחשבון הראשי גישה אליה, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שרוצים לתת לחשבון המשתמש גישה אליה, לדוגמהmy-managed-folder/.
PRINCIPAL_IDENTIFIER: החשבון הראשי שאתם נותנים לו גישה לתיקייה המנוהלת, לדוגמהuser:example-service-account@example-project.. רשימת הפורמטים של מזהי חשבון המשתמש מופיעה במאמר מזהים של חשבונות משתמשים.
IAM_ROLE: תפקיד ה-IAM שאתם מקצים, לדוגמהroles/storage.objectViewer.
כדי לכלול תנאי IAM בקישור התפקיד, ראו הגדרת תנאי חדש בתיקייה מנוהלת.
כדי להחליף את כל מדיניות ה-IAM של תיקייה מנוהלת:
יוצרים קובץ JSON שמכיל את הפרטים הבאים:
{ "bindings":[ { "role": "IAM_ROLE", "members":[ "PRINCIPAL_IDENTIFIER" ] } ] }
מחליפים את מה שכתוב בשדות הבאים:
IAM_ROLE: תפקיד ה-IAM שאתם מקצים, לדוגמהroles/storage.objectViewer.
PRINCIPAL_IDENTIFIER: החשבון הראשי שאתם נותנים לו גישה לתיקייה המנוהלת, לדוגמהuser:example-service-account@example-project.. רשימת הפורמטים של מזהי חשבון המשתמש מופיעה במאמר מזהים של חשבונות משתמשים.
צריך לכלול כל קישור שרוצים שיהיה לתיקייה המנוהלת, כי הקישורים בקובץ הזה מחליפים את כל הקישורים הקיימים.
משתמשים בפקודה
gcloud storage managed-folders set-iam-policy:gcloud storage managed-folders set-iam-policy gs://BUCKET_NAME/MANAGED_FOLDER_NAME POLICY_FILE
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שעליה רוצים להחיל את מדיניות ה-IAM, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שעליה רוצים להחיל את מדיניות ה-IAM, לדוגמהmy-managed-folder/.
POLICY_FILE: הנתיב לקובץ ה-JSON שיצרתם בשלב 1.
ממשקי API בארכיטקטורת REST
JSON
להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת
Authorization.יוצרים קובץ JSON שמכיל את הפרטים הבאים:
{ "bindings":[ { "role": "IAM_ROLE", "members":[ "PRINCIPAL_IDENTIFIER" ] } ] }
מחליפים את מה שכתוב בשדות הבאים:
IAM_ROLE: תפקיד ה-IAM שמעניקים. לדוגמה:roles/storage.objectViewer.
PRINCIPAL_IDENTIFIER: חשבון המשתמש שאתם נותנים לו גישה לתיקייה המנוהלת, לדוגמהuser:example-service-account@example-project.. רשימת הפורמטים של מזהי חשבון המשתמש מופיעה במאמר מזהים של חשבונות משתמשים.
משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשתPUT setIamPolicy:curl -X PUT --data-binary @POLICY_FILE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage./storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME/iam"
מחליפים את מה שכתוב בשדות הבאים:
POLICY_FILE: הנתיב לקובץ המדיניות בפורמט JSON שיצרתם בשלב הקודם.
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שעליה רוצים להחיל את מדיניות ה-IAM, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שאתם רוצים לתת לחשבון המשתמש גישה אליה, לדוגמהmy-managed-folder/.
הצגת מדיניות ה-IAM של תיקייה מנוהלת
המסוף
- במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים לראות את מדיניות ה-IAM שלה.
בדף Bucket details, לוחצים על סמל האפשרויות הנוספות בחלונית Folder browser, ליד התיקייה המנוהלת שרוצים לראות את מדיניות ה-IAM שלה.
לוחצים על עריכת הגישה.
בחלונית Permissions for FOLDER_NAME מוצגות ההרשאות בתיקייה המנוהלת, כולל חשבון המשתמש, התפקיד, התפקידים שעברו בירושה ותנאי ה-IAM.
שורת הפקודה
משתמשים בפקודה gcloud storage managed-folder get-iam-policy:
gcloud storage managed-folders get-iam-policy gs://BUCKET_NAME/MANAGED_FOLDER_NAME
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שאת מדיניות ה-IAM שלה רוצים לראות, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: שם התיקייה המנוהלת שבמדיניות ה-IAM שלה רוצים לצפות, לדוגמהmy-managed-folder/.
ממשקי API בארכיטקטורת REST
JSON
להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת
Authorization.משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשתGET getIamPolicy:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage./storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME/iam"
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שבמדיניות ה-IAM שלה רוצים לצפות. לדוגמה:my-bucket.
MANAGED_FOLDER_NAME: שם התיקייה המנוהלת שבמדיניות ה-IAM שלה רוצים לצפות, לדוגמהmy-managed-folder/.
הסרת חשבון משתמש ממדיניות של תיקייה מנוהלת
המסוף
- במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.
ברשימת הקטגוריות, לוחצים על שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים לראות את מדיניות ה-IAM שלה.
בדף Bucket details, לוחצים על סמל האפשרויות הנוספות בחלונית Folder browser, לצד התיקייה המנוהלת שרוצים להסיר ממנה חשבון משתמש.
לוחצים על עריכת הגישה.
בחלונית Permissions for
FOLDER_NAME, מזינים את שם החשבון בשדה Filter.לוחצים על סמל המחיקה כדי למחוק את חשבון המשתמש.
Cloud Storage מוחק את חשבון המשתמש מהתיקייה המנוהלת.
שורת הפקודה
משתמשים בפקודה gcloud storage managed-folder remove-iam-policy-binding:
gcloud storage managed-folders remove-iam-policy-binding gs://BUCKET_NAME/MANAGED_FOLDER_NAME --member=PRINCIPAL_IDENTIFIER --role=IAM_ROLE
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שאתם מבטלים את הגישה אליה, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שמדיניות ה-IAM שלה תוסר, לדוגמהmy-managed-folder/.
PRINCIPAL_IDENTIFIER: החשבון הראשי שאתם מבטלים את הגישה שלו. לדוגמה:user:example-service-account@example-project.. רשימת הפורמטים של מזהי חשבון המשתמש מופיעה במאמר מזהים של חשבונות משתמשים.
IAM_ROLE: תפקיד ה-IAM שרוצים לבטל. לדוגמה:roles/storage.objectViewer.
ממשקי API בארכיטקטורת REST
JSON
להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת
Authorization.מחילים את המדיניות הקיימת על התיקייה המנוהלת. כדי לעשות את זה, משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשתGET getIamPolicy:curl -X GET \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage./storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME/iam"
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שאתם מבטלים את הגישה אליה, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שמדיניות ה-IAM שלה תוסר, לדוגמהmy-managed-folder/.
יוצרים קובץ JSON שמכיל את המדיניות שאחזרתם בשלב הקודם.
עורכים את קובץ ה-JSON כדי להסיר מהמדיניות את חשבון המשתמש.
משתמשים ב-
cURLכדי לשלוח קריאה ל-API בפורמט JSON באמצעות בקשתPUT setIamPolicy:curl -X PUT --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage./storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME/iam"
מחליפים את מה שכתוב בשדות הבאים:
JSON_FILE_NAME: הנתיב לקובץ שיצרתם בשלב 3.
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שאתם מבטלים את הגישה אליה, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שמדיניות ה-IAM שלה תוסר, לדוגמהmy-managed-folder/.
שימוש בתנאי IAM בתיקיות מנוהלות
בחלקים הבאים מוסבר איך להוסיף ולהסיר תנאי IAM בתיקיות המנוהלות. כדי לצפות בתנאי ה-IAM לתיקיות המנוהלות שלכם, היכנסו למאמר צפייה במדיניות ה-IAM של תיקייה מנוהלת. למידע נוסף על השימוש בתנאי IAM עם Cloud Storage, קראו את המאמר תנאים.
אפשר לציין תיקיות מנוהלות כמשאב בתנאים של מדיניות ההרשאות ב-IAM, אבל אי אפשר לציין אותן כמשאב בתנאים של מדיניות הדחייה ב-IAM. תנאי דחייה מזהים רק פונקציות של תגי משאבים, ואי אפשר לצרף תגים לתיקיות מנוהלות.
לפני שמוסיפים תנאים לתיקיות מנוהלות, צריך להפעיל הרשאות גישה מאוחדות ברמת הקטגוריה (UBLA).
הגדרת תנאי חדש בתיקייה מנוהלת
שורת הפקודה
יוצרים קובץ JSON או YAML שמגדיר את התנאי, כולל:
titleהוא הכותרת של התנאי,expressionהוא הביטוי הלוגי מבוסס-המאפיינים שלו, ואופציונלי,descriptionהוא התיאור של התנאי.שימו לב שב-Cloud Storage יש תמיכה רק במאפיינים תאריך/שעה, סוג המשאב ושם המשאב של
expression.משתמשים בפקודה
gcloud storage managed-folders add-iam-policy-bindingעם הדגל--condition-from-file:
gcloud storage managed-folders add-iam-policy-binding gs://BUCKET_NAME/MANAGED_FOLDER_NAME --member=PRINCIPAL_IDENTIFIER --role=IAM_ROLE --condition-from-file=CONDITION_FILE
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שאתם נותנים לחשבון הראשי גישה אליה, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שאתם נותנים לחשבון הראשי גישה אליה, לדוגמהmy-managed-folder/.
PRINCIPAL_IDENTIFIER: החשבון הראשי שהתנאי חל עליו. לדוגמה:user:example-service-account@example-project.. רשימת הפורמטים של מזהי חשבון המשתמש מופיעה במאמר מזהים של חשבונות משתמשים.
IAM_ROLE: תפקיד ה-IAM שמעניקים לחשבון המשתמש. לדוגמה:roles/storage.objectViewer.
CONDITION_FILE: הקובץ שיצרתם בשלב הקודם.
לחלופין, אפשר לכלול את התנאי ישירות בפקודה עם הדגל --condition במקום הדגל --condition-from-file.
ממשקי API בארכיטקטורת REST
JSON
להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת
Authorization.משתמשים בבקשה
GET getIamPolicyכדי לשמור את מדיניות ה-IAM של התיקייה המנוהלת בקובץ JSON זמני:curl \ 'https://storage./storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAMEiam' \ --header 'Authorization: Bearer $(gcloud auth print-access-token)' > tmp-policy.json
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים להגדיר לה תנאי IAM.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שרוצים להגדיר לה תנאי IAM.
כדי להוסיף תנאים חדשים לקישור במדיניות IAM, עורכים את הקובץ
tmp-policy.jsonבכלי לעריכת טקסט:{ "version": VERSION, "bindings": [ { "role": "IAM_ROLE", "members": [ "PRINCIPAL_IDENTIFIER" ], "condition": { "title": "TITLE", "description": "DESCRIPTION", "expression": "EXPRESSION" } } ], "etag": "ETAG" }מחליפים את מה שכתוב בשדות הבאים:
VERSION: הגרסה של מדיניות ה-IAM. לתיקיות מנוהלות עם תנאים ב-IAM הגרסה צריכה להיות 3.
IAM_ROLE: התפקיד שעליו חל התנאי, לדוגמהroles/storage.objectViewer.
PRINCIPAL_IDENTIFIER: החשבון הראשי שהתנאי חל עליו. לדוגמה:user:example-service-account@example-project.. רשימת הפורמטים של מזהי חשבון המשתמש מופיעה במאמר מזהים של חשבונות משתמשים.
TITLE: שם התנאי, לדוגמהexpires in 2019.
DESCRIPTION: תיאור אופציונלי של התנאי, לדוגמהPermission revoked on New Year's.
EXPRESSION: ביטוי לוגי מבוסס-מאפיינים, לדוגמהrequest.time < timestamp(\"2019-01-01T00:00:00Z\"). דוגמאות נוספות לביטויים מופיעות במאמרי העזרה של המאפיין 'תנאים'. ב-Cloud Storage יש תמיכה רק במאפיינים תאריך/שעה, סוג המשאב ושם המשאב.
אסור לבצע שינויים ב-
ETAG.משתמשים בבקשה
PUT setIamPolicyכדי להגדיר את מדיניות ה-IAM שהשתנתה בקטגוריה:curl -X PUT --data-binary @tmp-policy.json \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage./storage/v1/b/BUCKET_NAME/managedFoldersMANAGED_FOLDER_NAME/iam"
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים להגדיר לה תנאי IAM.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שרוצים להגדיר לה תנאי IAM.
הסרת תנאי מתיקייה מנוהלת
שורת הפקודה
משתמשים בפקודה
gcloud storage managed-folders get-iam-policyכדי לשמור את מדיניות ה-IAM של התיקייה המנוהלת בקובץ JSON זמני.gcloud storage managed-folders get-iam-policy gs://BUCKET_NAME/MANAGED_FOLDER_NAME > tmp-policy.json
עורכים את הקובץ
tmp-policy.jsonבכלי לעריכת טקסט כדי להסיר תנאים ממדיניות ה-IAM.משתמשים בפקודה
gcloud storage managed-folders set-iam-policyכדי להגדיר את מדיניות ה-IAM ששונתה בתיקייה המנוהלת.gcloud storage managed-folders set-iam-policy gs://BUCKET_NAME/MANAGED_FOLDER_NAME tmp-policy.json
ממשקי API בארכיטקטורת REST
JSON
להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת
Authorization.משתמשים בבקשה
GET getIamPolicyכדי לשמור את מדיניות ה-IAM של התיקייה המנוהלת בקובץ JSON זמני:curl \ 'https://storage./storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAMEiam' \ --header 'Authorization: Bearer $(gcloud auth print-access-token)' > tmp-policy.json
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שאתם משנים את הגישה אליה, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שאתם משנים את הגישה אליה, לדוגמהmy-managed-folder/.
עורכים את הקובץ
tmp-policy.jsonבכלי לעריכת טקסט כדי להסיר תנאים ממדיניות ה-IAM.משתמשים בבקשה
PUT setIamPolicyכדי להגדיר את מדיניות ה-IAM שהשתנתה בתיקייה המנוהלת:curl -X PUT --data-binary @tmp-policy.json \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage./storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAMEiam"
מחליפים את מה שכתוב בשדות הבאים:
BUCKET_NAME: שם הקטגוריה שמכילה את התיקייה המנוהלת שאתם משנים את הגישה אליה, לדוגמהmy-bucket.
MANAGED_FOLDER_NAME: השם של התיקייה המנוהלת שאתם משנים את הגישה אליה, לדוגמהmy-managed-folder/.
שימוש ב-IAM עם פרויקטים
מדריכים בנושא הקצאה וביטול של תפקידי IAM ברמת הפרויקט ומעלה מופיעים במאמר ניהול הגישה לפרויקטים, לתיקיות מנוהלות ולארגונים.
שיטות מומלצות
צריך להגדיר את התפקיד המינימלי הנדרש כדי לתת לחשבון המשתמש את רמת הגישה הנדרשת. לדוגמה, אם חבר צוות צריך רק לצפות בתיקיות המנוהלות בקטגוריה, תנו לו את התפקיד "אדמין של אובייקטים ב-Storage" (roles/storage.objectAdmin) במקום את התפקיד "אדמין של תיקיות ב-Storage" (roles/storage.folderAdmin).
באופן דומה, אם חבר הצוות צריך שליטה מלאה בתיקיות המנוהלות בקטגוריה, מקצים לו את התפקיד Storage Folder Admin (roles/storage.folderAdmin) במקום את התפקיד Storage Admin (roles/storage.admin).
המאמרים הבאים
במאמר פתרון בעיות מוסבר איך לפתור בעיות שקשורות לתפקידים ולהרשאות ב-IAM.