ניהול משאבים של Google Cloud Armor באמצעות אילוצים בהתאמה אישית

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

השירות Organization Policy מספק מגבלות מוגדרות מראש לשירותים שונים שלGoogle Cloud . עם זאת, אם אתם רוצים שליטה מפורטת יותר בשדות הספציפיים שמוגבלים במדיניות הארגון, אתם יכולים גם ליצור אילוצים בהתאמה אישית ולאכוף אותם במדיניות ארגונית בהתאמה אישית.

העברה בירושה של מדיניות

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

משאבים נתמכים ב-Cloud Armor

במשאבים של Google Cloud Armor, אפשר להגדיר אילוצים בהתאמה אישית על המשאבים והשדות הבאים.

  • מדיניות אבטחה: compute.googleapis.com/SecurityPolicy
    • שם: resource.name
    • תיאור: resource.description
    • כללים: resource.rules[]
      • פעולה בכותרת: resource.rules[].headerAction
        • כותרות בקשה להוספה: resource.rules[].headerAction.requestHeadersToAdds[]
          • שם הכותרת: resource.rules[].headerAction.requestHeadersToAdds[].headerName
          • ערך הכותרת: resource.rules[].headerAction.requestHeadersToAdds[].headerValue
      • הכלי להתאמה: resource.rules[].match
        • ביטוי עם גרסה: resource.rules[].match.versionedExpr
        • הגדרות: resource.rules[].match.config
          • טווחי כתובות ה-IP של המקור: resource.rules[].match.config.srcIpRanges[]
        • ביטוי: resource.rules[].match.expr
        • אפשרויות לביטוי: resource.rules[].match.exprOptions
          • אפשרויות reCAPTCHA: resource.rules[].match.exprOptions.recaptchaOptions
            • מפתחות אתר של טוקן פעולה: resource.rules[].match.exprOptions.recaptchaOptions.actionTokenSiteKeys[]
            • מפתחות אתר של טוקן לסשן: resource.rules[].match.exprOptions.recaptchaOptions.sessionTokenSiteKeys[]
      • התאמה לרשת: resource.rules[].networkMatch
        • התאמה לשדה שהוגדר על ידי המשתמש: resource.rules[].networkMatch.userDefinedFieldMatch
          • שם: resource.rules[].networkMatch.userDefinedFieldMatch.name
          • ערכים: resource.rules[].networkMatch.userDefinedFieldMatch.values
        • טווחי כתובות ה-IP של המקור: resource.rules[].networkMatch.srcIpRanges
        • טווחי כתובות ה-IP של היעד: resource.rules[].networkMatch.destIpRanges
        • פרוטוקולי IP: resource.rules[].networkMatch.ipProtocols
        • יציאות מקור: resource.rules[].networkMatch.srcPorts
        • יציאות היעד: resource.rules[].networkMatch.destPorts
        • קודי אזורים של מקורות: resource.rules[].networkMatch.srcRegionCodes
        • מספרי מערכת אוטונומית (ASN) של המקור: resource.rules[].networkMatch.srcAsns
      • הגדרת WAF שהוגדרה מראש: resource.rules[].preconfiguredWafConfig
        • החרגות: resource.rules[].preconfiguredWafConfig.exclusions[]
          • קבוצת כללים ליעד: resource.rules[].preconfiguredWafConfig.exclusions[].targetRuleSet
          • מזהי כללים לטירגוט: resource.rules[].preconfiguredWafConfig.exclusions[].targetRuleIds[]
          • כותרות בקשה להחרגה: resource.rules[].preconfiguredWafConfig.exclusions[].requestHeadersToExclude[]
            • ערך: resource.rules[].preconfiguredWafConfig.exclusions[].requestHeadersToExclude[].val
            • פעולה: resource.rules[].preconfiguredWafConfig.exclusions[].requestHeadersToExclude[].op
          • קובצי Cookie של בקשות להחרגה: resource.rules[].preconfiguredWafConfig.exclusions[].requestCookiesToExclude[]
            • ערך: resource.rules[].preconfiguredWafConfig.exclusions[].requestCookiesToExclude[].val
            • פעולה: resource.rules[].preconfiguredWafConfig.exclusions[].requestCookiesToExclude[].op
          • פרמטרים של שאילתה בבקשה להחרגה: resource.rules[].preconfiguredWafConfig.exclusions[].requestQueryParamsToExclude[]
            • ערך: resource.rules[].preconfiguredWafConfig.exclusions[].requestQueryParamsToExclude[].val
            • פעולה: resource.rules[].preconfiguredWafConfig.exclusions[].requestQueryParamsToExclude[].op
          • מזהי URI של בקשות שרוצים להחריג: resource.rules[].preconfiguredWafConfig.exclusions[].requestUrisToExclude[]
            • ערך: resource.rules[].preconfiguredWafConfig.exclusions[].requestUrisToExclude[].val
            • פעולה: resource.rules[].preconfiguredWafConfig.exclusions[].requestUrisToExclude[].op
      • אפשרויות להפניה אוטומטית: resource.rules[].redirectOptions[]
        • סוג: resource.rules[].redirectOptions[].type
        • יעד: resource.rules[].redirectOptions[].target
      • אפשרויות מגבלת הקצב: resource.rules[].rateLimitOptions[]
        • סף מגבלת הקצב: resource.rules[].rateLimitOptions[].rateLimitThreshold
          • ספירה: resource.rules[].rateLimitOptions[].rateLimitThreshold.count
          • ‫Interval seconds: resource.rules[].rateLimitOptions[].rateLimitThreshold.intervalSec
        • פעולת התאמה: resource.rules[].rateLimitOptions[].conformAction
        • פעולה במקרה של חריגה: resource.rules[].rateLimitOptions[].exceedAction
        • חריגה מאפשרויות ההפניה האוטומטית: resource.rules[].rateLimitOptions[].exceedRedirectOptions
          • סוג: resource.rules[].rateLimitOptions[].exceedRedirectOptions.type
          • יעד: resource.rules[].rateLimitOptions[].exceedRedirectOptions.target
        • סטטוס RPC של פעולת חריגה: resource.rules[].rateLimitOptions[].exceedActionRpcStatus
          • קוד: resource.rules[].rateLimitOptions[].exceedActionRpcStatus.code
          • הודעה: resource.rules[].rateLimitOptions[].exceedActionRpcStatus.message
        • החלת האכיפה על המפתח: resource.rules[].rateLimitOptions[].enforceOnKey
        • אכיפה בשם המפתח: resource.rules[].rateLimitOptions[].enforceOnKeyName
        • Enforce on key configs: resource.rules[].rateLimitOptions[].enforceOnKeyConfigs
          • החלת האכיפה על סוג המפתח: resource.rules[].rateLimitOptions[].enforceOnKeyConfigs.enforceOnKeyType
          • אכיפה בשם המפתח: resource.rules[].rateLimitOptions[].enforceOnKeyConfigs.enforceOnKeyName
        • סף החסימה: resource.rules[].rateLimitOptions[].banThreshold
          • ספירה: resource.rules[].rateLimitOptions[].banThreshold.count
          • ‫Interval seconds: resource.rules[].rateLimitOptions[].banThreshold.intervalSec
        • משך ההרחקה בשניות: resource.rules[].rateLimitOptions[].banDurationSec
      • יעד ההפניה האוטומטית: resource.rules[].redirectTarget
      • מספר הכלל: resource.rules[].ruleNumber
    • הגדרות של הגנה דינמית: resource.adaptiveProtectionConfig
      • הגדרת הגנה מפני מתקפות DDoS בשכבה 7: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig
        • הפעלה: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.enable
        • חשיפת הכלל: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.ruleVisibility
        • הגדרות סף: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[]
          • שם: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].name
          • סף עומס לפריסה אוטומטית: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].autoDeployLoadThreshold
          • סף הביטחון לפריסה אוטומטית: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].autoDeployConfidenceThreshold
          • פריסה אוטומטית של ערך סף בסיסי מושפע: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].autoDeployImpactedBaselineThreshold
          • מספר השניות עד לפריסה אוטומטית: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].autoDeployExpirationSec
          • הסף לטעינת זיהוי: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].detectionLoadThreshold
          • מספר QPS מוחלט של זיהוי: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].detectionAbsoluteQps
          • זיהוי ביחס לערך הבסיס של QPS: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].detectionRelativeToBaselineQps
          • הגדרות של רמת הפירוט של התנועה: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].trafficGranularityConfigs[]
            • סוג: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].trafficGranularityConfigs[].type
            • ערך: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].trafficGranularityConfigs[].value
            • מפעילים כל ערך ייחודי: resource.adaptiveProtectionConfig.layer7DdosDefenseConfig.thresholdConfigs[].trafficGranularityConfigs[].enableEachUniqueValue
      • הגדרת פריסה אוטומטית: resource.adaptiveProtectionConfig.autoDeployConfig
        • סף הטעינה: resource.adaptiveProtectionConfig.autoDeployConfig.loadThreshold
        • סף ביטחון: resource.adaptiveProtectionConfig.autoDeployConfig.confidenceThreshold
        • סף בסיסי שהושפע: resource.adaptiveProtectionConfig.autoDeployConfig.impactedBaselineThreshold
        • שניות עד התפוגה: resource.adaptiveProtectionConfig.autoDeployConfig.expirationSec
    • הגדרות מתקדמות: resource.advancedOptionsConfig
      • ניתוח JSON: resource.advancedOptionsConfig.jsonParsing
      • הגדרות אישיות ב-JSON: resource.advancedOptionsConfig.jsonCustomConfig
        • סוגי תוכן: resource.advancedOptionsConfig.jsonCustomConfig.contentTypes[]
      • רמת היומן: resource.advancedOptionsConfig.logLevel
      • כותרות בקשה של כתובת IP של משתמש: resource.advancedOptionsConfig.userIpRequestHeaders[]
    • הגדרת הגנה מפני DDoS: resource.ddosProtectionConfig
      • הגנה מפני DDoS: resource.ddosProtectionConfig.ddosProtection
    • ‫reCAPTCHA options config: resource.recaptchaOptionsConfig
      • מפתח האתר להפניה אוטומטית: resource.recaptchaOptionsConfig.redirectSiteKey
    • סוג: resource.type
    • שדות שהוגדרו על ידי המשתמש: resource.userDefinedFields[]
      • שם: resource.userDefinedFields[].name
      • בסיס: resource.userDefinedFields[].base
      • הזחה: resource.userDefinedFields[].offset
      • גודל: resource.userDefinedFields[].size
      • מסכה: resource.userDefinedFields[].mask
  • רשת Edge Security Service: compute.googleapis.com/NetworkEdgeSecurityService
    • שם: resource.name
    • תיאור: resource.description
    • מדיניות אבטחה: resource.securityPolicy

הגדרת אילוצים מותאמים אישית

מגבלה בהתאמה אישית מוגדרת על ידי המשאבים, השיטות, התנאים והפעולות שנתמכים על ידי השירות שבו אתם אוכפים את מדיניות הארגון. התנאים להגבלות המותאמות אישית מוגדרים באמצעות Common Expression Language ‏ (CEL). למידע נוסף על יצירת תנאים באילוצים מותאמים אישית באמצעות CEL, ראו את הקטע על CEL במאמר יצירה וניהול של מדיניות הארגון.

לפני שמתחילים

  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:

    צריך לבחור את הכרטיסייה הרלוונטית לאופן שבו תכננתם להשתמש בדוגמאות בדף הזה:

    המסוף

    כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API, לא צריך להגדיר אימות. Google Cloud

    gcloud

    1. התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

      gcloud init

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

  • הגדרת אזור ותחום כברירת מחדל
  • REST

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

      התקינו את ה-CLI של Google Cloud.

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

* חשוב לוודא שיש לכם את מזהה הארגון.

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

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

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

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

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

כדי לנהל את מדיניות הארגון למשאבי Cloud Armor, נדרשות ההרשאות הבאות:

  • orgpolicy.constraints.list
  • orgpolicy.policies.create
  • orgpolicy.policies.delete
  • orgpolicy.policies.list
  • orgpolicy.policies.update
  • orgpolicy.policy.get
  • orgpolicy.policy.set

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

הגדרת אילוץ בהתאמה אישית

אפשר ליצור אילוץ בהתאמה אישית ולהגדיר אותו לשימוש במדיניות הארגון באמצעות מסוף Google Cloud או Google Cloud CLI.

המסוף

  1. במסוף Google Cloud , נכנסים לדף מדיניות הארגון.

    מעבר למדיניות הארגון

  2. לוחצים על Project picker (בורר הפרויקטים) בחלק העליון של הדף.

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

  4. לוחצים על Custom constraint (הגבלה מותאמת אישית).

  5. בתיבה שם לתצוגה, מזינים שם קל לקריאה לאילוץ. האורך המקסימלי של השדה הוא 200 תווים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע אישי רגיש בשמות של אילוצים, כי הם עלולים להיחשף בהודעות שגיאה.

  6. בתיבה מזהה אילוץ, מזינים את השם שרוצים לתת לאילוץ המותאם אישית החדש. אילוץ מותאם אישית חייב להתחיל ב-custom., ויכול לכלול רק אותיות גדולות, אותיות קטנות או מספרים. לדוגמה, custom.requireSecurityPolicyWithStandardJsonParsing. האורך המקסימלי של השדה הזה הוא 70 תווים, לא כולל הקידומת, לדוגמה, organizations/123456789/customConstraints/custom..

  7. בתיבה Description (תיאור), מזינים תיאור של האילוץ שיהיה קל להבין, שיוצג כהודעת שגיאה אם תהיה הפרה של המדיניות. האורך המקסימלי של השדה הוא 2,000 תווים.

  8. בתיבה Resource type, בוחרים את השם של משאב REST‏ Google Cloudשמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה, compute.googleapis.com/SecurityPolicy.

  9. בקטע שיטת אכיפה, בוחרים אם לאכוף את ההגבלה רק על שיטת REST CREATE או גם על שיטת REST CREATE וגם על שיטת UPDATE.

  10. כדי להגדיר תנאי, לוחצים על Edit condition.

    1. בחלונית Add condition, יוצרים תנאי CEL שמתייחס למשאב שירות נתמך. האורך המקסימלי של השדה הוא 1,000 תווים.

    2. לוחצים על Save.

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

  12. לוחצים על יצירת אילוץ.

