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

בדף הזה מתוארות הדרישות המוקדמות לשימוש בתכונה "מנהל המדיניות" ב-VM Manager.

התפקידים וההרשאות שנדרשים כדי ליצור ולנהל כלי תזמור מדיניות

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

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

  • יצירה, עדכון, מחיקה, הצגה ופירוט של מתזמני מדיניות: אדמין של PolicyOrchestrator (roles/osconfig.policyOrchestratorAdmin) בפרויקט, בתיקייה או בארגון
  • צפייה בתזמורי מדיניות והצגת רשימה שלהם: צפייה ב-PolicyOrchestrator (roles/osconfig.policyOrchestratorViewer) בפרויקט, בתיקייה או בארגון
  • שימוש בפרויקט מכסות לתזמורים ברמת התיקייה וברמת הארגון: Service Usage Consumer (roles/serviceusage.serviceUsageConsumer) בפרויקט המכסות

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

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

ההרשאות הנדרשות

כדי ליצור ולנהל כלי תזמור של מדיניות, נדרשות ההרשאות הבאות:

  • יצירת כלי תזמור של מדיניות:
    • osconfig.policyOrchestrators.create
    • osconfig.operations.get
  • עדכון של כלי התזמור של המדיניות:
    • osconfig.policyOrchestrators.update
    • osconfig.operations.get
  • מחיקת כלי ניהול המדיניות:
    • osconfig.policyOrchestrators.delete
    • osconfig.operations.get
  • הצגה ופירוט של מתזמני מדיניות:
    • osconfig.policyOrchestrators.get
    • osconfig.policyOrchestrators.list
    • osconfig.locations.get
    • osconfig.locations.list
    • osconfig.operations.get
  • שימוש בפרויקט מכסות לתזמורים ברמת התיקייה וברמת הארגון: serviceusage.services.use

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

הגדרת הדרישות המוקדמות של Policy Orchestrator באמצעות פקודות ה-CLI של gcloud

בקטע הזה מפורטות כל פקודות ה-gcloud שצריך להריץ לפני שמשתמשים בתכונה "מנהל המדיניות".

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

כדי לקבל את ההרשאות שדרושות להרצת הפקודות הנדרשות לניהול המדיניות, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM:

  • כדי להגדיר פרויקט מכסות ולהשתמש בו לתזמורים ברמת התיקייה וברמת הארגון: Service Usage Consumer (roles/serviceusage.serviceUsageConsumer) בפרויקט המכסות
  • הפעלת OS Config API ו-Progressive Rollout API: אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin) בפרויקט או בפרויקט המכסה
  • כדי ליצור את סוכני השירות של OS Config ושל Progressive Rollout: אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin) בפרויקט, בתיקייה או בארגון
  • כדי לתת לסוכני שירות גישה לפרויקט: אדמין IAM של פרויקט (roles/resourcemanager.projectIamAdmin) בפרויקט
  • כדי לתת לסוכני שירות גישה לתיקייה: אדמין IAM של תיקיות (roles/resourcemanager.folderIamAdmin) או אדמין תיקיות (roles/resourcemanager.folderAdmin) בתיקייה
  • כדי לתת לסוכני שירות גישה לארגון: אדמין ארגוני (roles/resourcemanager.organizationAdmin) בארגון

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

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

ההרשאות הנדרשות

כדי להריץ את הפקודות הנדרשות לתזמור המדיניות, צריך את ההרשאות הבאות:

  • הגדרה ושימוש בפרויקט להקצאת מכסות לתזמורים ברמת התיקייה וברמת הארגון: serviceusage.services.use
  • מפעילים את OS Config API ואת Progressive Rollout API: serviceusage.services.enable
  • יוצרים סוכני שירות: serviceusage.services.generateServiceIdentity
  • כדי לתת לסוכני השירות גישה לפרויקט:
    • resourcemanager.projects.getIamPolicy
    • resourcemanager.projects.setIamPolicy
  • כדי לתת לסוכני השירות גישה לתיקייה:
    • resourcemanager.folders.getIamPolicy
    • resourcemanager.folders.setIamPolicy
  • כדי לתת לסוכני השירות גישה לארגון:
    • resourcemanager.organizations.getIamPolicy
    • resourcemanager.organizations.setIamPolicy

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

פרויקט

