SIEM API-Endpunktzuordnung
Unterstützt in:
Google SecOps
SIEM
In diesem Dokument werden Legacy-SIEM-API-Endpunkte (Backstory API, einschließlich Customer Management API und Ingestion API) den entsprechenden modernen Chronicle API-Endpunkten zugeordnet.
Autorisierung und Partnerdelegierung
In der Chronicle API ersetzt Identity and Access Management (IAM) die Legacy-API-Schlüssel und -Tokens für die Zugriffssteuerung. Wenn Sie direkt auf eine Instanz zugreifen möchten, authentifizieren Sie sich mit OAuth 2.0-Anmeldedaten für ein Dienstkonto oder ein Workload Identity-Föderationshauptkonto. Dieses Hauptkonto muss die erforderlichen IAM-Rollen in dem Projekt haben, in dem die Instanz gehostet wird.
Bei Partnern hängt die Autorisierung vom Eigentum an der Ressource ab. Das Projekt, in dem eine Ressource gehostet wird, bestimmt, welche Anmeldedaten und IAM-Berechtigungen ein Partner benötigt. Die Beschränkung von Mandantenvorgängen auf vom Mandanten delegierte Anmeldedaten entspricht dem grundlegenden Sicherheitsprinzip, dass Partner ohne ausdrückliche Genehmigung des Mandanten nicht auf Mandantendaten zugreifen, diese abrufen oder ändern können. In der folgenden Tabelle wird die Partnerautorisierung in der Legacy-Backstory API und der Chronicle API verglichen:
| API | Methoden | Ressourcenbereich | Autorisierung |
|---|---|---|---|
| Legacy Backstory API | /v1/partner/customer/* Endpunkte |
Alle Kundencodes des Partners | Partner rufen diese Endpunkte direkt mit ihren eigenen Partner-Tokens oder API-Schlüsseln auf. |
Chronicle API: TenantService |
CreateTenant, ListTenants und UpdateTenant |
Instanz des Partners: projects/{partner_project}/locations/{location}/instances/{partner_instance}/tenants/* |
Partner rufen diese Methoden direkt mit ihren eigenen Dienstkonten oder Anmeldedaten auf, die im Partnerprojekt die Berechtigungen chronicle.googleapis.com/tenants.* haben. |
Chronicle API: andere Dienste wie InstanceService und ForwarderService |
GetInstance, UpdateInstance, GenerateForwarderFiles und andere mandantenspezifische Methoden |
Mandanteninstanz: projects/{tenant_project}/locations/{location}/instances/{tenant_instance}/... |
Mit Partneranmeldedaten allein kann nicht auf Mandantendaten zugegriffen oder diese geändert werden. Der Mandantenadministrator muss dem Dienstkonto oder dem Hauptkonto der Workload Identity-Föderation des Partners im Google Cloud -Projekt des Mandanten IAM-Rollen wie roles/chronicle.admin, roles/chronicle.viewer oder eine benutzerdefinierte Rolle zuweisen. |
API-Zuordnungstabelle
| Funktionsbereich | Legacy-API-Methode | Legacy-API-Version | Chronicle API-Methode | Erforderliche IAM-Berechtigung | Detaillierte Anfrage- und Antwortzuordnung |
|---|---|---|---|---|---|
| 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 |
| Fall | CreateOrUpdateCase |
v1 | LegacyCreateOrUpdateCase | chronicle.googleapis.com/legacies.legacyCreateOrUpdateCase |
LegacyCreateOrUpdateCase |
| Datenexport | CancelDataExport |
v1 | CancelDataExport | chronicle.googleapis.com/dataExports.cancel |
CancelDataExport |
| Datenexport | CreateDataExport |
v1 | CreateDataExport | chronicle.googleapis.com/dataExports.create |
CreateDataExport |
| Datenexport | GetDataExport |
v1 | GetDataExport | chronicle.googleapis.com/dataExports.get |
GetDataExport |
| Datenexport | ListAvailableLogTypes |
v1 | Nicht unterstützt | – | – |
| 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 |
| Feeds | CreateFeed |
v1 | CreateFeed | chronicle.googleapis.com/feeds.create |
CreateFeed |
| Feeds | DeleteFeed |
v1 | DeleteFeed | chronicle.googleapis.com/feeds.delete |
DeleteFeed |
| Feeds | DisableFeed |
v1 | DisableFeed | chronicle.googleapis.com/feeds.disable |
DisableFeed |
| Feeds | EnableFeed |
v1 | EnableFeed | chronicle.googleapis.com/feeds.enable |
EnableFeed |
| Feeds | FetchFeedServiceAccount |
v1 | FetchServiceAccountForCustomer | chronicle.googleapis.com/feedServiceAccounts.fetch |
FetchServiceAccountForCustomer |
| Feeds | GetFeed |
v1 | GetFeed | chronicle.googleapis.com/feeds.get |
GetFeed |
| Feeds | GetFeedSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Feeds | GetLogTypeSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Feeds | ListFeeds |
v1 | ListFeeds | chronicle.googleapis.com/feeds.list |
ListFeeds |
| Feeds | ListFeedSourceTypeSchemas |
v1 | ListFeedSourceTypeSchemas | chronicle.googleapis.com/feedSourceTypeSchemas.list |
ListFeedSourceTypeSchemas |
| Feeds | ListLogTypeSchemas |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Feeds | 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 |
| Parser | ArchiveCbnParser |
v1 | DeactivateParser | chronicle.googleapis.com/parsers.deactivate |
DeactivateParser |
| Parser | CreateCbnParser |
v1 | CreateParser | chronicle.googleapis.com/parsers.create |
CreateParser |
| Parser | GetCbnParser |
v1 | GetParser | chronicle.googleapis.com/parsers.get |
GetParser |
| Parser | ListCbnParserHistory |
v1 | ListParsers | chronicle.googleapis.com/parsers.list |
ListParsers |
| Parser | ListCbnParsers |
v1 | ListParsers | chronicle.googleapis.com/parsers.list |
ListParsers |
| Parser | RetrieveSampleLogs |
v1 | ListLogs | chronicle.googleapis.com/logs.list |
ListLogs |
| Parser | ValidateCbnParser |
v1 | CreateParser | chronicle.googleapis.com/parsers.create |
CreateParser |
| Partner | CreateCustomer |
v1 | CreateTenant | chronicle.googleapis.com/tenants.create |
CreateTenant |
| Partner | GetCustomer |
v1 | GetInstance | chronicle.googleapis.com/instances.get |
GetInstance |
| Partner | GetForwarderConfigs |
v1 | GenerateForwarderFiles | chronicle.googleapis.com/forwarders.generate |
GenerateForwarderFiles |
| Partner | ListCustomersOfPartner |
v1 | ListTenants | chronicle.googleapis.com/tenants.list |
ListTenants |
| Partner | SetAuthVersion |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Partner | SetComplianceRequirements |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Partner | SetUIState |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Partner | 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 |
– |
| Regel | GetRule |
v2 | GetRule | chronicle.googleapis.com/rules.get |
GetRule |
| Regel | CreateRule |
v2 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Regel | VerifyRule |
v2 | VerifyRuleText | chronicle.googleapis.com/rules.verifyRuleText |
VerifyRuleText |
| Regel | ListRules |
v2 | ListRules | chronicle.googleapis.com/rules.list |
ListRules |
| Regel | DeleteRule |
v2 | DeleteRule | chronicle.googleapis.com/rules.delete |
DeleteRule |
| Regel | ArchiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regel | UnarchiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regel | EnableLiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regel | DisableLiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regel | ListRuleVersions |
v2 | ListRuleVersions | chronicle.googleapis.com/ruleVersions.list |
– |
| Regel | CreateRuleVersion |
v2 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Regel | EnableAlerting |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regel | DisableAlerting |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regel | ListDetections |
v2 | LegacySearchDetections | chronicle.googleapis.com/legacies.legacySearchDetections |
LegacySearchDetections |
| Regel | GetDetection |
v2 | LegacyGetDetection | chronicle.googleapis.com/legacies.legacyGetDetection |
LegacyGetDetection |
| Regel | StreamDetectionAlerts |
v2 | LegacyStreamDetectionAlerts | chronicle.googleapis.com/legacies.legacyStreamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Regel | StreamTestRule |
v2 | LegacyTestRuleStreaming | chronicle.googleapis.com/legacies.legacyTestRuleStreaming |
LegacyTestRuleStreaming |
| Regeln | CreateRule |
v1 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Regeln | GetRule |
v1 | GetRule | chronicle.googleapis.com/rules.get |
GetRule |
| Regeln | UpdateRule |
v1 | UpdateRule | chronicle.googleapis.com/rules.update |
UpdateRule |
| Regeln | DeleteRule |
v1 | DeleteRule | chronicle.googleapis.com/rules.delete |
DeleteRule |
| Regeln | EnableLiveRule |
v1 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regeln | ListResults |
v1 | LegacySearchRuleResults | chronicle.googleapis.com/legacies.legacySearchRuleResults |
LegacySearchRuleResults |
| Regeln | ListRules |
v1 | ListRules | chronicle.googleapis.com/rules.list |
ListRules |
| Regeln | RunRule |
v1 | CreateRetrohunt | chronicle.googleapis.com/retrohunts.create |
CreateRetrohunt |
| Benachrichtigungen | StreamDetections |
v1 | StreamDetectionAlerts | chronicle.googleapis.com/legacies.streamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Benachrichtigungen | StreamRuleNotifications |
v1 | StreamDetectionAlerts | chronicle.googleapis.com/legacies.streamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Suchen | FetchUdmSearchView |
v1 | LegacyFetchUdmSearchView | chronicle.googleapis.com/legacies.legacyFetchUdmSearchView |
LegacyFetchUdmSearchView |
| Suchen | GetEvent |
v1 | GetEvent | chronicle.googleapis.com/events.get |
GetEvent |
| Log | GetLog |
v1 | GetLog | chronicle.googleapis.com/logs.get |
– |
| Suchen | ListArtifactAssets |
v1 | FindRelatedEntities | chronicle.googleapis.com/entities.findRelated |
FindRelatedEntities |
| IOC | ListArtifactIoCDetails |
v1 | LegacySearchArtifactIoCDetails | chronicle.googleapis.com/legacies.legacySearchArtifactIoCDetails |
– |
| Suchen | ListEvents |
v1 | LegacySearchAssetEvents | chronicle.googleapis.com/legacies.legacySearchAssetEvents |
LegacySearchAssetEvents |
| IOC | ListIoCs |
v1 | ListIocMatches | chronicle.googleapis.com/iocMatches.list |
– |
| Suchen | SearchRawLogs |
v1 | SearchRawLogs | chronicle.googleapis.com/rawLogs.search |
SearchRawLogs |
| Suchen | UdmSearch |
v1 | UdmSearch | chronicle.googleapis.com/events.udmSearch |
UdmSearch |
| Suchen | ListAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Suchen | ListAssetAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Suchen | ListUserAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Warnungen in Großbuchstaben | GetUppercaseAlert |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings. Hinweis: Die Endpunktimplementierung wurde Mitte 2023 aus Backstory entfernt. |
– |
| Warnungen in Großbuchstaben | ListUppercaseAlerts |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings. Hinweis: Die Endpunktimplementierung wurde Mitte 2023 aus Backstory entfernt. |
– |
| 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 |
Weitere Informationen zur Migration von der Ingestion API zur Chronicle API finden Sie unter Chronicle API-Methoden für die Datenaufnahme.
Nicht zugeordnete und entfernte Endpunkte
In der folgenden Tabelle sind die Legacy-API-Endpunkte aufgeführt, die nicht der modernen Chronicle API zugeordnet sind und entfernt werden sollen, zusammen mit der geschäftlichen Begründung:
| Funktionsbereich | Legacy-API-Methode | Legacy-API-Version | Begründung |
|---|---|---|---|
| Legacy-RBAC | CreateSubject |
v1 | Veraltet; die Zugriffssteuerung wird jetzt über detaillierte Google Cloud IAM-Rollen geregelt. |
| Legacy-RBAC | DeleteSubject |
v1 | Veraltet; die Zugriffssteuerung wird jetzt über detaillierte Google Cloud IAM-Rollen geregelt. |
| Legacy-RBAC | GetSubject |
v1 | Veraltet; die Zugriffssteuerung wird jetzt über detaillierte Google Cloud IAM-Rollen geregelt. |
| Legacy-RBAC | ListRoles |
v1 | Veraltet; die Zugriffssteuerung wird jetzt über detaillierte Google Cloud IAM-Rollen geregelt. |
| Legacy-RBAC | ListSubjects |
v1 | Veraltet; die Zugriffssteuerung wird jetzt über detaillierte Google Cloud IAM-Rollen geregelt. |
| Legacy-RBAC | UpdateRole |
v1 | Veraltet; die Zugriffssteuerung wird jetzt über detaillierte Google Cloud IAM-Rollen geregelt. |
| Legacy-RBAC | UpdateSubject |
v1 | Veraltet; die Zugriffssteuerung wird jetzt über detaillierte Google Cloud IAM-Rollen geregelt. |
| Parser | ListCbnParserErrors |
v1 | Im modernen Parser-Verwaltungs-Workflow nicht mehr erforderlich oder verfügbar. |
| Partner | EnableIAM |
v1 | Die Funktion wurde bereits eingestellt und wird über Standard- Google Cloud -Mechanismen verarbeitet. |
| Partner | GenerateIamMigrationCommands |
v1 | Die Funktion wurde bereits eingestellt und ist in der modernen Architektur redundant. |
| Partner | GenerateIdPMetadata |
v1 | Redundant in der modernen, in Google Cloudintegrierten Architektur. |
| Partner | GetIngestionFilter |
v1 | Redundant in der modernen, in Google Cloudintegrierten Architektur. |
| Partner | SetGCPProjectLink |
v1 | Redundant in der modernen, in Google Cloudintegrierten Architektur. |
| Warnungen in Großbuchstaben | CreateCorrespondence |
v1 | Die Funktion wurde bereits eingestellt. |
Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten