באמצעות Security Command Center API אפשר לנהל באופן פרוגרמטי סימני אבטחה בנכסים ובממצאים. סימני אבטחה הם הערות שניתנות להתאמה אישית, שעוזרות להוסיף הקשר עסקי למשאבים בענן כדי לייעל את תהליכי המיון, הסינון והדיווח.
אפשר להוסיף או לעדכן סימני אבטחה רק בנכסים שנתמכים ב-Security Command Center. לרשימה של הנכסים הנתמכים, ראו סוגי הנכסים הנתמכים ב-Security Command Center.
לפני שמתחילים
כדי לעבוד עם סימוני אבטחה, צריך להגדיר חשבון שירות ו-SDK.
כדי להוסיף או לשנות סימני אבטחה, צריך להיות לכם תפקיד בניהול זהויות והרשאות גישה (IAM) שכולל הרשאות לסוג הסימן שבו אתם רוצים להשתמש:
- סימני נכסים: כתיבת סימני אבטחה של נכסים,
securitycenter.assetSecurityMarksWriter - סימון ממצאים: כתיבת סימני אבטחה לממצאים,
securitycenter.findingSecurityMarksWriter
למידע נוסף על תפקידי IAM ב-Security Command Center, קראו את המאמר בקרת גישה. במאמרים הוספת הערות לממצאים באמצעות סימוני אבטחה והוספת הערות לנכסים באמצעות סימוני אבטחה מוסבר איך להשתמש ביעילות בסימוני אבטחה.
הוספה או עדכון של סימני אבטחה בנכסים
כשמשתמשים ב-Security Command Center API, הוספה ועדכון של סימני אבטחה הן אותה פעולה. בדוגמה הזו מוסבר איך להוסיף סימני אבטחה לצמדי המפתח/ערך (key_a, value_a) ו-(key_b, value_b).
הקוד הבא משתמש במסכות שדות כדי לוודא שרק הערכים האלה יעודכנו. אם לא מספקים מסכות שדות, כל סימני האבטחה נמחקים לפני שמוסיפים את המפתחות והערכים שצוינו.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --security-marks=SECURITY_MARKS \ --update-mask=UPDATE_MASK
מחליפים את מה שכתוב בשדות הבאים:
-
ASSET_ID: הנכס שרוצים לעדכן. -
PARENT: הרמה בהיררכיית המשאבים שבה נמצא הנכס. אפשר להשתמש ב-organization, ב-folderאו ב-project. -
PARENT_ID: המזהה המספרי של הארגון, התיקייה או הפרויקט ברמה שמעל, או המזהה האלפאנומרי של הפרויקט ברמה שמעל. LOCATION: המיקום ב-Security Command Center שבו רוצים לעדכן את סימן האבטחה של הנכס. אם מיקום אחסון הנתונים מופעל, משתמשים ב-eu, ב-saאו ב-us. אחרת, משתמשים בערךglobal.-
SECURITY_MARKS: צמדים של מפתח/ערך שמופרדים בפסיקים ומייצגים את סימני האבטחה והערכים שלהם, לדוגמהkey_a=value_a,key_b=value_b. -
UPDATE_MASK: רשימה מופרדת בפסיקים של שדות סימני אבטחה שצריך לעדכן בנכס, לדוגמהmarks.key_a,marks.key_b.
המשך
Python
במאמר ניהול כללי מדיניות מוסבר על סימוני נכסים ייעודיים לגלאים של Security Health Analytics.
מחיקת סימני אבטחה בנכסים
כדי למחוק סימני אבטחה ספציפיים, צריך לבצע פעולה דומה להוספה או לעדכון שלהם, ובאופן ספציפי להפעיל עדכון עם מסכת שדה אבל בלי ערך תואם. בדוגמה הזו, סימני האבטחה עם המפתחות key_a ו-key_b נמחקים.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --update-mask=UPDATE_MASK
-
ASSET_ID: הנכס שרוצים לעדכן. -
PARENT: הרמה בהיררכיית המשאבים שבה נמצא הנכס. אפשר להשתמש ב-organization, ב-folderאו ב-project. -
PARENT_ID: המזהה המספרי של הארגון, התיקייה או הפרויקט ברמה שמעל, או המזהה האלפאנומרי של הפרויקט ברמה שמעל. LOCATION: המיקום ב-Security Command Center שבו רוצים למחוק סימן אבטחה מנכס. אם מיקום אחסון הנתונים מופעל, משתמשים ב-eu, ב-saאו ב-us. אחרת, משתמשים בערךglobal.-
UPDATE_MASK: רשימה מופרדת בפסיקים של שדות סימני אבטחה שצריך למחוק מהנכס, לדוגמהmarks.key_a,marks.key_b.
Node.js
Python
הוספה ומחיקה של סימני אבטחה באותה בקשה
אפשר לשלב באותה בקשה את השיטה להוספה ולעדכון של סימני אבטחה ואת השיטה למחיקה של סימני אבטחה. בדוגמה, key_a מעודכן ו-key_b נמחק.
gcloud
gcloud scc assets update-marks ASSET_ID \ --PARENT=PARENT_ID \ --location=LOCATION \ --update-mask=UPDATE_MASK
-
ASSET_ID: הנכס שרוצים לעדכן. -
PARENT: הרמה בהיררכיית המשאבים שבה נמצא הנכס. אפשר להשתמש ב-organization, ב-folderאו ב-project. -
PARENT_ID: המזהה המספרי של הארגון, התיקייה או הפרויקט ברמה שמעל, או המזהה האלפאנומרי של הפרויקט ברמה שמעל. LOCATION: המיקום של Security Command Center שבו מעדכנים ומוחקים את סימני האבטחה של הנכס. אם מיקום אחסון הנתונים מופעל, משתמשים ב-eu, ב-saאו ב-us. אחרת, משתמשים בערךglobal.-
SECURITY_MARKS: צמדים של מפתח/ערך שמופרדים בפסיקים ומייצגים את סימני האבטחה שרוצים לעדכן, לדוגמהkey_a=value_a. צריך להשמיט את סימני האבטחה שרוצים למחוק. -
UPDATE_MASK: רשימה מופרדת בפסיקים של שדות של סימני אבטחה שרוצים לעדכן או למחוק, לדוגמהmarks.key_a,marks.key_b.
Node.js
Python
הוספת סימני אבטחה לממצאים
התהליך של הוספה, עדכון ומחיקה של סימני אבטחה בממצאים זהה לתהליך של עדכון סימני אבטחה בנכסים. השינוי היחיד הוא שם המשאב שמשמש בקריאה ל-API. במקום משאב של נכס, אתם מספקים שם של משאב ממצא.
לדוגמה, כדי לעדכן סימני אבטחה בממצא, משתמשים בקוד הבא:
gcloud
gcloud scc findings update-marks FINDING_NAME \ --PARENT=PARENT_ID \ --location=LOCATION \ --source=SOURCE_ID \ --security-marks=SECURITY_MARKS \ --update-mask=UPDATE_MASK
מחליפים את מה שכתוב בשדות הבאים:
-
FINDING_NAME: הממצא שרוצים לעדכן. -
PARENT: הרמה בהיררכיית המשאבים שבה נמצא הממצא. אפשר להשתמש ב-organization, ב-folderאו ב-project. -
PARENT_ID: המזהה המספרי של הארגון, התיקייה או הפרויקט ברמה שמעל, או המזהה האלפאנומרי של הפרויקט ברמה שמעל. -
LOCATION: המיקום ב-Security Command Center שבו רוצים לעדכן את סימן האבטחה בממצא. אם מיקום אחסון הנתונים מופעל, משתמשים ב-eu, ב-saאו ב-us. אחרת, משתמשים בערךglobal. -
SOURCE_ID: מזהה המקור. -
SECURITY_MARKS: צמדים של מפתח/ערך שמופרדים בפסיקים ומייצגים את סימני האבטחה והערכים שלהם, לדוגמהkey_a=value_a,key_b=value_b. -
UPDATE_MASK: רשימה מופרדת בפסיקים של שדות סימני אבטחה שצריך לעדכן בנכס, לדוגמהmarks.key_a,marks.key_b.
Java
Node.js
Python
סימני האבטחה מעובדים במהלך סריקות באצווה – שפועלות פעמיים ביום ב-Security Command Center Premium וב-Enterprise, ופעם ביומיים ב-Security Command Center Standard – ולא בזמן אמת. יכול להיות עיכוב של 12 עד 24 שעות לפני שסימני האבטחה יעובדו ויופעלו כללי מדיניות האכיפה שפותרים או פותחים מחדש את הממצאים.
הצגת נכסים עם מסננים של סימני אבטחה
אחרי שמגדירים סימני אבטחה לנכס, אפשר להשתמש בהם בארגומנט filter בקריאה ל-API של ListAssets. לדוגמה, כדי לשלוח שאילתה על כל הנכסים שבהם key_a = value_a, משתמשים בקוד הבא:
gcloud
# ORGANIZATION=12344321 FILTER="security_marks.marks.key_a = \"value_a\"" gcloud scc assets list $ORGANIZATION \ --filter="$FILTER"
המשך
Java
Node.js
Python
הצגת ממצאים עם מסננים של סימני אבטחה
אחרי שמגדירים סימני אבטחה בממצא, אפשר להשתמש בהם בארגומנט המסנן בקריאה ל-API של ListFindings. לדוגמה, כדי לשלוח שאילתה על כל הנכסים שבהם key_a != value_a, משתמשים בקוד הבא:
gcloud
gcloud scc findings list PARENT/PARENT_ID \ --location=LOCATION \ --source=SOURCE_ID \ --filter=FILTER
-
PARENT: הרמה בהיררכיית המשאבים שבה נמצא הממצא. אפשר להשתמש ב-organizations, ב-foldersאו ב-projects. -
PARENT_ID: המזהה המספרי של הארגון, התיקייה או הפרויקט ברמה שמעל, או המזהה האלפאנומרי של הפרויקט ברמה שמעל. LOCATION: המיקום ב-Security Command Center שבו רוצים להציג את הממצאים. אם הפעלתם את מיקום אחסון הנתונים, השתמשו בערךeu,saאוus. אחרת, השתמשו בערךglobal.-
SOURCE_ID: מזהה המקור. -
FILTER: המסנן שרוצים להחיל על הממצאים. לדוגמה, כדי להחריג ממצאים עם סימן האבטחהkey_a=value_a, משתמשים ב-"NOT security_marks.marks.key_a=\"value_a\""