הפקודות הבאות מבצעות את המשימות שנדרשות כדי ליצור תזמורים ברמת הפרויקט:

  # Enable OS Config API
  gcloud services enable osconfig.googleapis.com

  # Enable Progressive Rollout API
  gcloud services enable progressiverollout.googleapis.com

  # Create an OS config service agent
  gcloud beta services identity create --service=osconfig.googleapis.com  --project=PROJECT_NUMBER

  # Create a Progressive Rollout service agent
  gcloud beta services identity create --service=progressiverollout.googleapis.com  --project=PROJECT_NUMBER

  # Grant the required role to the OS config rollout service agent
  gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com" \
  --role="roles/osconfig.rolloutServiceAgent"

  # Grant the required role to the OS config service agent
  gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com" \
  --role="roles/osconfig.serviceAgent"

  # Grant the required role to the Progressive Rollout service agent
  gcloud projects add-iam-policy-binding PROJECT_ID \
  --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com" \
  --role="roles/progressiverollout.serviceAgent"

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

  • ‫PROJECT_ID: המזהה המספרי של הפרויקט שבו רוצים ליצור את סוכן השירות.
  • ‫PROJECT_NUMBER: מספר המשאב של הפרויקט ש-Google הקצתה כשיצרתם את הפרויקט.

מידע נוסף זמין במאמר משאב הפרויקט.

תיקייה

הפקודות הבאות מבצעות את המשימות הנדרשות ליצירת תזמורים ברמת התיקייה:

  # Set up the quota project
  gcloud config set billing/quota_project QUOTA_PROJECT_ID

  # Enable OS Config API
  gcloud services enable osconfig.googleapis.com

  # Create an OS config service agent
  gcloud beta services identity create --service=osconfig.googleapis.com  --folder=FOLDER_NUMBER

  # Create a Progressive Rollout service agent
  gcloud beta services identity create --service=progressiverollout.googleapis.com  --folder=FOLDER_NUMBER

  # Grant the required role to the OS config rollout service agent
  gcloud resource-manager folders add-iam-policy-binding FOLDER_NUMBER \
  --member="serviceAccount:service-folder-FOLDER_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com" \
  --role="roles/osconfig.rolloutServiceAgent"

  # Grant the required role to the OS config service agent
  gcloud resource-manager folders add-iam-policy-binding FOLDER_NUMBER \
  --member="serviceAccount:service-folder-FOLDER_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com" \
  --role="roles/osconfig.serviceAgent"

  # Grant the required role to the Progressive Rollout service agent
  gcloud resource-manager folders add-iam-policy-binding FOLDER_NUMBER \
  --member="serviceAccount:service-folder-FOLDER_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com" \
  --role="roles/progressiverollout.serviceAgent"
  

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

  • ‫QUOTA_PROJECT_ID: מזהה הפרויקט של הפרויקט לחיוב על מכסות. אפשר לבחור כל פרויקט שהחיוב מופעל בו.
  • ‫FOLDER_NUMBER: המזהה המספרי של התיקייה שבה רוצים ליצור את סוכן השירות.

ארגון

הפקודות הבאות מבצעות את המשימות הנדרשות ליצירת תזמורים ברמת הארגון:

  # Set up the quota project
  gcloud config set billing/quota_project QUOTA_PROJECT_ID

  # Enable OS Config API
  gcloud services enable osconfig.googleapis.com

  # Create an OS config service agent
  gcloud beta services identity create --service=osconfig.googleapis.com --organization=ORGANIZATION_NUMBER

  # Create a Progressive Rollout service agent
  gcloud beta services identity create --service=progressiverollout.googleapis.com  --organization=ORGANIZATION_NUMBER

  # Grant the required role to the OS config rollout service agent
  gcloud organizations add-iam-policy-binding ORGANIZATION_NUMBER \
  --member="serviceAccount:service-org-ORGANIZATION_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com" \
  --role="roles/osconfig.rolloutServiceAgent"

  # Grant the required role to the OS config service agent
  gcloud organizations add-iam-policy-binding ORGANIZATION_NUMBER \
  --member="serviceAccount:service-org-ORGANIZATION_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com" \
  --role="roles/osconfig.serviceAgent"

  # Grant the required role to the Progressive Rollout service agent
  gcloud organizations add-iam-policy-binding ORGANIZATION_NUMBER \
  --member="serviceAccount:service-org-ORGANIZATION_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com" \
  --role="roles/progressiverollout.serviceAgent"

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

  • ‫QUOTA_PROJECT_ID: מזהה הפרויקט של הפרויקט לחיוב על מכסות. אפשר לבחור כל פרויקט שהחיוב מופעל בו.
  • ‫ORGANIZATION_NUMBER במזהה המספרי של הארגון שבו רוצים ליצור את סוכן השירות.

