הגדרה וניהול של מדיניות IAM בתיקיות מנוהלות

בדף הזה מוסבר איך להגדיר כללי מדיניות של ניהול זהויות והרשאות גישה (IAM) בתיקיות מנוהלות, כדי לקבל בקרת גישה מפורטת לקבוצות ספציפיות של אובייקטים בתוך קטגוריה.

אם אתם מחפשים שיטות אחרות לבקרת גישה, תוכלו להיעזר במקורות המידע הבאים:

התפקידים הנדרשים

כדי לקבל את ההרשאות שדרושות להגדרה ולניהול של מדיניות IAM לתיקיות מנוהלות, צריך לבקש מהאדמין להקצות לכם את התפקיד "אדמין של תיקיות אחסון" (roles/storage.folderAdmin) ב-IAM בקטגוריה שמכילה את התיקיות המנוהלות.

התפקיד הזה מכיל את ההרשאות הבאות, שנדרשות כדי להגדיר ולנהל את מדיניות ה-IAM של תיקיות מנוהלות:

  • storage.managedFolders.getIamPolicy

  • storage.managedFolders.setIamPolicy

אפשר לקבל את ההרשאות האלה גם באמצעות תפקידים בהתאמה אישית.

במאמר הגדרה וניהול של מדיניות IAM בקטגוריות מוסבר איך מקצים תפקידים לקטגוריות.

הגדרת מדיניות IAM בתיקייה מנוהלת

המסוף

  1. במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.

    כניסה לדף Buckets

  2. ברשימת הקטגוריות, לוחצים על שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים להגדיר לה מדיניות IAM.

  3. בדף Bucket details, לוחצים על סמל האפשרויות הנוספות בחלונית Folder browser, ליד התיקייה המנוהלת שרוצים להגדיר לה מדיניות IAM.

    כדי לשלוט בגישה בתוך תיקייה או תיקייה מדומה, פועלים לפי השלבים שמפורטים בקטע יצירת תיקייה מנוהלת כדי להפעיל את הניהול בתיקייה או בתיקייה המדומה.

  4. לוחצים על עריכת הגישה.

  5. בחלונית Permissions for MANAGED_FOLDER_NAME, לוחצים על Add principal .

  6. בשדה New principals, מזינים את חשבון המשתמש שרוצים לתת לו גישה. מידע נוסף על חשבונות המשתמשים שאפשר לכלול מופיע במאמר מזהים של חשבונות משתמשים.

  7. בקטע Assign roles, משתמשים בתפריט הנפתח Select a role כדי לציין את רמת הגישה שרוצים לתת לחשבון המשתמש.

  8. לוחצים על 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 של תיקייה מנוהלת:

  1. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

    {
      "bindings":[
        {
          "role": "IAM_ROLE",
          "members":[
            "PRINCIPAL_IDENTIFIER"
          ]
        }
      ]
    }

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫IAM_ROLE: תפקיד ה-IAM שאתם מקצים, לדוגמה roles/storage.objectViewer.

    • ‫PRINCIPAL_IDENTIFIER: החשבון הראשי שאתם נותנים לו גישה לתיקייה המנוהלת, לדוגמה user:example-service-account@example-project.. רשימת הפורמטים של מזהי חשבון המשתמש מופיעה במאמר מזהים של חשבונות משתמשים.

    צריך לכלול כל קישור שרוצים שיהיה לתיקייה המנוהלת, כי הקישורים בקובץ הזה מחליפים את כל הקישורים הקיימים.

  2. משתמשים בפקודה 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

  1. להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת Authorization.

  2. יוצרים קובץ JSON שמכיל את הפרטים הבאים:

    {
      "bindings":[
        {
          "role": "IAM_ROLE",
          "members":[
            "PRINCIPAL_IDENTIFIER"
          ]
        }
      ]
    }

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫IAM_ROLE: תפקיד ה-IAM שמעניקים. לדוגמה: roles/storage.objectViewer.

    • ‫PRINCIPAL_IDENTIFIER: חשבון המשתמש שאתם נותנים לו גישה לתיקייה המנוהלת, לדוגמה user:example-service-account@example-project.. רשימת הפורמטים של מזהי חשבון המשתמש מופיעה במאמר מזהים של חשבונות משתמשים.

  3. משתמשים ב-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 של תיקייה מנוהלת

המסוף

  1. במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.

    כניסה לדף Buckets

  2. ברשימת הקטגוריות, לוחצים על שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים לראות את מדיניות ה-IAM שלה.

  3. בדף Bucket details, לוחצים על סמל האפשרויות הנוספות בחלונית Folder browser, ליד התיקייה המנוהלת שרוצים לראות את מדיניות ה-IAM שלה.

  4. לוחצים על עריכת הגישה.

בחלונית 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

  1. להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת Authorization.

  2. משתמשים ב-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/.

הסרת חשבון משתמש ממדיניות של תיקייה מנוהלת

המסוף

  1. במסוף Google Cloud , נכנסים לדף Buckets של Cloud Storage.

    כניסה לדף Buckets

  2. ברשימת הקטגוריות, לוחצים על שם הקטגוריה שמכילה את התיקייה המנוהלת שרוצים לראות את מדיניות ה-IAM שלה.

  3. בדף Bucket details, לוחצים על סמל האפשרויות הנוספות בחלונית Folder browser, לצד התיקייה המנוהלת שרוצים להסיר ממנה חשבון משתמש.

  4. לוחצים על עריכת הגישה.

  5. בחלונית Permissions for FOLDER_NAME, מזינים את שם החשבון בשדה Filter.

  6. לוחצים על סמל המחיקה כדי למחוק את חשבון המשתמש.

‫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

  1. להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת Authorization.

  2. מחילים את המדיניות הקיימת על התיקייה המנוהלת. כדי לעשות את זה, משתמשים ב-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/.

  3. יוצרים קובץ JSON שמכיל את המדיניות שאחזרתם בשלב הקודם.

  4. עורכים את קובץ ה-JSON כדי להסיר מהמדיניות את חשבון המשתמש.

  5. משתמשים ב-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).

הגדרת תנאי חדש בתיקייה מנוהלת

שורת הפקודה

  1. יוצרים קובץ JSON או YAML שמגדיר את התנאי, כולל: title הוא הכותרת של התנאי, expression הוא הביטוי הלוגי מבוסס-המאפיינים שלו, ואופציונלי, description הוא התיאור של התנאי.

    שימו לב שב-Cloud Storage יש תמיכה רק במאפיינים תאריך/שעה, סוג המשאב ושם המשאב של expression.

  2. משתמשים בפקודה 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

  1. להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת Authorization.

  2. משתמשים בבקשה 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.

  3. כדי להוסיף תנאים חדשים לקישור במדיניות IAM, עורכים את הקובץ tmp-policy.json בכלי לעריכת טקסט:

    {
        "version": VERSION,
        "bindings": [
          {
            "role": "IAM_ROLE",
            "members": [
              "PRINCIPAL_IDENTIFIER"
            ],
            "condition": {
              "title": "TITLE",
              "description": "DESCRIPTION",
              "expression": "EXPRESSION"
            }
          }
        ],
        "etag": "ETAG"
    }

    מחליפים את מה שכתוב בשדות הבאים:

    אסור לבצע שינויים ב-ETAG.

  4. משתמשים בבקשה 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.

הסרת תנאי מתיקייה מנוהלת

שורת הפקודה

  1. משתמשים בפקודה 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
  2. עורכים את הקובץ tmp-policy.json בכלי לעריכת טקסט כדי להסיר תנאים ממדיניות ה-IAM.

  3. משתמשים בפקודה 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

  1. להתקין ולהפעיל את ה-CLI של gcloud, שמאפשר ליצור אסימון גישה לכותרת Authorization.

  2. משתמשים בבקשה 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/.

  3. עורכים את הקובץ tmp-policy.json בכלי לעריכת טקסט כדי להסיר תנאים ממדיניות ה-IAM.

  4. משתמשים בבקשה 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).

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