אחרי שמזינים ערך בכל שדה, מופיעה משמאל הגדרת ה-YAML המקבילה למגבלה המותאמת אישית הזו.

gcloud

כדי ליצור אילוץ בהתאמה אישית באמצעות Google Cloud CLI, יוצרים קובץ YAML.

name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
resource_types: compute.googleapis.com/RESOURCE_NAME
method_types: METHOD1 METHOD2
condition: "CONDITION"
action_type: ACTION
display_name: DISPLAY_NAME
description: DESCRIPTION

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

  • ORGANIZATION_ID: מזהה הארגון, למשל 123456789.

  • CONSTRAINT_NAME: השם שרוצים לתת לאילוץ המותאם אישית החדש. אילוץ מותאם אישית חייב להתחיל ב-custom., ויכול לכלול רק אותיות רישיות, אותיות קטנות או מספרים. לדוגמה, custom.requireSecurityPolicyWithStandardJsonParsing. האורך המקסימלי של השדה הזה הוא 70 תווים, לא כולל הקידומת, לדוגמה, organizations/123456789/customConstraints/custom.

  • RESOURCE_NAME: השם (לא ה-URI) של משאב ה-REST של Compute Engine API שמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה, compute.googleapis.com/SecurityPolicy.

  • METHOD1,METHOD2,...: רשימה של methods מסוג RESTful שבהן ייאכף האילוץ. הערך יכול להיות CREATE או CREATE ו-UPDATE.

  • CONDITION: תנאי בשפת CEL שנכתב על סמך ייצוג של משאב שירות נתמך. האורך המקסימלי של השדה הוא 1,000 תווים. מידע נוסף על המשאבים שאפשר לכתוב תנאים לגביהם זמין במאמר בנושא משאבים נתמכים.

  • ACTION: הפעולה שתתבצע אם התנאי condition יתקיים. האפשרויות הן ALLOW או DENY.

  • DISPLAY_NAME: שם קריא לאנשים של האילוץ. האורך המקסימלי של השדה הוא 200 תווים.

  • DESCRIPTION: תיאור ידידותי למשתמש של האילוץ, שיוצג כהודעת שגיאה אם המדיניות תופר. האורך המקסימלי של השדה הוא 2,000 תווים.