הגדרת פרויקט מכסה או פרויקט לחיוב לתזמורים של ארגונים ותיקיות

כשמשתמשים בתזמור מדיניות כדי לנהל את משאבי מדיניות מערכת ההפעלה בארגון או בתיקיות, שולחים בקשות ל-API מבוסס-לקוח. בממשקי API שמבוססים על לקוחות, צריך פרויקט לחיוב על מכסות. מידע נוסף על ממשקי API שמבוססים על לקוחות ועל הגדרת פרויקטים לצורך חיוב מכסות זמין במאמר סקירה כללית על פרויקטים לצורך חיוב מכסות.

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

כדי לקבל את ההרשאה שנדרשת לשימוש בפרויקט לצורך תזמור ברמת הארגון וברמת התיקייה, בקשו מהאדמין להקצות לכם את התפקיד Service Usage Consumer (roles/serviceusage.serviceUsageConsumer) ב-IAM בפרויקט לצורך הקצאת מכסות. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה מכיל את ההרשאה serviceusage.services.use, שנדרשת כדי להשתמש בפרויקט מכסות לתזמורים ברמת הארגון וברמת התיקייה.

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

כשמשתמשים ב-CLI של gcloud או ב-API בארכיטקטורת REST כדי לקרוא ל-methods של מתזמר המדיניות, צריך לציין את הפרויקט לצורך חיוב על מכסות באופן הבא:

gcloud

מגדירים את פרויקט המכסות במאפיין ההגדרות האישיות של ה-CLI של gcloud:

gcloud config set billing/quota_project QUOTA_PROJECT_ID

מחליפים את QUOTA_PROJECT_ID במזהה הפרויקט לצורכי מכסה.

לחלופין, אפשר להגדיר את פרויקט החיוב של מכסות לפקודה ספציפית באמצעות הדגל --billing-project, שמקבל קדימות על פני מאפיין ההגדרה.

REST

מוסיפים את כותרת ה-HTTP‏ x-goog-user-project כדי לציין פרויקט לחיוב על מכסות בכל בקשה. לפרטים נוספים תוכלו לקרוא את המאמר הגדרה של פרויקט לצורכי מכסה בבקשת REST.

הפעלת OS Config API

כדי להשתמש בתכונה "מנהל המדיניות" ב-VM Manager, צריך להפעיל את OS Config API בפרויקטים הבאים:

  • בתזמורים ברמת הארגון וברמת התיקייה, מפעילים את OS Config API בפרויקט המכסות.
  • בתזמורים ברמת הפרויקט, מפעילים את OS Config API בפרויקט שבו יוצרים את מתזמני המדיניות.

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

כדי לקבל את ההרשאה שנדרשת להפעלת OS Config API, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin) בפרויקט או בפרויקט המכסה. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה serviceusage.services.enable, שנדרשת כדי להפעיל את OS Config API.

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

מידע נוסף זמין במאמר הפעלת OS Config API.

הפעלת Progressive Rollout API בפרויקטים

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

כדי לקבל את ההרשאה שנדרשת להפעלת Progressive Rollout API, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש מכיל את ההרשאה serviceusage.services.enable, שנדרשת כדי להפעיל את Progressive Rollout API.

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

המסוף

  1. במסוף Google Cloud , בוחרים את הפרויקט ב- Google Cloud שבו רוצים להפעיל את ה-API, ואז נכנסים לדף APIs & Services:

    נכנסים לדף APIs & Services.

  2. לוחצים על Enable APIs and Services.

  3. מחפשים את "השקה הדרגתית".

  4. בתוצאות החיפוש, לוחצים על Progressive Rollout API.

  5. אם ה-API לא מופעל, לוחצים על Enable.

gcloud

  1. כדי לבדוק אם Progressive Rollout API מופעל, מציגים את רשימת השירותים שמופעלים בפרויקט:

     gcloud services list --project=PROJECT_ID
    

    מחליפים את PROJECT_ID במזהה הפרויקט שבו רוצים להפעיל את ה-API.

    אם progressiverollout.googleapis.com מופיע בפלט, ה-API מופעל.

  2. אם ה-API לא מופעל, מריצים את הפקודה הבאה כדי להפעיל אותו:

     gcloud services enable progressiverollout.googleapis.com
    

    מידע נוסף זמין במאמר gcloud services.

