Google Cloud מדיניות הארגון מאפשרת לכם שליטה מרוכזת ופרוגרמטית על המשאבים של הארגון. אדמינים של מדיניות הארגון יכולים להגדיר מדיניות ארגונית, שהיא קבוצה של הגבלות שנקראות אילוצים, שחלות על משאביGoogle Cloud ועל הצאצאים של המשאבים האלה בהיררכיית המשאבים שלGoogle Cloud . אפשר לאכוף את מדיניות הארגון ברמת הארגון, התיקייה או הפרויקט.
מדיניות הארגון מספקת אילוצים מוגדרים מראש לשירותים שונים שלGoogle Cloud . עם זאת, אם אתם רוצים שליטה מפורטת יותר וניתנת להתאמה אישית על השדות הספציפיים שמוגבלים במדיניות הארגון, אתם יכולים גם ליצור מדיניות ארגון בהתאמה אישית.
יתרונות
- אבטחה, תאימות ופיקוח: אתם יכולים להשתמש בכללי מדיניות מותאמים אישית של הארגון באופן הבא:
- כדי לאכוף את דרישות האבטחה, אתם יכולים לאכוף את השימוש במפתחות הצפנה בניהול הלקוח (CMEK).
- אתם יכולים להגביל כל שדה שמועבר כשאתם יוצרים או מעדכנים מאגר.
ירושה של מדיניות
כברירת מחדל, מדיניות הארגון עוברת בירושה לצאצאים של המשאבים שעליהם אתם אוכפים את המדיניות. לדוגמה, אם אוכפים מדיניות בתיקייה, Google Cloud אוכף את המדיניות בכל הפרויקטים שבתיקייה. במאמר כללי הערכה של היררכיה מוסבר בהרחבה על ההתנהגות הזו ואיך לשנות אותה.
תמחור
שירות מדיניות הארגון, כולל כללי מדיניות מוגדרים מראש וכללי מדיניות בהתאמה אישית, מוצע ללא תשלום.
לפני שמתחילים
- מפעילים את Artifact Registry ומתקינים את Google Cloud CLI.
- (אופציונלי) הגדרת ברירות מחדל לפקודות של ה-CLI של gcloud.
- אם אתם צריכים מפתחות הצפנה בניהול הלקוח (CMEK) כדי להצפין את התוכן במאגר, צרו והפעילו מפתח ב-Cloud KMS בשביל המאגר.
- מוודאים שאתם יודעים מהו מזהה הארגון שלכם.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול מדיניות הארגון, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM:
- אדמין של מדיניות הארגון (
roles/orgpolicy.policyAdmin) במשאב הארגון -
כדי לבדוק את מדיניות הארגון: אדמין של Artifact Registry (
roles/artifactregistry.admin) במשאב הארגון
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לנהל את מדיניות הארגון. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לנהל את מדיניות הארגון, נדרשות ההרשאות הבאות:
-
orgpolicy.constraints.list -
orgpolicy.policies.create -
orgpolicy.policies.delete -
orgpolicy.policies.list -
orgpolicy.policies.update -
orgpolicy.policy.get -
orgpolicy.policy.set
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
יצירת אילוץ בהתאמה אישית
אילוץ מותאם אישית מוגדר בקובץ YAML לפי המשאבים, השיטות, התנאים והפעולות שנתמכים בשירות שבו אתם אוכפים את מדיניות הארגון. התנאים של האילוצים המותאמים אישית מוגדרים באמצעות Common Expression Language (CEL). בקטע CEL במאמר יצירה וניהול של אילוצים בהתאמה אישית מוסבר איך ליצור תנאים באילוצים בהתאמה אישית באמצעות CEL.
ב-Artifact Registry אפשר להשתמש באילוצים מותאמים אישית שחלים על השיטות CREATE ו-UPDATE של המשאב REPOSITORY.
יוצרים קובץ YAML לאילוץ בהתאמה אישית, בדומה לקובץ הבא:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resourceTypes:
- artifactregistry.googleapis.com/Repository
methodTypes:
- CREATE
- UPDATE
condition: "CONDITION"
actionType: ACTION
displayName: DISPLAY_NAME
description: DESCRIPTION
מחליפים את מה שכתוב בשדות הבאים:
ORGANIZATION_ID: מזהה הארגון, למשל123456789.
CONSTRAINT_NAME: השם שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית חייב להתחיל ב-custom., ויכול לכלול רק אותיות רישיות, אותיות קטנות או מספרים – לדוגמה, custom.enableDockerRemotes. האורך המקסימלי של השדה הזה הוא 70 תווים, לא כולל הקידומת, לדוגמה:organizations/123456789/customConstraints/custom.enableDockerRemotes.
CONDITION: תנאי CEL שנכתב כנגד ייצוג של משאב שירות נתמך. האורך המקסימלי של השדה הזה הוא 1,500 תווים. במאמר משאבים נתמכים תוכלו לקרוא מידע נוסף על המשאבים שאפשר לכתוב להם תנאים, למשל(resource.mode == 'REMOTE' && resource.format == 'DOCKER') || (resource.mode != 'REMOTE').
ACTION: הפעולה שתתבצע אם התנאיconditionמתקיים. הערך יכול להיותALLOWאוDENY.
DISPLAY_NAME: שם קריא לאנשים של האילוץ. האורך המקסימלי של השדה הזה הוא 200 תווים.
DESCRIPTION: תיאור ידידותי למשתמש של האילוץ, שיוצג כהודעת שגיאה במקרה של הפרת המדיניות. האורך המקסימלי של השדה הזה הוא 2,000 תווים, לדוגמהAll remote repositories must be Docker format.
למידע נוסף על יצירת אילוץ בהתאמה אישית, ראו הגדרת אילוצים בהתאמה אישית.
הגדרת אילוץ בהתאמה אישית
המסוף
כדי ליצור אילוץ בהתאמה אישית:
- במסוף Google Cloud , נכנסים לדף מדיניות הארגון.
- בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- לוחצים על Custom constraint.
- בתיבה Display name, מזינים שם לאילוץ שיהיה קריא לאנשים. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע רגיש בשמות לתצוגה, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
-
בתיבה Constraint ID, מזינים את המזהה שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה
custom.enableDockerRemotes. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.), לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. - בתיבה Description, מזינים תיאור של האילוץ שקריא לאנשים. התיאור הזה משמש כהודעת שגיאה כשיש הפרה של המדיניות. ציינו פרטים על הסיבה להפרת המדיניות ואיך לפתור את הבעיה. אל תכללו פרטים אישיים מזהים או מידע רגיש בתיאור, כי הם עלולים להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 2,000 תווים.
-
בתיבה Resource type, בוחרים את השם של משאב ה- Google Cloud REST שמכיל את האובייקט והשדה שרוצים להגביל, לדוגמה
container.googleapis.com/Cluster. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
אפשר לאכוף את האילוץ הזה רק ב-REST
CREATE. - כדי להגדיר תנאי, לוחצים על עריכת התנאי.
-
בחלונית Add condition, יוצרים תנאי CEL שמתייחס למשאב שירות נתמך, לדוגמה
resource.autopilot.enabled == false. השדה הזה יכול להכיל עד 1,500 תווים. לפרטים על השימוש ב-CEL, ראו Common Expression Language. מידע נוסף על משאבי השירות שבהם אפשר להשתמש באילוצים מותאמים אישית מופיע במאמר שירותים שנתמכים באילוצים מותאמים אישית. - לוחצים על Save.
- בקטע Action, בוחרים אם לאשר או לדחות את השיטה שנבדקה אם התנאי מתקיים.
- לוחצים על Create constraint.
כדי לראות את השיטות הנתמכות בכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
פעולת הדחייה פירושה שהפעולה ליצירה או לעדכון של המשאב נחסמת אם התנאי מקבל את הערך True.
פעולת ההרשאה מאפשרת ליצור או לעדכן את המשאב רק אם התנאי מתקיים. כל מקרה אחר, מלבד אלה שרשומים במפורש בתנאי, נחסם.
אחרי שמזינים ערך בכל שדה, הגדרת ה-YAML המקבילה לאילוץ המותאם אישית הזה מופיעה בצד שמאל.
gcloud
- כדי ליצור אילוץ בהתאמה אישית, יוצרים קובץ YAML בפורמט הבא:
-
ORGANIZATION_ID: מזהה הארגון, למשל123456789. -
CONSTRAINT_NAME: השם שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה,custom.enableDockerRemotes. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.) – לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. -
RESOURCE_NAME: השם המלא של המשאב ב- Google Cloudשמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה,artifactregistry.googleapis.com/Repository. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
methodTypes: השיטות של REST שעליהן נאכף האילוץ. הערך יכול להיות רקCREATE. -
CONDITION: תנאי CEL שנכתב כנגד ייצוג של משאב שירות נתמך. השדה הזה יכול להכיל עד 1,500 תווים. לדוגמה,.(resource.mode == 'REMOTE' && resource.format == 'DOCKER') || (resource.mode != 'REMOTE') -
ACTION: הפעולה שצריך לבצע אם התנאיconditionמתקיים. הערך יכול להיות רקALLOW. -
DISPLAY_NAME: שם קריא לאנשים של האילוץ. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים או במידע רגיש בשמות המוצגים, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים. -
DESCRIPTION: תיאור קריא של האילוץ שיוצג כהודעת שגיאה במקרה של הפרת המדיניות. השדה הזה יכול להכיל עד 2,000 תווים. -
אחרי שיוצרים את קובץ ה-YAML לאילוץ חדש בהתאמה אישית, צריך להגדיר אותו כדי שיהיה זמין למדיניות הארגון. כדי להגדיר אילוץ בהתאמה אישית, משתמשים בפקודה
gcloud org-policies set-custom-constraint: -
כדי לוודא שהאילוץ המותאם אישית קיים, משתמשים בפקודה
gcloud org-policies list-custom-constraints:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: RESOURCE_NAME methodTypes: - CREATE condition: "CONDITION" actionType: ACTION displayName: DISPLAY_NAME description: DESCRIPTION
מחליפים את מה שכתוב בשדות הבאים:
כדי לראות את השיטות הנתמכות לכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
למידע נוסף על המשאבים הזמינים לכתיבת תנאים, ראו משאבים נתמכים.
הפעולה allow פירושה שאם התנאי מקבל את הערך true, מותר ליצור או לעדכן את המשאב. זה גם אומר שכל מקרה אחר, מלבד המקרה שמופיע במפורש בתנאי, נחסם.
gcloud org-policies set-custom-constraint CONSTRAINT_PATH
מחליפים את CONSTRAINT_PATH בנתיב המלא לקובץ האילוץ בהתאמה אישית. לדוגמה, /home/user/customconstraint.yaml.
בסיום הפעולה, האילוצים המותאמים אישית יהיו זמינים כמדיניות של הארגון ברשימת Google Cloud מדיניות הארגון.
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
מחליפים את ORGANIZATION_ID במזהה של משאב הארגון.
אכיפה של מדיניות ארגונית בהתאמה אישית
כדי לאכוף אילוץ, אתם יכולים ליצור מדיניות ארגון שמפנה אליו, ואז להחיל את מדיניות הארגון על משאב Google Cloud .המסוף
- במסוף Google Cloud , נכנסים לדף מדיניות הארגון.
- בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- ברשימה שבדף מדיניות הארגון, בוחרים את האילוץ כדי להציג את הדף Policy details של אותו אילוץ.
- כדי להגדיר את מדיניות הארגון למשאב הזה, לוחצים על ניהול המדיניות.
- בדף עריכת המדיניות, בוחרים באפשרות במקום המדיניות של המשאב הראשי.
- לוחצים על Add a rule.
- בקטע Enforcement, בוחרים אם לאכוף את מדיניות הארגון הזו או לא.
- אופציונלי: כדי להוסיף תנאי למדיניות הארגון שמבוסס על תג, לוחצים על Add condition. שימו לב: אם מוסיפים כלל מותנה למדיניות הארגון, צריך להוסיף לפחות כלל אחד לא מותנה, אחרת אי אפשר לשמור את המדיניות. מידע נוסף זמין במאמר הגדרת ההיקף של מדיניות הארגון באמצעות תגים.
- לוחצים על בדיקת השינויים כדי לדמות את ההשפעה של מדיניות הארגון. למידע נוסף, קראו את המאמר בדיקת שינויים במדיניות הארגון באמצעות סימולטור המדיניות.
- כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, לוחצים על הגדרת המדיניות להרצת בדיקה. למידע נוסף, קראו את המאמר בדיקת כללי מדיניות של הארגון.
- אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמו שצריך, לוחצים על Set policy כדי להגדיר את המדיניות הפעילה.
gcloud
- כדי ליצור מדיניות ארגונית עם כללים בוליאניים, יוצרים קובץ YAML של מדיניות שמפנה לאילוץ:
-
PROJECT_ID: הפרויקט שבו רוצים לאכוף את האילוץ. -
CONSTRAINT_NAME: השם שהגדרתם לאילוץ המותאם אישית. לדוגמה,custom.enableDockerRemotes. -
כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, מריצים את הפקודה הבאה עם הדגל
dryRunSpec: -
אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמצופה, מגדירים את המדיניות הפעילה באמצעות הפקודה
org-policies set-policyוהדגלspec:
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: true dryRunSpec: rules: - enforce: true
מחליפים את מה שכתוב בשדות הבאים:
gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec
מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
gcloud org-policies set-policy POLICY_PATH --update-mask=spec
מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
בדיקת מדיניות הארגון בהתאמה אישית
בדוגמה הבאה ליצירת מאגר מרוחק, אנחנו מניחים שנוצרה מדיניות ארגונית בהתאמה אישית ונאכפה על יצירת המאגר, כדי לאפשר רק יצירה של מאגרים מרוחקים בפורמט Docker.
מנסים ליצור מאגר מרוחק של Python בפרויקט:
gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
--project=PROJECT_ID \
--repository-format=python \
--location=LOCATION \
--description="DESCRIPTION" \
--mode=remote-repository \
--remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
--disable-vulnerability-scanning \
--remote-python-repo=UPSTREAM \
--remote-username="USERNAME" \
--remote-password-secret-version="PASSWORD"
מחליפים את מה שכתוב בשדות הבאים:
-
REMOTE-REPOSITORY-NAME: שם המאגר. לכל מיקום של מאגר בפרויקט, שמות המאגרים חייבים להיות ייחודיים. -
PROJECT_ID: מזהה הפרויקט. אם לא מציינים את הדגל הזה, המערכת משתמשת בפרויקט הנוכחי או בפרויקט שמוגדר כברירת מחדל. -
LOCATION: המיקום של המאגר, באזור אחד או בכמה אזורים. אם הגדרתם ברירת מחדל, אתם יכולים להשמיט את הדגל הזה. כדי לראות רשימה של מיקומים נתמכים, מריצים את הפקודהgcloud artifacts locations list. -
DESCRIPTION: אופציונלי. תיאור של המאגר. אל תכללו מידע רגיש, כי התיאורים של המאגרים לא מוצפנים. -
REMOTE-REPOSITORY-DESCRIPTION: אופציונלי. תיאור של הגדרת המאגר החיצוני של המאגר המרוחק הזה. -
USERNAME: אופציונלי. שם המשתמש לאימות במאגר במעלה הזרם. -
PASSWORD: אופציונלי. גרסת הסוד שמכילה את הסיסמה למאגר במעלה הזרם.
UPSTREAMעם השם של מאגר ה-upstream שהוגדר מראש, נתיב המאגר ב-Artifact Registry או כתובת ה-URL של מאגר ה-upstream שהוגדרה על ידי המשתמש.
במאגרים במעלה הזרם של Artifact Registry, הפורמט של נתיב המאגר צריך להיות דומה לזה:projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY.
במאמר פורמטים נתמכים מפורט מידע על השרתים הזמינים שהוגדרו מראש ועל השרתים הנתמכים שהוגדרו על ידי המשתמשים.
--disable-vulnerability-scanning: דגל אופציונלי שמגדיר את המאגר שלך להשבית בדיקת נקודות חולשה אוטומטית.
--allow-vulnerability-scanning: דגל אופציונלי שמאפשר להגדיר את המאגר כך שתתבצע בו בדיקת נקודות חולשה אוטומטית. מידע נוסף מופיע במאמר הפעלה או השבתה של סריקה אוטומטית.לדוגמה, הפקודה הבאה יוצרת מאגר מרוחק בשם
my-repoבאזורus-east1בפרויקט Google Cloud ב-my-project, ויכולה לבצע אימות למאגר במעלה הזרם באמצעות שם המשתמשmy-usernameוגרסת הסודprojects/my-project/secrets/my-secret/versions/1.gcloud artifacts repositories create my-repo \ --project=my-project \ --repository-format=python \ --location=us-east1 \ --description="Remote Python repository" \ --mode=remote-repository \ --remote-repo-config-desc="PyPI" \ --remote-username=my-username \ --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \ --remote-python-repo=PYPI
הפלט שיתקבל:
Operation denied by custom org policies: ["customConstraints/custom.enableDockerRemotes": "All remote repositories must be Docker format."]
משאבים נתמכים ב-Artifact Registry
ב-Artifact Registry אפשר להשתמש באילוצים מותאמים אישית בכל השדות, חוץ מהשדה labels, לפעולות של יצירה ועדכון במשאב repository.
דוגמאות למדיניות ארגונית בהתאמה אישית לתרחישים נפוצים
בטבלה הבאה מפורט התחביר של כמה כללי מדיניות ארגוניים בהתאמה אישית שיכולים להיות שימושיים:
| תיאור | תחביר האילוץ |
|---|---|
| השבתת היצירה של מאגרים מרוחקים |
name: organizations/ORGANIZATION_ID/customConstraints/custom.disableRemotes resourceTypes: - artifactregistry.googleapis.com/Repository methodTypes: - CREATE condition: "resource.mode in ['STANDARD', 'VIRTUAL']" actionType: ALLOW displayName: Disable remote repository creation description: All repositories must be standard or virtual mode. |
| אכיפת חוסר שינוי של תגים במאגרים בפורמט Docker |
name: organizations/ORGANIZATION_ID/customConstraints/custom.enforceTagImmutability resourceTypes: - artifactregistry.googleapis.com/Repository methodTypes: - CREATE condition: "resource.format == 'DOCKER' && !resource.dockerConfig.immutableTags" actionType: DENY displayName: Enforce tag immutability description: All new Docker repositories must have tag immutability enabled. |
| דרישה למפתח CMEK |
name: organizations/ORGANIZATION_ID/customConstraints/custom.requireCmekKey resourceTypes: - artifactregistry.googleapis.com/Repository methodTypes: - CREATE condition: "resource.kmsKeyName.contains('projects/my-project/')" actionType: ALLOW displayName: Enforce the use of a CMEK key from my-project description: All repositories must be created with a CMEK key from my-project. |
| מניעת השבתה של יומני הפלטפורמה במאגרים |
name: organizations/ORGANIZATION_ID/customConstraints/custom.preventDisablingPlatformLogs resourceTypes: - artifactregistry.googleapis.com/Repository methodTypes: - CREATE - UPDATE condition: "resource.platformLogsConfig.loggingState != 'DISABLED'" actionType: ALLOW displayName: Prevent disabling platform logs description: Repositories must not opt out of platform logs. Repositories that inherit the project-level configuration are allowed. |
| דרישה שביומני הפלטפורמה יתועדו אירועים ברמת חומרה INFO ומעלה |
name: organizations/ORGANIZATION_ID/customConstraints/custom.requireInfoLogSeverity resourceTypes: - artifactregistry.googleapis.com/Repository methodTypes: - CREATE - UPDATE condition: "resource.platformLogsConfig.loggingState != 'DISABLED' && resource.platformLogsConfig.severityLevel != 'ERROR'" actionType: ALLOW displayName: Require INFO severity platform logs description: Repositories must not restrict platform logs to error events only. |
המאמרים הבאים
- למידע נוסף על מדיניות הארגון, קראו את המאמר מבוא לשירות מדיניות הארגון.
- איך יוצרים ומנהלים את מדיניות הארגון
- רשימה מלאה של אילוצים מוגדרים מראש של מדיניות הארגון