בדיקה של מודולים מותאמים אישית ב-Security Health Analytics

בדף הזה מוסבר איך לבדוק מודולים בהתאמה אישית של Security Health Analytics במסוףGoogle Cloud , באמצעות העלאה של קובץ YAML שמכיל נתוני בדיקה.

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

כדי לבדוק מודולים בהתאמה אישית, צריך לעמוד בדרישות המוקדמות הבאות:

  • כל דרישות הקדם הכלליות שחלות על השימוש במודולים בהתאמה אישית של Security Health Analytics. הרשימה המלאה של הדרישות המוקדמות מופיעה במאמר שימוש במודולים בהתאמה אישית ב-Security Health Analytics.
  • לחשבון המשתמש שלכם צריך להיות תפקיד אחד או יותר בניהול הזהויות והרשאות הגישה (IAM) שמאפשר לכם לעבוד עם Security Command Center ועם מודולים בהתאמה אישית, וכולל גם את ההרשאה securitycentermanagement.securityhealthanalyticscustommodules.test. במאמר הרשאות IAM נדרשות מוסבר אילו הרשאות ותפקידים נדרשים כדי לעבוד עם מודולים בהתאמה אישית.
  • קריאות ל-API לבדיקת מודולים בהתאמה אישית כפופות למכסה. מידע נוסף זמין במאמר מכסות של מודולים בהתאמה אישית.

יצירת משאבי בדיקה בקובץ YAML

כדי לבדוק מודול בהתאמה אישית, מגדירים הגדרות משאבים מזויפות, הגדרות מדיניות מזויפות או את שתיהן בקובץ YAML.

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

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

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

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

הקובץ צריך להתחיל ב-testData: בשורה הראשונה, ואחריו הגדרה אחת או יותר של - asset.

testData:
- asset:
    resource: ARBITRARY_ASSET_NAME_1
    assetType: RESOURCE_TYPE_1
    resourceData:
      PROPERTIES_TO_TEST_1: PROPERTY_VALUE_1
        SUB_PROPERTY: SUB_PROPERTY_VALUE
      PROPERTIES_TO_TEST_2: PROPERTY_VALUE_2
- asset:
    resource: ARBITRARY_ASSET_NAME_2
    assetType: RESOURCE_TYPE_2
    iamPolicyData:
      PROPERTIES_TO_TEST_3: PROPERTY_VALUE_3
      PROPERTIES_TO_TEST_4: PROPERTY_VALUE_4

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

  • ‫ARBITRARY_ASSET_NAME_N: ערך שרירותי שמוצג בתוצאות הבדיקה כשהבדיקה מצליחה.
  • ‫RESOURCE_TYPE_N: סוג הנכס או המשאב שהמודול המותאם אישית בודק, שמצוין כשם הדומיין של נקודת הקצה של השירות ב-API ושם המשאב, לדוגמה cloudkms.googleapis.com/CryptoKey.
  • ‫PROPERTIES_TO_TEST_N: המאפיינים שמשמשים בלוגיקת הזיהוי של המודול בהתאמה אישית כדי להפעיל ממצא.
  • ‫PROPERTY_VALUE_N: ערך של המאפיין שמפעיל ממצא.
  • ‫SUB_PROPERTY: נכס משנה או נכס של משאב אחר, שמשאב המטרה מפנה אליו בהגדרת המשאב שלו.

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

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

הגדרה לדוגמה של משאב

בדוגמה הבאה של הגדרת משאב לבדיקה, נבדק מודול בהתאמה אישית שבודק אם המאפיין rotationPeriod של משאבי CryptoKey חורג מ-2592000 שניות (30 ימים). המאפיינים האחרים בהגדרה לא משמשים במודול בהתאמה אישית, אבל עדיין תואמים לסכימה של המשאב. כדי לראות את ההגדרה המלאה של המודול בהתאמה אישית שהדוגמה הזו בודקת, עיינו בקטע דוגמה להגדרה של מודול בהתאמה אישית.

testData:
- asset:
    resource: THE CRYPTOKEY TEST WAS SUCCESSFUL!
    assetType: cloudkms.googleapis.com/CryptoKey
    resourceData:
      nextRotationTime:  '2020-02-05T12:00:55.192645Z'
      primary:
        state: 'ENABLED'
      purpose: 'ENCRYPT_DECRYPT'
      rotationPeriod: '2592001s'

הגדרת מדיניות לדוגמה

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

testData:
- asset:
    resource: //cloudresourcemanager.googleapis.com/projects/fake-project
    assetType: cloudresourcemanager.googleapis.com/Project
    iamPolicyData:
      bindings:
      - role: "roles/viewer"
        members:
        - "serviceAccount:fake-service-account@compute-system."
        - "user:fake-email-account"

בדיקת מודול בהתאמה אישית

אתם יכולים לבדוק מודולים חדשים או קיימים בהתאמה אישית במסוףGoogle Cloud .

כדי לבדוק מודול בהתאמה אישית, פועלים לפי השלבים הבאים:

  1. בדף ההגדרות של Security Command Center, נכנסים לדף Modules של Security Health Analytics.

    מעבר אל Modules

  2. פותחים או יוצרים מודול מותאם אישית לבדיקה:

    • כדי ליצור מודול חדש בהתאמה אישית, לוחצים על Create module ופועלים לפי ההוראות במאמר יצירת מודולים בהתאמה אישית.
    • כדי לפתוח מודול מותאם אישית קיים, לוחצים על סמל העריכה () בקטע פעולות בצד שמאל של השורה של המודול שרוצים לבדוק.

  3. לוחצים על הכרטיסייה מודול בדיקה.

  4. בקטע Upload the YAML file, לוחצים על Browse כדי להעלות קובץ שמכיל נתוני נכסים לדוגמה. הבדיקה פועלת ברגע שמעלים את קובץ ה-YAML.

  5. בקטע תצוגה מקדימה של תוצאות הבדיקה, בודקים את התוצאות.

    • אם יש שגיאות תחביר או שגיאות אחרות בקובץ ה-YAML, מופיעה הודעת שגיאה צפה ליד החלק התחתון של דף הדפדפן.

    • אם הבדיקה מצליחה, היא מחזירה את הפרטים הבאים:

      • השם המוצג של המודול בהתאמה אישית.
      • השם השרירותי שציינתם במאפיין resource בקובץ נתוני הבדיקה.
      • הארגון, התיקייה או הפרויקט שבהם המודול בהתאמה אישית נוצר או ייווצר.

    תוצאות הבדיקה לא נשמרות או נכתבות ב-Security Command Center.

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