הגדרת סוכני השירות של OS Config

כדי לבצע פעולות בפרויקטים, כלי הניהול של המדיניות משתמש בסוכני השירות של OS Config. הוא גם תלוי ב-Progressive Rollout API, שיש לו סוכני שירות משלו. מידע נוסף מופיע במאמר סוכני שירות.

אתם צריכים ליצור את סוכני השירות לכל פרויקט, תיקייה או ארגון שבהם אתם יוצרים את מתזמר המדיניות. כדי שהכלי לניהול מדיניות יפעל כמו שצריך, צריך לתת לסוכני השירות האלה את תפקידי ה-IAM הנדרשים במשאב ההורה של הכלי לניהול מדיניות:

  • סוכן השירות של OSConfig‏ (roles/osconfig.serviceAgent) לחשבון @gcp-sa-osconfig.iam.gserviceaccount.com ‎
  • סוכן השירות OSConfig Rollout Service Agent‏ (roles/osconfig.rolloutServiceAgent) לחשבון ‎ @gcp-sa-osconfig-rollout.iam.gserviceaccount.com ‎
  • סוכן השירות Progressiverollout‏ (roles/progressiverollout.serviceAgent) לחשבון ‎ @gcp-sa-progrollout.iam.gserviceaccount.com ‎

כדי להקצות תפקידי IAM לסוכני השירות, משתמשים במסוף Google Cloud או בפקודה add-iam-policy-binding. מידע נוסף זמין במאמר הקצאת תפקיד לסוכן השירות.

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

כדי לקבל את ההרשאות שדרושות ליצירת סוכני השירות ולמתן גישה אליהם, צריך לבקש מהאדמין את התפקידים הבאים ב-IAM ברמת הפרויקט, התיקייה או הארגון שבהם יוצרים את מתזמר המדיניות:

  • יצירת סוכני שירות: אדמין של שימוש בשירות (roles/serviceusage.serviceUsageAdmin)
  • כדי לתת לסוכני שירות גישה לפרויקט: אדמין IAM של פרויקט (​roles/resourcemanager.projectIamAdmin)
  • כדי לתת לסוכני שירות גישה לתיקייה: אדמין IAM של תיקיות (roles/resourcemanager.folderIamAdmin) או אדמין תיקיות (roles/resourcemanager.folderAdmin)
  • כדי לתת לסוכני שירות גישה לפרויקטים, לתיקיות ולארגונים: אדמין של ארגון (roles/resourcemanager.organizationAdmin)

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

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

ההרשאות הנדרשות

כדי ליצור את סוכני השירות ולתת להם גישה, נדרשות ההרשאות הבאות:

  • יוצרים סוכני שירות: serviceusage.services.generateServiceIdentity
  • כדי לתת לסוכני השירות גישה לפרויקט:
    • resourcemanager.projects.getIamPolicy
    • resourcemanager.projects.setIamPolicy
  • כדי לתת לסוכני השירות גישה לתיקייה:
    • resourcemanager.folders.getIamPolicy
    • resourcemanager.folders.setIamPolicy
  • כדי לתת לסוכני השירות גישה לארגון:
    • resourcemanager.organizations.getIamPolicy
    • resourcemanager.organizations.setIamPolicy

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

