אתם יכולים להשתמש ב-Security Command Center API כדי ליצור ולעדכן מקורות אבטחה, וכך ליצור ממצאים. כשמוסיפים מקור, Security Command Center יוצר את המקורות המתאימים ומקצה להם את ההרשאות הרלוונטיות.
אפשר להקצות את תפקידי ה-IAM של Security Command Center ברמת הארגון, התיקייה או הפרויקט. היכולת שלכם להציג, לערוך, ליצור או לעדכן ממצאים, נכסים ומקורות אבטחה תלויה ברמת הגישה שקיבלתם. למידע נוסף על התפקידים ב-Security Command Center, ראו בקרת גישה.
לפני שמתחילים
לפני שמגדירים מקור, צריך לבצע אימות באמצעות Security Command Center API.
יצירת מקור
בדוגמה הזו מוסבר איך ליצור מקור עם שם תצוגה ותיאור ספציפיים שמשמשים ב-Security Command Center.
השרת מקצה באופן אוטומטי מזהה למקור.
REST
ב-API, שולחים בקשה ל-method organizations.sources.create. גוף הבקשה מכיל מופע של Source.
POST https://securitycenter.googleapis.com/v2/organizations/ORGANIZATION_ID/sources
{
"name": "SOURCE_NAME",
"description": "SOURCE_DESCRIPTION",
"displayName": "DISPLAY_NAME"
}
מחליפים את מה שכתוב בשדות הבאים:
-
ORGANIZATION_ID: מזהה הארגון. -
SOURCE_NAME: שם המקור. -
SOURCE_DESCRIPTION: תיאור של המקור (עד 1,024 תווים). -
DISPLAY_NAME: השם המוצג של המקור (בין תו אחד ל-64 תווים).
המשך
Java
Node.js
Python
המקור לא מופיע במסוף Security Command Center עד שהוא יוצר ממצאים. כדי לוודא שהמקור נוצר, פועלים לפי ההוראות במאמר קבלת מקור ספציפי.
עדכון מקור
אחרי שיוצרים מקור, אפשר לעדכן את השם המוצג והתיאור שלו. אפשר גם להשתמש במסכת שדה כדי לעדכן רק שדה אחד. בדוגמה הבאה נעשה שימוש במסכת שדות כדי לעדכן רק את השם המוצג, בלי לשנות את התיאור.
REST
ב-API, שולחים בקשה ל-method organizations.sources.patch.
גוף הבקשה מכיל מופע של Source.
PATCH https://securitycenter.googleapis.com/v2/organizations/ORGANIZATION_ID/sources/SOURCE_ID?updateMask=displayName -d
{
"description": "SOURCE_DESCRIPTION",
"displayName": "DISPLAY_NAME",
}
מחליפים את מה שכתוב בשדות הבאים:
-
ORGANIZATION_ID: מזהה הארגון. -
SOURCE_ID: מזהה המקור. כדי ללמוד איך למצוא מזהה מקור, ראו קבלת מזהה המקור. -
SOURCE_DESCRIPTION: תיאור של המקור (עד 1,024 תווים). -
DISPLAY_NAME: השם המוצג של המקור (בין תו אחד ל-64 תווים).
המשך
Java
Node.js
Python
קבלת מקור ספציפי
כדי לוודא שהמקור נוצר או עודכן כמו שצריך, שולחים שאילתה ל-Security Command Center עם שם המשאב המוחלט של המקור:
gcloud
gcloud scc sources describe ORGANIZATION_ID --source=SOURCE_ID
מחליפים את מה שכתוב בשדות הבאים:
-
ORGANIZATION_ID: מזהה הארגון. -
SOURCE_ID: מזהה המקור.
REST
ב-API, שולחים בקשה ל-method organizations.sources.get:
GET https://securitycenter.googleapis.com/v2/organizations/ORGANIZATION_ID/sources/SOURCE_ID
מחליפים את מה שכתוב בשדות הבאים:
-
ORGANIZATION_ID: מזהה הארגון. -
SOURCE_ID: מזהה המקור.
המשך
Java
Node.js
Python
מקורות של דפים עסקיים
ב-Security Command Center אפשר להציג רשימה של מקור ספציפי או של כל המקורות שזמינים בארגון:
REST
ב-API, שולחים בקשה ל-method organizations.sources.list:
GET https://securitycenter.googleapis.com/v2/organizations/ORGANIZATION_ID/sources
מחליפים את מה שכתוב בשדות הבאים:
-
ORGANIZATION_ID: מזהה הארגון.