מידע נוסף על יצירת אילוץ בהתאמה אישית זמין במאמר הגדרת אילוצים בהתאמה אישית.

המסוף

כדי ליצור אילוץ בהתאמה אישית:

  1. במסוף Google Cloud , נכנסים לדף מדיניות הארגון.

    מעבר למדיניות הארגון

  2. בבורר הפרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
  3. לוחצים על Custom constraint (הגבלה מותאמת אישית).
  4. בתיבה שם לתצוגה, מזינים שם שקל לקרוא אותו עבור האילוץ. השם הזה משמש בהודעות שגיאה, ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע אישי רגיש בשמות לתצוגה, כי השם הזה עשוי להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
  5. בתיבה Constraint ID (מזהה ההגבלה), מזינים את המזהה שרוצים להגדיר להגבלה החדשה בהתאמה אישית. אילוץ מותאם אישית יכול להכיל רק אותיות (כולל אותיות גדולות וקטנות) או מספרים, למשל custom.requireSecurityPolicyWithStandardJsonParsing. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.), לדוגמה, organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים (PII) או נתונים רגישים במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה.
  6. בתיבה Description, מזינים תיאור של האילוץ שכתוב בצורה שקריאה לאנשים. התיאור הזה משמש כהודעת שגיאה כשמתרחשת הפרה של המדיניות. לכלול פרטים על הסיבה להפרת המדיניות ואיך לפתור אותה. אל תכללו בתיאור פרטים אישיים מזהים (PII) או מידע אישי רגיש, כי הם עלולים להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 2,000 תווים.
  7. בתיבה Resource type, בוחרים את השם של משאב REST‏ Google Cloud שמכיל את האובייקט והשדה שרוצים להגביל – לדוגמה, container.googleapis.com/NodePool. רוב סוגי המשאבים תומכים בעד 20 אילוצים מותאמים אישית. אם תנסו ליצור עוד אילוצים בהתאמה אישית, הפעולה תיכשל.
  8. אפשר לאכוף את ההגבלה הזו רק בשיטת REST‏ CREATE.
  9. כדי לראות את השיטות הנתמכות לכל שירות, מחפשים את השירות ב שירותים שתומכים באילוצים בהתאמה אישית.

  10. כדי להגדיר תנאי, לוחצים על Edit condition.
    1. בחלונית Add condition, יוצרים תנאי CEL שמתייחס למשאב שירות נתמך, לדוגמה, resource.management.autoUpgrade == false. השדה הזה יכול להכיל עד 1,000 תווים. פרטים על השימוש ב-CEL זמינים במאמר בנושא Common Expression Language. מידע נוסף על משאבי השירות שאפשר להשתמש בהם באילוצים בהתאמה אישית זמין במאמר שירותים שתומכים באילוצים בהתאמה אישית.
    2. לוחצים על Save.
  11. בקטע פעולה, בוחרים אם לאשר או לדחות את השיטה שנבדקה אם התנאי מתקיים.
  12. הפעולה deny (דחייה) פירושה שהפעולה ליצירה או לעדכון של המשאב נחסמת אם התנאי מוערך כ-True.

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

  13. לוחצים על יצירת אילוץ.
  14. אחרי שמזינים ערך בכל שדה, מופיעה משמאל הגדרת ה-YAML המקבילה לאילוץ המותאם אישית הזה.