כדי ליצור את סוכני השירות:

  1. בודקים את הפורמט של כתובת האימייל של סוכן השירות לכל משאב:

    פרויקט

    • service-PROJECT_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com
    • service-PROJECT_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com
    • service-PROJECT_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com

    מחליפים את PROJECT_NUMBER במזהה המספרי של הפרויקט שבו יוצרים את כלי הניהול של המדיניות.

    תיקייה

    • service-folder-FOLDER_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com
    • service-folder-FOLDER_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com
    • service-folder-FOLDER_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com

    מחליפים את FOLDER_NUMBER במזהה המספרי של התיקייה שבה יוצרים את מתזמני המדיניות.

    ארגון

    • service-org-ORGANIZATION_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com
    • service-org-ORGANIZATION_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com
    • service-org-ORGANIZATION_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com

    מחליפים את ORGANIZATION_NUMBER במזהה המספרי של הארגון שבו יוצרים את כלי ניהול המדיניות.

  2. כדי ליצור את סוכן השירות ל-API ולמשאב שצוינו, משתמשים בפקודה gcloud beta services identity create:

    פרויקט

    # Create an OS config service agent
    gcloud beta services identity create --service=osconfig.googleapis.com  --project=PROJECT_NUMBER
    
    # Create a Progressive Rollout service agent
    gcloud beta services identity create --service=progressiverollout.googleapis.com  --project=PROJECT_NUMBER
    

    מחליפים את PROJECT_NUMBER במזהה המספרי של הפרויקט שבו רוצים ליצור את סוכן השירות.

    תיקייה

    # Create an OS config service agent
    gcloud beta services identity create --service=osconfig.googleapis.com  --folder=FOLDER_NUMBER
    
    # Create a Progressive Rollout service agent
    gcloud beta services identity create --service=progressiverollout.googleapis.com  --folder=FOLDER_NUMBER
    

    מחליפים את FOLDER_NUMBER במזהה המספרי של התיקייה שבה רוצים ליצור את סוכן השירות.

    ארגון

    # Create an OS config service agent
    gcloud beta services identity create --service=osconfig.googleapis.com --organization=ORGANIZATION_NUMBER
    
    # Create a Progressive Rollout service agent
    gcloud beta services identity create --service=progressiverollout.googleapis.com  --organization=ORGANIZATION_NUMBER
    

    מחליפים את ORGANIZATION_NUMBER במזהה המספרי של הארגון שבו רוצים ליצור את סוכן השירות.

הקצאת תפקידי IAM לסוכני השירות

אחרי שיוצרים את סוכני השירות של OS Config ושל ההשקה המדורגת, נותנים להם את תפקידי ה-IAM הנדרשים (roles/osconfig.serviceAgent,‏ roles/osconfig.rolloutServiceAgent ו-roles/progressiverollout.serviceAgent) בפרויקט, בתיקייה או בארגון שבהם יוצרים את מתזמר המדיניות.

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

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

  • כדי לתת לסוכני שירות גישה לפרויקט: אדמין IAM של פרויקט (​roles/resourcemanager.projectIamAdmin)
  • כדי לתת לסוכני שירות גישה לתיקייה: אדמין IAM של תיקיות (roles/resourcemanager.folderIamAdmin) או אדמין תיקיות (roles/resourcemanager.folderAdmin)
  • כדי לתת לסוכני שירות גישה לפרויקטים, לתיקיות ולארגונים: אדמין של ארגון (roles/resourcemanager.organizationAdmin)

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

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

ההרשאות הנדרשות

כדי לתת לסוכני השירות גישה, נדרשות ההרשאות הבאות:

  • כדי לתת לסוכני השירות גישה לפרויקט:
    • resourcemanager.projects.getIamPolicy
    • resourcemanager.projects.setIamPolicy
  • כדי לתת לסוכני השירות גישה לתיקייה:
    • resourcemanager.folders.getIamPolicy
    • resourcemanager.folders.setIamPolicy
  • כדי לתת לסוכני השירות גישה לארגון:
    • resourcemanager.organizations.getIamPolicy
    • resourcemanager.organizations.setIamPolicy

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

כדי להקצות את התפקידים לסוכן השירות, מריצים את gcloud add-iam-policy-binding באופן הבא:

פרויקט

# Grant the required role to the OS config rollout service agent
 gcloud projects add-iam-policy-binding PROJECT_ID \
 --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com" \
 --role="roles/osconfig.rolloutServiceAgent"

 # Grant the required role to the OS config service agent
 gcloud projects add-iam-policy-binding PROJECT_ID \
 --member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com" \
 --role="roles/osconfig.serviceAgent"

 # Grant the required role to the Progressive Rollout service agent
 gcloud projects add-iam-policy-binding PROJECT_ID \
--member="serviceAccount:service-PROJECT_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com" \
--role="roles/progressiverollout.serviceAgent"

מחליפים את PROJECT_NUMBER במזהה המספרי של הפרויקט שאליו מוסיפים את הקישור של מדיניות ה-IAM.

תיקייה

# Grant the required role to the OS config rollout service agent
gcloud resource-manager folders add-iam-policy-binding FOLDER_NUMBER \
 --member="serviceAccount:service-folder-FOLDER_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com" \
 --role="roles/osconfig.rolloutServiceAgent"

