במדריך הזה מוסבר איך להשתמש ב-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 תווים).
Go
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 תווים).
Go
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: מזהה המקור.
Go
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: מזהה הארגון.