gcloud

  1. כדי ליצור אילוץ בהתאמה אישית, יוצרים קובץ YAML בפורמט הבא:
  2. name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME
    resourceTypes: RESOURCE_NAME
    methodTypes:
      - CREATE
    condition: "CONDITION"
    actionType: ACTION
    displayName: DISPLAY_NAME
    description: DESCRIPTION

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

    • ORGANIZATION_ID: מזהה הארגון, למשל 123456789.
    • CONSTRAINT_NAME: השם שרוצים לתת לאילוץ המותאם אישית החדש. אילוץ מותאם אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, למשל, custom.requireSecurityPolicyWithStandardJsonParsing. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.) – לדוגמה, organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים (PII) או נתונים רגישים במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה.
    • RESOURCE_NAME: השם מוגדר במלואו של המשאב Google Cloudשמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה, compute.googleapis.com/SecurityPolicy. רוב סוגי המשאבים תומכים בעד 20 אילוצים מותאמים אישית. אם תנסו ליצור עוד אילוצים בהתאמה אישית, הפעולה תיכשל.
    • methodTypes: שיטות REST שבהן האילוץ נאכף. הערך יכול להיות רק CREATE.
    • כדי לראות את השיטות הנתמכות לכל שירות, מחפשים את השירות ב שירותים שתומכים באילוצים בהתאמה אישית.

    • CONDITION: תנאי CEL שנכתב על סמך ייצוג של משאב שירות נתמך. השדה הזה יכול להכיל עד 1,000 תווים. לדוגמה, "resource.advancedOptionsConfig.jsonParsing != 'STANDARD'".
    • מידע נוסף על המשאבים שאפשר לכתוב תנאים לגביהם זמין במאמר משאבים נתמכים.

    • ACTION: הפעולה שיש לבצע אם התנאי condition מתקיים. הערך יכול להיות רק ALLOW.
    • הפעולה allow (אישור) אומרת שאם התנאי מקבל את הערך True, הפעולה ליצירה או לעדכון של המשאב מותרת. המשמעות היא שכל מקרה אחר, מלבד המקרה שמופיע במפורש בתנאי, ייחסם.

    • DISPLAY_NAME: שם קריא לאנשים של האילוץ. השם הזה מופיע בהודעות שגיאה ויכול לשמש לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע אישי רגיש בשמות המוצגים, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
    • DESCRIPTION: תיאור ידידותי למשתמש של האילוץ שיוצג כהודעת שגיאה אם המדיניות תופר. השדה הזה יכול להכיל עד 2,000 תווים.
  3. אחרי שיוצרים קובץ YAML לאילוץ חדש בהתאמה אישית, צריך להגדיר אותו כדי שיהיה זמין למדיניות הארגון בארגון. כדי להגדיר אילוץ בהתאמה אישית, משתמשים בפקודה gcloud org-policies set-custom-constraint:
  4. gcloud org-policies set-custom-constraint CONSTRAINT_PATH

    מחליפים את CONSTRAINT_PATH בנתיב המלא לקובץ האילוצים המותאמים אישית. לדוגמה, /home/user/customconstraint.yaml.

    אחרי שהפעולה הזו תושלם, האילוצים המותאמים אישית יהיו זמינים כמדיניות ארגונית ברשימת Google Cloud מדיניות הארגון.

  5. כדי לוודא שהאילוץ המותאם אישית קיים, משתמשים בפקודה gcloud org-policies list-custom-constraints:
  6. gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID

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

    מידע נוסף זמין במאמר בנושא צפייה במדיניות הארגון.

החלת אילוץ מותאם אישית

כדי לאכוף אילוץ, יוצרים מדיניות ארגון שמפנה אליו, ואז מחילים את מדיניות הארגון הזו על משאב Google Cloud .

המסוף

  1. במסוף Google Cloud , נכנסים לדף מדיניות הארגון.

    מעבר למדיניות הארגון

  2. בתפריט לבחירת פרויקט, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
  3. מהרשימה בדף מדיניות הארגון, בוחרים את האילוץ כדי לראות את הדף פרטי המדיניות של האילוץ הזה.
  4. כדי להגדיר את מדיניות הארגון עבור המשאב הזה, לוחצים על ניהול מדיניות.
  5. בדף עריכת מדיניות, בוחרים באפשרות במקום המדיניות של המשאב הראשי.
  6. לוחצים על Add a rule.
  7. בקטע Enforcement (אכיפה), בוחרים אם מדיניות הארגון הזו נאכפת או לא.
  8. אופציונלי: כדי להגדיר את מדיניות הארגון כתלויה בתג, לוחצים על הוספת תנאי. הערה: אם מוסיפים כלל מותנה למדיניות ארגון, צריך להוסיף לפחות כלל לא מותנה אחד, אחרת אי אפשר לשמור את המדיניות. מידע נוסף על מדיניות ארגונית עם תגים
  9. לוחצים על בדיקת שינויים כדי לדמות את ההשפעה של מדיניות הארגון. מידע נוסף זמין במאמר בדיקת שינויים במדיניות הארגון באמצעות סימולטור המדיניות.
  10. כדי לאכוף את המדיניות של הארגון במצב פרימטר לבדיקות, לוחצים על הגדרת המדיניות להרצת בדיקה. מידע נוסף זמין במאמר בנושא בדיקת מדיניות הארגון.
  11. אחרי שמוודאים שמדיניות הארגון במצב הרצה יבשה פועלת כמו שרוצים, לוחצים על הגדרת מדיניות כדי להגדיר את המדיניות הפעילה.