# Grant the required role to the OS config service agent
gcloud resource-manager folders add-iam-policy-binding FOLDER_NUMBER \
 --member="serviceAccount:service-folder-FOLDER_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com" \
 --role="roles/osconfig.serviceAgent"

# Grant the required role to the Progressive Rollout service agent
gcloud resource-manager folders add-iam-policy-binding FOLDER_NUMBER \
--member="serviceAccount:service-folder-FOLDER_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com" \
--role="roles/progressiverollout.serviceAgent"

מחליפים את FOLDER_NUMBER במזהה המספרי של התיקייה שאליה מוסיפים את הקישור למדיניות ה-IAM.

ארגון

# Grant the required role to the OS config rollout service agent
gcloud organizations add-iam-policy-binding ORGANIZATION_NUMBER \
 --member="serviceAccount:service-org-ORGANIZATION_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com" \
 --role="roles/osconfig.rolloutServiceAgent"

 # Grant the required role to the OS config service agent
 gcloud organizations add-iam-policy-binding ORGANIZATION_NUMBER \
 --member="serviceAccount:service-org-ORGANIZATION_NUMBER@gcp-sa-osconfig.iam.gserviceaccount.com" \
 --role="roles/osconfig.serviceAgent"

 # Grant the required role to the Progressive Rollout service agent
 gcloud organizations add-iam-policy-binding ORGANIZATION_NUMBER \
--member="serviceAccount:service-org-ORGANIZATION_NUMBER@gcp-sa-progrollout.iam.gserviceaccount.com" \
--role="roles/progressiverollout.serviceAgent"

מחליפים את ORGANIZATION_NUMBER במזהה המספרי של הארגון שאליו מוסיפים את הקישור למדיניות ה-IAM.

הגדרת גישה לפרויקטים בהיקפי השירות של VPC Service Controls

אם אתם משתמשים בכלים לניהול מדיניות ברמת הארגון או התיקייה בפרויקטים שמוגנים על ידי VPC Service Controls, אתם צריכים לתת לסוכן השירות של OSConfig Rollout גישה לגבולות הגזרה לשירות של VPC Service Controls. אם לא תעניקו את הגישה הזו, כלי התיאום של המדיניות לא יוכל ליצור, לעדכן או למחוק הקצאות של מדיניות מערכת ההפעלה בפרויקטים האלה.

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

כדי לקבל את ההרשאות שנדרשות להגדרת כלי תזמור של מדיניות מערכת ההפעלה לשימוש בהיקפי VPC Service Controls, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד עריכה ב-Access Context Manager (roles/accesscontextmanager.policyEditor) בארגון. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

ההרשאות הנדרשות

כדי להגדיר את כלי הניהול של מדיניות מערכת ההפעלה לשימוש בהיקפי VPC Service Controls, נדרשות ההרשאות הבאות:

  • accesscontextmanager.servicePerimeters.get
  • accesscontextmanager.servicePerimeters.update

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

יצירת כללי תעבורת הנתונים הנכנסת (ingress)

כדי לאפשר לסוכן השירות לגשת למשאבים שמוגנים על ידי VPC Service Controls, צריך להוסיף כלל תעבורת נתונים נכנסת (ingress) לגבולות הגזרה לשירות הרלוונטיים.

למידע נוסף על יצירת כללי תעבורת נתונים נכנסת (ingress), ראו הגדרת כללי מדיניות של תעבורת נתונים נכנסת (ingress) ותעבורת נתונים יוצאת (egress).

תיקייה

המסוף

  1. נכנסים לדף VPC Service Controls במסוף Google Cloud .

    כניסה ל-VPC Service Controls

  2. בוחרים את הארגון.
  3. בדף VPC Service Controls, בוחרים את מדיניות הגישה שמכילה את גבולות הגזרה לשירות שרוצים לעדכן.
  4. לוחצים על השם של גבולות גזרה לשירות שרוצים לעדכן ואז על Edit.
  5. לוחצים על Ingress policy.
  6. לוחצים על Add an ingress rule.
  7. בקטע From, מציינים את הזהות של סוכן השירות:
    1. בקטע Identities > Identity, בוחרים באפשרות Select identities & groups.
    2. לוחצים על הוספת זהויות.
    3. מזינים את כתובת האימייל שמזהה את סוכן השירות הבא של OSconfig rollout:

      service-folder-FOLDER_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com

      מחליפים את FOLDER_NUMBER במזהה המספרי של התיקייה.

  8. בקטע To, מציינים את הפעולות המותרות:
    1. בקטע Resources > Projects, בוחרים באפשרות All projects.
    2. בקטע Operations or IAM roles, לוחצים על Select operations.
    3. לוחצים על Add operations ומוסיפים את הפעולה הבאה:
      1. מוסיפים את השירות osconfig.googleapis.com.
      2. לוחצים על כל השיטות.
  9. לוחצים על סיום.
  10. לוחצים על Save.

