SIEM-API-Endpunktzuordnung
Unterstützt in:
Google SecOps
SIEM
In diesem Dokument werden die alten 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 Hauptkonto der Workload Identity-Föderation. Dieses Hauptkonto muss die erforderlichen IAM-Rollen im Projekt haben, in dem die Instanz gehostet wird.
Bei Partnern hängt die Autorisierung von der Inhaberschaft der Ressource ab. Das Projekt, in dem eine Ressource gehostet wird, bestimmt, welche Anmeldedaten und IAM-Berechtigungen ein Partner benötigt. Die Einschränkung von Mandantenvorgängen auf mandantendelegierte Anmeldedaten entspricht dem grundlegenden Sicherheitsprinzip, dass Partner ohne die ausdrückliche Erlaubnis des Mandanten nicht auf Mandantendaten zugreifen, sie abrufen oder ändern dürfen. 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 |
Instanz des Mandanten: 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 des Partners oder dem Hauptkonto der Workload Identity-Föderation 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 |
– |
| Datenexport | CreateDataExport |
v1 | CreateDataExport | chronicle.googleapis.com/dataExports.create |
– |
| Datenexport | GetDataExport |
v1 | GetDataExport | chronicle.googleapis.com/dataExports.get |
– |
| Datenexport | 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 |
| 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 alten API-Endpunkte aufgeführt, die nicht der modernen Chronicle API zugeordnet sind und deren Entfernung geplant ist, sowie die geschäftliche Begründung:
| Funktionsbereich | Legacy-API-Methode | Legacy-API-Version | Begründung |
|---|---|---|---|
| Legacy-RBAC | CreateSubject |
v1 | Veraltet. Die Zugriffssteuerung unterliegt jetzt detaillierten Google Cloud IAM-Rollen. |
| Alte RBAC | DeleteSubject |
v1 | Veraltet; die Zugriffssteuerung wird jetzt über detaillierte Google Cloud IAM-Rollen geregelt. |
| Alte 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. |
| Alte RBAC | ListSubjects |
v1 | Veraltet. Die Zugriffssteuerung unterliegt jetzt detaillierten Google Cloud IAM-Rollen. |
| 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 | Nicht mehr erforderlich oder im modernen Workflow zur Parserverwaltung verfügbar. |
| Partner | EnableIAM |
v1 | Die Funktion wurde bereits eingestellt und wird über Standardmechanismen Google Cloud 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 Google Cloud-integrierten 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