מיפוי נקודות קצה ל-API של SIEM
נתמך ב:
Google SecOps
SIEM
במסמך הזה ממופות נקודות קצה מדור קודם ל-SIEM API (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 |
— |
| ייצוא נתונים | CreateDataExport |
v1 | CreateDataExport | chronicle.googleapis.com/dataExports.create |
— |
| ייצוא נתונים | GetDataExport |
v1 | GetDataExport | chronicle.googleapis.com/dataExports.get |
— |
| ייצוא נתונים | ListAvailableLogTypes |
v1 | FetchLogTypesAvailableForExport | chronicle.googleapis.com/dataExports.fetchAvailableLogTypes |
— |
| 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 |
| חיפוש רטרואקטיבי | RunRetrohunt |
v2 | CreateRetrohunt | chronicle.googleapis.com/retrohunts.create |
CreateRetrohunt |
| חיפוש רטרואקטיבי | 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 | המאמר הזה לא רלוונטי יותר. בקרת הגישה מנוהלת עכשיו באמצעות תפקידים מפורטים ב- Google Cloud IAM. |
| 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.