gcloud

  1. כדי ליצור מדיניות ארגונית עם כללים בוליאניים, יוצרים קובץ YAML של מדיניות שמפנה לאילוץ:
  2. name: projects/PROJECT_ID/policies/CONSTRAINT_NAME
    spec:
      rules:
      - enforce: true
    
    dryRunSpec:
      rules:
      - enforce: true

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

    • PROJECT_ID: הפרויקט שבו רוצים לאכוף את האילוץ.
    • CONSTRAINT_NAME: השם שהגדרתם לאילוץ המותאם אישית. לדוגמה, custom.requireSecurityPolicyWithStandardJsonParsing.
  3. כדי לאכוף את מדיניות הארגון במצב הרצה יבשה, מריצים את הפקודה הבאה עם הדגל dryRunSpec:
  4. gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec

    מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. יכולות לעבור עד 15 דקות עד שהמדיניות תיכנס לתוקף.

  5. אחרי שמוודאים שמדיניות הארגון במצב הרצה יבשה פועלת כמו שרוצים, מגדירים את המדיניות הפעילה באמצעות הפקודה org-policies set-policy והדגל spec:
  6. gcloud org-policies set-policy POLICY_PATH --update-mask=spec

    מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. יכולות לעבור עד 15 דקות עד שהמדיניות תיכנס לתוקף.

דוגמה: יצירת אילוץ שמחייב הפעלה של ניתוח JSON רגיל בכל מדיניות האבטחה

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

gcloud

  1. יוצרים קובץ אילוצים requireStandardJsonParsing.yaml עם הפרטים הבאים.

    name: organizations/ORGANIZATION_ID/customConstraints/custom.requireStandardJsonParsing
    resource_types: compute.googleapis.com/SecurityPolicy
    condition: "resource.advancedOptionsConfig.jsonParsing != 'STANDARD'"
    action_type: DENY
    method_types: [CREATE, UPDATE]
    display_name: Security policies must have standard JSON parsing enabled.

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

  2. מגדירים את האילוץ המותאם אישית.

    gcloud org-policies set-custom-constraint requireStandardJsonParsing.yaml
    
  3. יוצרים קובץ מדיניות requireStandardJsonParsing-policy.yaml עם הפרטים שמופיעים בדוגמה הבאה, ומחילים את האילוץ ברמת הפרויקט. אפשר להגדיר את האילוץ הזה גם ברמת הארגון או התיקייה.

        name: projects/PROJECT_ID/policies/custom.requireStandardJsonParsing
        spec:
          rules:
    enforce: true

    מחליפים את PROJECT_ID במזהה הפרויקט.

  4. אוכפים את המדיניות.

    gcloud org-policies set-policy requireStandardJsonParsing-policy.yaml
    
  5. כדי לבדוק את האילוץ, יוצרים מדיניות אבטחה בלי להגדיר את השדה של ניתוח ה-JSON.

    gcloud compute security-policies create my-policy \
        --type=CLOUD_ARMOR
    

    הפלט אמור להיראות כך:

    ERROR: (gcloud.compute.securityPolicies.create) Could not fetch resource:
    - Operation denied by custom org policy: [customConstraints/custom.requireStandardJsonParsing] : Security policies must have standard JSON parsing enabled.

תמחור

שירות מדיניות הארגון, כולל מדיניות ארגון מוגדרת מראש ומותאמת אישית, מוצע ללא תשלום.

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