מיפוי נקודות קצה ל-API של SIEM
נתמך ב:
Google SecOps
SIEM
במסמך הזה מפורטות נקודות קצה ל-API של SIEM מדור קודם (Backstory API כולל Customer Management API ו-Ingestion API) ונקודות הקצה המקבילות שלהן ב-Chronicle API המודרני.
הרשאה והאצלת סמכויות לשותפים
ב-Chronicle API, הממשק לניהול זהויות והרשאות גישה (IAM) מחליף את מפתחות ה-API והאסימונים הקודמים לבקרת גישה. כדי לגשת ישירות למכונה, צריך לבצע אימות באמצעות פרטי כניסה מסוג OAuth 2.0 לחשבון שירות או לחשבון ראשי של איחוד שירותי אימות הזהות של עומסי עבודה. לחשבון המשתמש הזה צריכים להיות תפקידי IAM הנדרשים בפרויקט שמארח את המכונה.
לשותפים, ההרשאה תלויה בבעלות על המשאב. הפרויקט שמארח את המשאב קובע אילו פרטי כניסה והרשאות IAM נדרשים לשותף. הגבלת הפעולות של הדייר לפרטי הכניסה שהוקצו לדייר תואמת לעיקרון האבטחה הבסיסי, לפיו שותפים לא יכולים לגשת לנתוני הדייר, לאחזר או לשנות אותם בלי הרשאה מפורשת שניתנה על ידי הדייר. בטבלה הבאה מוצגת השוואה בין הרשאת שותפים ב-Backstory API הקודם לבין Chronicle API:
| API | Methods | היקף המשאבים | הרשאה |
|---|---|---|---|
| Legacy Backstory API | /v1/partner/customer/* נקודות קצה (endpoints) |
כל קודי הלקוחות של השותף | השותפים שולחים קריאות לנקודות הקצה האלה ישירות באמצעות אסימוני השותפים או מפתחות ה-API שלהם. |
Chronicle API: TenantService |
CreateTenant, ListTenants וגם UpdateTenant |
מופע של השותף: projects/{partner_project}/locations/{location}/instances/{partner_instance}/tenants/* |
השותפים קוראים לשיטות האלה ישירות באמצעות חשבונות השירות או פרטי הכניסה שלהם, שיש להם הרשאות chronicle.googleapis.com/tenants.* בפרויקט של השותף. |
Chronicle API: שירותים אחרים, כמו InstanceService ו-ForwarderService |
GetInstance, UpdateInstance, GenerateForwarderFiles ושיטות אחרות ברמת הדייר |
מופע של הדייר: projects/{tenant_project}/locations/{location}/instances/{tenant_instance}/... |
פרטי הכניסה של השותף לבדם לא מאפשרים גישה לנתוני הדייר או שינוי שלהם. האדמין של הדייר צריך להקצות תפקידי IAM, כמו roles/chronicle.admin, roles/chronicle.viewer או תפקיד בהתאמה אישית, לחשבון השירות של השותף או לחשבון המשתמש של איחוד שירותי אימות הזהות של עומסי העבודה בפרויקט Google Cloud של הדייר. |
טבלת מיפוי של ה-API
| אזור התכונה | שיטת API מדור קודם | גרסת ה-API הקודמת | ה-Method ב-Chronicle API | הרשאת IAM נדרשת | מיפוי מפורט של בקשות ותגובות |
|---|---|---|---|---|---|
| BigQuery | UpdateBigQueryAccess |
v1 | ProvideBigQueryAccess | chronicle.googleapis.com/bigQueryAccesses.provide |
ProvideBigQueryAccess |
| CuratedRule | ListCuratedRuleDetections |
v2 | LegacySearchCuratedDetections | chronicle.googleapis.com/legacies.legacySearchCuratedDetections |
LegacySearchCuratedDetections |
| CuratedRule | ListCuratedRules |
v2 | ListCuratedRules | chronicle.googleapis.com/curatedRules.list |
ListCuratedRules |
| LegacyAlert | UpdateAlert |
v1 | LegacyUpdateAlert | chronicle.googleapis.com/legacies.legacyUpdateAlert |
LegacyUpdateAlert |
| LegacyAlert | CreateSoarAlert |
v1 | LegacyCreateSoarAlert | chronicle.googleapis.com/legacies.legacyCreateSoarAlert |
LegacyCreateSoarAlert |
| גודל אות | CreateOrUpdateCase |
v1 | LegacyCreateOrUpdateCase | chronicle.googleapis.com/legacies.legacyCreateOrUpdateCase |
LegacyCreateOrUpdateCase |
| ייצוא נתונים | CancelDataExport |
v1 | CancelDataExport | chronicle.googleapis.com/dataExports.cancel |
CancelDataExport |
| ייצוא נתונים | CreateDataExport |
v1 | CreateDataExport | chronicle.googleapis.com/dataExports.create |
CreateDataExport |
| ייצוא נתונים | GetDataExport |
v1 | GetDataExport | chronicle.googleapis.com/dataExports.get |
GetDataExport |
| ייצוא נתונים | ListAvailableLogTypes |
v1 | לא נתמך | — | — |
| DataTap | CreateDataTap |
v1 | CreateDataTap | chronicle.googleapis.com/dataTaps.create |
CreateDataTap |
| DataTap | DeleteDataTap |
v1 | DeleteDataTap | chronicle.googleapis.com/dataTaps.delete |
DeleteDataTap |
| DataTap | GetDataTap |
v1 | GetDataTap | chronicle.googleapis.com/dataTaps.get |
GetDataTap |
| DataTap | ListDataTaps |
v1 | ListDataTaps | chronicle.googleapis.com/dataTaps.list |
ListDataTaps |
| DataTap | UpdateDataTap |
v1 | UpdateDataTap | chronicle.googleapis.com/dataTaps.update |
UpdateDataTap |
| עדכונים | CreateFeed |
v1 | CreateFeed | chronicle.googleapis.com/feeds.create |
CreateFeed |
| עדכונים | DeleteFeed |
v1 | DeleteFeed | chronicle.googleapis.com/feeds.delete |
DeleteFeed |
| עדכונים | DisableFeed |
v1 | DisableFeed | chronicle.googleapis.com/feeds.disable |
DisableFeed |
| עדכונים | EnableFeed |
v1 | EnableFeed | chronicle.googleapis.com/feeds.enable |
EnableFeed |
| עדכונים | FetchFeedServiceAccount |
v1 | FetchServiceAccountForCustomer | chronicle.googleapis.com/feedServiceAccounts.fetch |
FetchServiceAccountForCustomer |
| עדכונים | GetFeed |
v1 | GetFeed | chronicle.googleapis.com/feeds.get |
GetFeed |
| עדכונים | GetFeedSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| עדכונים | GetLogTypeSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| עדכונים | ListFeeds |
v1 | ListFeeds | chronicle.googleapis.com/feeds.list |
ListFeeds |
| עדכונים | ListFeedSourceTypeSchemas |
v1 | ListFeedSourceTypeSchemas | chronicle.googleapis.com/feedSourceTypeSchemas.list |
ListFeedSourceTypeSchemas |
| עדכונים | ListLogTypeSchemas |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| עדכונים | UpdateFeed |
v1 | UpdateFeed | chronicle.googleapis.com/feeds.update |
UpdateFeed |
| תוכנת Forwarder | CreateForwarder |
v2 | CreateForwarder | chronicle.googleapis.com/forwarders.create |
CreateForwarder |
| תוכנת Forwarder | GetForwarder |
v2 | GetForwarder | chronicle.googleapis.com/forwarders.get |
GetForwarder |
| תוכנת Forwarder | ListForwarders |
v2 | ListForwarders | chronicle.googleapis.com/forwarders.list |
ListForwarders |
| תוכנת Forwarder | UpdateForwarder |
v2 | UpdateForwarder | chronicle.googleapis.com/forwarders.update |
UpdateForwarder |
| תוכנת Forwarder | DeleteForwarder |
v2 | DeleteForwarder | chronicle.googleapis.com/forwarders.delete |
DeleteForwarder |
| תוכנת Forwarder | GenerateForwarderFiles |
v2 | GenerateForwarderFiles | chronicle.googleapis.com/forwarders.generateFiles |
— |
| תוכנת Forwarder | CreateCollector |
v2 | CreateCollector | chronicle.googleapis.com/collectors.create |
CreateCollector |
| תוכנת Forwarder | GetCollector |
v2 | GetCollector | chronicle.googleapis.com/collectors.get |
GetCollector |
| תוכנת Forwarder | ListCollectors |
v2 | ListCollectors | chronicle.googleapis.com/collectors.list |
ListCollectors |
| תוכנת Forwarder | UpdateCollector |
v2 | UpdateCollector | chronicle.googleapis.com/collectors.update |
UpdateCollector |
| תוכנת Forwarder | DeleteCollector |
v2 | DeleteCollector | chronicle.googleapis.com/collectors.delete |
DeleteCollector |
| מנתח | ArchiveCbnParser |
v1 | DeactivateParser | chronicle.googleapis.com/parsers.deactivate |
DeactivateParser |
| מנתח | CreateCbnParser |
v1 | CreateParser | chronicle.googleapis.com/parsers.create |
CreateParser |
| מנתח | GetCbnParser |
v1 | GetParser | chronicle.googleapis.com/parsers.get |
GetParser |
| מנתח | ListCbnParserHistory |
v1 | ListParsers | chronicle.googleapis.com/parsers.list |
ListParsers |
| מנתח | ListCbnParsers |
v1 | ListParsers | chronicle.googleapis.com/parsers.list |
ListParsers |
| מנתח | RetrieveSampleLogs |
v1 | ListLogs | chronicle.googleapis.com/logs.list |
ListLogs |
| מנתח | ValidateCbnParser |
v1 | CreateParser | chronicle.googleapis.com/parsers.create |
CreateParser |
| שותף | CreateCustomer |
v1 | CreateTenant | chronicle.googleapis.com/tenants.create |
CreateTenant |
| שותף | GetCustomer |
v1 | GetInstance | chronicle.googleapis.com/instances.get |
GetInstance |
| שותף | GetForwarderConfigs |
v1 | GenerateForwarderFiles | chronicle.googleapis.com/forwarders.generate |
GenerateForwarderFiles |
| שותף | ListCustomersOfPartner |
v1 | ListTenants | chronicle.googleapis.com/tenants.list |
ListTenants |
| שותף | SetAuthVersion |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| שותף | SetComplianceRequirements |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| שותף | SetUIState |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| שותף | SetWorkforcePoolProvider |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| ReferenceList | CreateReferenceList |
v2 | CreateReferenceList | chronicle.googleapis.com/referenceLists.create |
CreateReferenceList |
| ReferenceList | VerifyReferenceList |
v2 | VerifyReferenceList | chronicle.googleapis.com/referenceLists.verifyReferenceList |
VerifyReferenceList |
| ReferenceList | GetReferenceList |
v2 | GetReferenceList | chronicle.googleapis.com/referenceLists.get |
GetReferenceList |
| ReferenceList | ListReferenceLists |
v2 | ListReferenceLists | chronicle.googleapis.com/referenceLists.list |
ListReferenceLists |
| ReferenceList | UpdateReferenceList |
v2 | UpdateReferenceList | chronicle.googleapis.com/referenceLists.update |
UpdateReferenceList |
| Retrohunt | RunRetrohunt |
v2 | CreateRetrohunt | chronicle.googleapis.com/retrohunts.create |
CreateRetrohunt |
| Retrohunt | ListRetrohunts |
v2 | ListRetrohunts | chronicle.googleapis.com/retrohunts.list |
ListRetrohunts |
| Retrohunt | GetRetrohunt |
v2 | GetRetrohunt | chronicle.googleapis.com/retrohunts.get |
GetRetrohunt |
| Retrohunt | CancelRetrohunt |
v2 | CancelOperation | chronicle.googleapis.com/operations.cancel |
— |
| Retrohunt | WaitRetrohunt |
v2 | GetOperation | chronicle.googleapis.com/operations.get |
— |
| כלל | GetRule |
v2 | GetRule | chronicle.googleapis.com/rules.get |
GetRule |
| כלל | CreateRule |
v2 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| כלל | VerifyRule |
v2 | VerifyRuleText | chronicle.googleapis.com/rules.verifyRuleText |
VerifyRuleText |
| כלל | ListRules |
v2 | ListRules | chronicle.googleapis.com/rules.list |
ListRules |
| כלל | DeleteRule |
v2 | DeleteRule | chronicle.googleapis.com/rules.delete |
DeleteRule |
| כלל | ArchiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| כלל | UnarchiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| כלל | EnableLiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| כלל | DisableLiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| כלל | ListRuleVersions |
v2 | ListRuleVersions | chronicle.googleapis.com/ruleVersions.list |
— |
| כלל | CreateRuleVersion |
v2 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| כלל | EnableAlerting |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| כלל | DisableAlerting |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| כלל | ListDetections |
v2 | LegacySearchDetections | chronicle.googleapis.com/legacies.legacySearchDetections |
LegacySearchDetections |
| כלל | GetDetection |
v2 | LegacyGetDetection | chronicle.googleapis.com/legacies.legacyGetDetection |
LegacyGetDetection |
| כלל | StreamDetectionAlerts |
v2 | LegacyStreamDetectionAlerts | chronicle.googleapis.com/legacies.legacyStreamDetectionAlerts |
LegacyStreamDetectionAlerts |
| כלל | StreamTestRule |
v2 | LegacyTestRuleStreaming | chronicle.googleapis.com/legacies.legacyTestRuleStreaming |
LegacyTestRuleStreaming |
| כללים | CreateRule |
v1 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| כללים | GetRule |
v1 | GetRule | chronicle.googleapis.com/rules.get |
GetRule |
| כללים | UpdateRule |
v1 | UpdateRule | chronicle.googleapis.com/rules.update |
UpdateRule |
| כללים | DeleteRule |
v1 | DeleteRule | chronicle.googleapis.com/rules.delete |
DeleteRule |
| כללים | EnableLiveRule |
v1 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| כללים | ListResults |
v1 | LegacySearchRuleResults | chronicle.googleapis.com/legacies.legacySearchRuleResults |
LegacySearchRuleResults |
| כללים | ListRules |
v1 | ListRules | chronicle.googleapis.com/rules.list |
ListRules |
| כללים | RunRule |
v1 | CreateRetrohunt | chronicle.googleapis.com/retrohunts.create |
CreateRetrohunt |
| התראות | StreamDetections |
v1 | StreamDetectionAlerts | chronicle.googleapis.com/legacies.streamDetectionAlerts |
LegacyStreamDetectionAlerts |
| התראות | StreamRuleNotifications |
v1 | StreamDetectionAlerts | chronicle.googleapis.com/legacies.streamDetectionAlerts |
LegacyStreamDetectionAlerts |
| חיפוש | FetchUdmSearchView |
v1 | LegacyFetchUdmSearchView | chronicle.googleapis.com/legacies.legacyFetchUdmSearchView |
LegacyFetchUdmSearchView |
| חיפוש | GetEvent |
v1 | GetEvent | chronicle.googleapis.com/events.get |
GetEvent |
| יומן | GetLog |
v1 | GetLog | chronicle.googleapis.com/logs.get |
— |
| חיפוש | ListArtifactAssets |
v1 | FindRelatedEntities | chronicle.googleapis.com/entities.findRelated |
FindRelatedEntities |
| IOC | ListArtifactIoCDetails |
v1 | LegacySearchArtifactIoCDetails | chronicle.googleapis.com/legacies.legacySearchArtifactIoCDetails |
— |
| חיפוש | ListEvents |
v1 | LegacySearchAssetEvents | chronicle.googleapis.com/legacies.legacySearchAssetEvents |
LegacySearchAssetEvents |
| IOC | ListIoCs |
v1 | ListIocMatches | chronicle.googleapis.com/iocMatches.list |
— |
| חיפוש | SearchRawLogs |
v1 | SearchRawLogs | chronicle.googleapis.com/rawLogs.search |
SearchRawLogs |
| חיפוש | UdmSearch |
v1 | UdmSearch | chronicle.googleapis.com/events.udmSearch |
UdmSearch |
| חיפוש | ListAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| חיפוש | ListAssetAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| חיפוש | ListUserAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| התראות באותיות רישיות | GetUppercaseAlert |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings. הערה: ההטמעה של נקודת הקצה הוסרה מ-Backstory באמצע 2023. |
— |
| התראות באותיות רישיות | ListUppercaseAlerts |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings. הערה: ההטמעה של נקודת הקצה הוסרה מ-Backstory באמצע 2023. |
— |
| Ingestion API | BatchCreateEntities |
v2 | ImportEntities | chronicle.googleapis.com/entities.import |
ImportEntities |
| Ingestion API | BatchCreateEvents |
v2 | ImportStatsEvents | chronicle.googleapis.com/forwarders.importStatsEvents |
ImportStatsEvents |
| Ingestion API | BatchCreateLogs |
v2 | ImportLogs | chronicle.googleapis.com/logs.import |
ImportLogs |
| Ingestion API | BatchCreateUDMEvents |
v2 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| Ingestion API | BatchCreateUnstructuredLogEntries |
v2 | ImportLogs | chronicle.googleapis.com/logs.import |
— |
| Ingestion API | CreateEntities |
v1 | ImportEntities | chronicle.googleapis.com/entities.import |
ImportEntities |
| Ingestion API | CreateUDMEvents |
v1 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| Ingestion API | CreateUnstructuredLogEntries |
v1 | ImportLogs | chronicle.googleapis.com/logs.import |
ImportLogs |
| Ingestion API | ListLogTypes |
v1 | ListLogTypes | chronicle.googleapis.com/logTypes.list |
ListLogTypes |
| Ingestion API | ListSupportedLogTypes |
v2 | ListLogTypeSettings | chronicle.googleapis.com/logTypeSettings.list |
ListLogTypeSettings |
| Ingestion API | PutEvent |
v1 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| Ingestion API | PutLog |
v1 | UpdateLogType | chronicle.googleapis.com/logTypes.update |
UpdateLogType |
מידע נוסף על המעבר מ-Ingestion API ל-Chronicle API זמין במאמר שיטות הטמעה של Chronicle API.
נקודות קצה שהוסרו או שלא מופו
בטבלה הבאה מפורטות נקודות הקצה ל-API מדור קודם שלא ממופות ל-Chronicle API המודרני ומיועדות להסרה, יחד עם הנימוק העסקי:
| אזור התכונה | שיטת API מדור קודם | גרסת ה-API הקודמת | סיבה |
|---|---|---|---|
| RBAC מדור קודם | CreateSubject |
v1 | השדה הזה מיושן. בקרת הגישה מנוהלת עכשיו באמצעות תפקידי IAM מפורטים ב- Google Cloud . |
| RBAC מדור קודם | DeleteSubject |
v1 | השדה הזה מיושן. בקרת הגישה מנוהלת עכשיו באמצעות Google Cloud תפקידי IAM פרטניים. |
| RBAC מדור קודם | GetSubject |
v1 | השדה הזה מיושן. בקרת הגישה מנוהלת עכשיו באמצעות Google Cloud תפקידי IAM פרטניים. |
| RBAC מדור קודם | ListRoles |
v1 | השדה הזה מיושן. בקרת הגישה מנוהלת עכשיו באמצעות Google Cloud תפקידי IAM פרטניים. |
| RBAC מדור קודם | ListSubjects |
v1 | השדה הזה מיושן. בקרת הגישה מנוהלת עכשיו באמצעות Google Cloud תפקידי IAM פרטניים. |
| RBAC מדור קודם | UpdateRole |
v1 | השדה הזה מיושן. בקרת הגישה מנוהלת עכשיו באמצעות Google Cloud תפקידי IAM פרטניים. |
| RBAC מדור קודם | UpdateSubject |
v1 | השדה הזה מיושן. בקרת הגישה מנוהלת עכשיו באמצעות Google Cloud תפקידי IAM פרטניים. |
| מנתח | ListCbnParserErrors |
v1 | הוא כבר לא נדרש או זמין בתהליך העבודה המודרני של ניהול המנתחים. |
| שותף | EnableIAM |
v1 | התכונה כבר הוצאה משימוש והיא מטופלת באמצעות מנגנוני Google Cloud רגילים. |
| שותף | GenerateIamMigrationCommands |
v1 | התכונה כבר הוצאה משימוש והיא מיותרת בארכיטקטורה המודרנית. |
| שותף | GenerateIdPMetadata |
v1 | מיותר בארכיטקטורה המודרנית שמשולבת ב- Google Cloud. |
| שותף | GetIngestionFilter |
v1 | מיותר בארכיטקטורה המשולבת המודרנית של Google Cloud. |
| שותף | SetGCPProjectLink |
v1 | מיותר בארכיטקטורה המשולבת המודרנית של Google Cloud. |
| התראות באותיות רישיות | CreateCorrespondence |
v1 | התכונה כבר הוצאה משימוש. |
הבעיה עדיין לא נפתרה? קבלת תשובות מחברי הקהילה וממומחי Google SecOps.