gcloud

כדי להוסיף את כלל התעבורה הנכנסת, יוצרים קובץ YAML שמכיל את כלל התעבורה הנכנסת ומשתמשים בפקודה gcloud access-context-manager perimeters update עם הדגל --set-ingress-policies.

  1. יוצרים קובץ YAML של מדיניות תעבורת נתונים נכנסת בשם ingress_policy.yaml עם התוכן הבא:

     - ingressFrom:
         identities:
         - serviceAccount:service-folder-FOLDER_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com
         sources:
         - accessLevel: '*'
       ingressTo:
         operations:
         - serviceName: osconfig.googleapis.com
           methodSelectors:
           - method: "*"
         resources:
         - "*"
    

    מחליפים את FOLDER_NUMBER במזהה המספרי של התיקייה.

  2. מוסיפים את מדיניות התעבורה הנכנסת להיקף:

    gcloud access-context-manager perimeters update PERIMETER_NAME \
       --set-ingress-policies=ingress_policy.yaml
    

    מחליפים את PERIMETER_NAME בשם של גבולות הגזרה לשירות. לדוגמה, accessPolicies/1234567890/servicePerimeters/example_perimeter.

ארגון

המסוף

  1. נכנסים לדף VPC Service Controls במסוף Google Cloud .

    כניסה ל-VPC Service Controls

  2. בוחרים את הארגון.
  3. בדף VPC Service Controls, בוחרים את מדיניות הגישה שמכילה את גבולות הגזרה לשירות שרוצים לעדכן.
  4. לוחצים על השם של גבולות גזרה לשירות שרוצים לעדכן ואז על Edit.
  5. לוחצים על Ingress policy.
  6. לוחצים על Add an ingress rule.
  7. בקטע From, מציינים את הזהות של סוכן השירות:
    1. בקטע Identities > Identity, בוחרים באפשרות Select identities & groups.
    2. לוחצים על הוספת זהויות.
    3. מזינים את כתובת האימייל שמזהה את סוכן השירות הבא של OSconfig rollout:

      service-org-ORGANIZATION_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com

      מחליפים את ORGANIZATION_NUMBER במזהה המספרי של הארגון.

  8. בקטע To, מציינים את הפעולות המותרות:
    1. בקטע Resources > Projects, בוחרים באפשרות All projects.
    2. בקטע Operations or IAM roles, לוחצים על Select operations.
    3. לוחצים על Add operations ומוסיפים את הפעולה הבאה:
      1. מוסיפים את השירות osconfig.googleapis.com.
      2. לוחצים על כל השיטות.
  9. לוחצים על סיום.
  10. לוחצים על Save.

gcloud

כדי להוסיף את כלל התעבורה הנכנסת, יוצרים קובץ YAML שמכיל את כלל התעבורה הנכנסת ומשתמשים בפקודה gcloud access-context-manager perimeters update עם הדגל --set-ingress-policies.

  1. יוצרים קובץ YAML של מדיניות תעבורת נתונים נכנסת בשם ingress_policy.yaml עם התוכן הבא:

     - ingressFrom:
         identities:
         - serviceAccount:service-org-ORGANIZATION_NUMBER@gcp-sa-osconfig-rollout.iam.gserviceaccount.com
         sources:
         - accessLevel: '*'
       ingressTo:
         operations:
         - serviceName: osconfig.googleapis.com
           methodSelectors:
           - method: "*"
         resources:
         - "*"
    

    מחליפים את ORGANIZATION_NUMBER במזהה המספרי של הארגון.

  2. מוסיפים את מדיניות התעבורה הנכנסת להיקף:

    gcloud access-context-manager perimeters update PERIMETER_NAME \
      --set-ingress-policies=ingress_policy.yaml
    

    מחליפים את PERIMETER_NAME בשם של גבולות הגזרה לשירות. לדוגמה, accessPolicies/1234567890/servicePerimeters/example_perimeter.

מה השלב הבא?