Mappage des points de terminaison de l'API SIEM
Compatible avec :
Google SecOps
SIEM
Ce document met en correspondance les anciens points de terminaison de l'API SIEM (API Backstory, y compris l'API Customer Management et l'API Ingestion) avec leurs points de terminaison correspondants de l'API Chronicle moderne.
Autorisation et délégation de partenaire
Dans l'API Chronicle, Identity and Access Management (IAM) remplace les clés API et les jetons d'accès existants pour le contrôle des accès. Pour accéder directement à une instance, authentifiez-vous avec des identifiants OAuth 2.0 pour un compte de service ou un compte principal de fédération d'identité de charge de travail. Ce compte principal doit disposer des rôles IAM requis dans le projet qui héberge l'instance.
Pour les partenaires, l'autorisation dépend de la propriété des ressources. Le projet qui héberge une ressource détermine les identifiants et les autorisations IAM dont un partenaire a besoin. Limiter les opérations de locataire aux identifiants délégués par le locataire est conforme au principe de sécurité de base selon lequel les partenaires ne doivent pas pouvoir accéder aux données du locataire, les récupérer ni les modifier sans l'autorisation explicite de ce dernier. Le tableau suivant compare l'autorisation des partenaires dans l'ancienne API Backstory et l'API Chronicle :
| API | Méthodes | Champ d'application de la ressource | Autorisation |
|---|---|---|---|
| Ancienne API Backstory | /v1/partner/customer/* points de terminaison |
Tous les codes client du partenaire | Les partenaires appellent directement ces points de terminaison avec leurs propres jetons de partenaire ou clés API. |
API Chronicle : TenantService |
CreateTenant, ListTenants et UpdateTenant |
Instance du partenaire : projects/{partner_project}/locations/{location}/instances/{partner_instance}/tenants/* |
Les partenaires appellent directement ces méthodes avec leurs propres comptes de service ou identifiants disposant d'autorisations chronicle.googleapis.com/tenants.* dans le projet partenaire. |
API Chronicle : autres services, tels que InstanceService et ForwarderService |
GetInstance, UpdateInstance, GenerateForwarderFiles et d'autres méthodes limitées au locataire |
Instance du locataire : projects/{tenant_project}/locations/{location}/instances/{tenant_instance}/... |
Les identifiants du partenaire ne permettent pas d'accéder aux données du locataire ni de les modifier. L'administrateur du locataire doit attribuer des rôles IAM, tels que roles/chronicle.admin, roles/chronicle.viewer ou un rôle personnalisé, au compte de service ou au principal de la fédération d'identité de charge de travail du partenaire dans le projet Google Cloud du locataire. |
Table de mappage d'API
| Zone de la fonctionnalité | Ancienne méthode API | Ancienne version de l'API | Méthode de l'API Chronicle | Autorisation IAM requise | Mappage détaillé des requêtes et des réponses |
|---|---|---|---|---|---|
| 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 |
| Cas | CreateOrUpdateCase |
v1 | LegacyCreateOrUpdateCase | chronicle.googleapis.com/legacies.legacyCreateOrUpdateCase |
LegacyCreateOrUpdateCase |
| Exportation de données | CancelDataExport |
v1 | CancelDataExport | chronicle.googleapis.com/dataExports.cancel |
— |
| Exportation de données | CreateDataExport |
v1 | CreateDataExport | chronicle.googleapis.com/dataExports.create |
— |
| Exportation de données | GetDataExport |
v1 | GetDataExport | chronicle.googleapis.com/dataExports.get |
— |
| Exportation de données | 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 |
| Flux | CreateFeed |
v1 | CreateFeed | chronicle.googleapis.com/feeds.create |
CreateFeed |
| Flux | DeleteFeed |
v1 | DeleteFeed | chronicle.googleapis.com/feeds.delete |
DeleteFeed |
| Flux | DisableFeed |
v1 | DisableFeed | chronicle.googleapis.com/feeds.disable |
DisableFeed |
| Flux | EnableFeed |
v1 | EnableFeed | chronicle.googleapis.com/feeds.enable |
EnableFeed |
| Flux | FetchFeedServiceAccount |
v1 | FetchServiceAccountForCustomer | chronicle.googleapis.com/feedServiceAccounts.fetch |
FetchServiceAccountForCustomer |
| Flux | GetFeed |
v1 | GetFeed | chronicle.googleapis.com/feeds.get |
GetFeed |
| Flux | GetFeedSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Flux | GetLogTypeSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Flux | ListFeeds |
v1 | ListFeeds | chronicle.googleapis.com/feeds.list |
ListFeeds |
| Flux | ListFeedSourceTypeSchemas |
v1 | ListFeedSourceTypeSchemas | chronicle.googleapis.com/feedSourceTypeSchemas.list |
ListFeedSourceTypeSchemas |
| Flux | ListLogTypeSchemas |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Flux | UpdateFeed |
v1 | UpdateFeed | chronicle.googleapis.com/feeds.update |
UpdateFeed |
| Redirecteur | CreateForwarder |
v2 | CreateForwarder | chronicle.googleapis.com/forwarders.create |
CreateForwarder |
| Redirecteur | GetForwarder |
v2 | GetForwarder | chronicle.googleapis.com/forwarders.get |
GetForwarder |
| Redirecteur | ListForwarders |
v2 | ListForwarders | chronicle.googleapis.com/forwarders.list |
ListForwarders |
| Redirecteur | UpdateForwarder |
v2 | UpdateForwarder | chronicle.googleapis.com/forwarders.update |
UpdateForwarder |
| Redirecteur | DeleteForwarder |
v2 | DeleteForwarder | chronicle.googleapis.com/forwarders.delete |
DeleteForwarder |
| Redirecteur | GenerateForwarderFiles |
v2 | GenerateForwarderFiles | chronicle.googleapis.com/forwarders.generateFiles |
— |
| Redirecteur | CreateCollector |
v2 | CreateCollector | chronicle.googleapis.com/collectors.create |
CreateCollector |
| Redirecteur | GetCollector |
v2 | GetCollector | chronicle.googleapis.com/collectors.get |
GetCollector |
| Redirecteur | ListCollectors |
v2 | ListCollectors | chronicle.googleapis.com/collectors.list |
ListCollectors |
| Redirecteur | UpdateCollector |
v2 | UpdateCollector | chronicle.googleapis.com/collectors.update |
UpdateCollector |
| Redirecteur | DeleteCollector |
v2 | DeleteCollector | chronicle.googleapis.com/collectors.delete |
DeleteCollector |
| Analyseur | ArchiveCbnParser |
v1 | DeactivateParser | chronicle.googleapis.com/parsers.deactivate |
DeactivateParser |
| Analyseur | CreateCbnParser |
v1 | CreateParser | chronicle.googleapis.com/parsers.create |
CreateParser |
| Analyseur | GetCbnParser |
v1 | GetParser | chronicle.googleapis.com/parsers.get |
GetParser |
| Analyseur | ListCbnParserHistory |
v1 | ListParsers | chronicle.googleapis.com/parsers.list |
ListParsers |
| Analyseur | ListCbnParsers |
v1 | ListParsers | chronicle.googleapis.com/parsers.list |
ListParsers |
| Analyseur | RetrieveSampleLogs |
v1 | ListLogs | chronicle.googleapis.com/logs.list |
ListLogs |
| Analyseur | ValidateCbnParser |
v1 | CreateParser | chronicle.googleapis.com/parsers.create |
CreateParser |
| Partenaire | CreateCustomer |
v1 | CreateTenant | chronicle.googleapis.com/tenants.create |
CreateTenant |
| Partenaire | GetCustomer |
v1 | GetInstance | chronicle.googleapis.com/instances.get |
GetInstance |
| Partenaire | GetForwarderConfigs |
v1 | GenerateForwarderFiles | chronicle.googleapis.com/forwarders.generate |
GenerateForwarderFiles |
| Partenaire | ListCustomersOfPartner |
v1 | ListTenants | chronicle.googleapis.com/tenants.list |
ListTenants |
| Partenaire | SetAuthVersion |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Partenaire | SetComplianceRequirements |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Partenaire | SetUIState |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Partenaire | 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 |
| Recherche RetroHunt | RunRetrohunt |
v2 | CreateRetrohunt | chronicle.googleapis.com/retrohunts.create |
CreateRetrohunt |
| Recherche RetroHunt | ListRetrohunts |
v2 | ListRetrohunts | chronicle.googleapis.com/retrohunts.list |
ListRetrohunts |
| Recherche RetroHunt | GetRetrohunt |
v2 | GetRetrohunt | chronicle.googleapis.com/retrohunts.get |
GetRetrohunt |
| Recherche RetroHunt | CancelRetrohunt |
v2 | CancelOperation | chronicle.googleapis.com/operations.cancel |
— |
| Recherche RetroHunt | WaitRetrohunt |
v2 | GetOperation | chronicle.googleapis.com/operations.get |
— |
| Règle | GetRule |
v2 | GetRule | chronicle.googleapis.com/rules.get |
GetRule |
| Règle | CreateRule |
v2 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Règle | VerifyRule |
v2 | VerifyRuleText | chronicle.googleapis.com/rules.verifyRuleText |
VerifyRuleText |
| Règle | ListRules |
v2 | ListRules | chronicle.googleapis.com/rules.list |
ListRules |
| Règle | DeleteRule |
v2 | DeleteRule | chronicle.googleapis.com/rules.delete |
DeleteRule |
| Règle | ArchiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Règle | UnarchiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Règle | EnableLiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Règle | DisableLiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Règle | ListRuleVersions |
v2 | ListRuleVersions | chronicle.googleapis.com/ruleVersions.list |
— |
| Règle | CreateRuleVersion |
v2 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Règle | EnableAlerting |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Règle | DisableAlerting |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Règle | ListDetections |
v2 | LegacySearchDetections | chronicle.googleapis.com/legacies.legacySearchDetections |
LegacySearchDetections |
| Règle | GetDetection |
v2 | LegacyGetDetection | chronicle.googleapis.com/legacies.legacyGetDetection |
LegacyGetDetection |
| Règle | StreamDetectionAlerts |
v2 | LegacyStreamDetectionAlerts | chronicle.googleapis.com/legacies.legacyStreamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Règle | StreamTestRule |
v2 | LegacyTestRuleStreaming | chronicle.googleapis.com/legacies.legacyTestRuleStreaming |
LegacyTestRuleStreaming |
| Règles | CreateRule |
v1 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Règles | GetRule |
v1 | GetRule | chronicle.googleapis.com/rules.get |
GetRule |
| Règles | UpdateRule |
v1 | UpdateRule | chronicle.googleapis.com/rules.update |
UpdateRule |
| Règles | DeleteRule |
v1 | DeleteRule | chronicle.googleapis.com/rules.delete |
DeleteRule |
| Règles | EnableLiveRule |
v1 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Règles | ListResults |
v1 | LegacySearchRuleResults | chronicle.googleapis.com/legacies.legacySearchRuleResults |
LegacySearchRuleResults |
| Règles | ListRules |
v1 | ListRules | chronicle.googleapis.com/rules.list |
ListRules |
| Règles | RunRule |
v1 | CreateRetrohunt | chronicle.googleapis.com/retrohunts.create |
CreateRetrohunt |
| Alertes | StreamDetections |
v1 | StreamDetectionAlerts | chronicle.googleapis.com/legacies.streamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Alertes | StreamRuleNotifications |
v1 | StreamDetectionAlerts | chronicle.googleapis.com/legacies.streamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Rechercher | FetchUdmSearchView |
v1 | LegacyFetchUdmSearchView | chronicle.googleapis.com/legacies.legacyFetchUdmSearchView |
LegacyFetchUdmSearchView |
| Rechercher | GetEvent |
v1 | GetEvent | chronicle.googleapis.com/events.get |
GetEvent |
| Journal | GetLog |
v1 | GetLog | chronicle.googleapis.com/logs.get |
— |
| Rechercher | ListArtifactAssets |
v1 | FindRelatedEntities | chronicle.googleapis.com/entities.findRelated |
FindRelatedEntities |
| IOC | ListArtifactIoCDetails |
v1 | LegacySearchArtifactIoCDetails | chronicle.googleapis.com/legacies.legacySearchArtifactIoCDetails |
— |
| Rechercher | ListEvents |
v1 | LegacySearchAssetEvents | chronicle.googleapis.com/legacies.legacySearchAssetEvents |
LegacySearchAssetEvents |
| IOC | ListIoCs |
v1 | ListIocMatches | chronicle.googleapis.com/iocMatches.list |
— |
| Rechercher | SearchRawLogs |
v1 | SearchRawLogs | chronicle.googleapis.com/rawLogs.search |
SearchRawLogs |
| Rechercher | UdmSearch |
v1 | UdmSearch | chronicle.googleapis.com/events.udmSearch |
UdmSearch |
| Rechercher | ListAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Rechercher | ListAssetAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Rechercher | ListUserAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Alertes en majuscules | GetUppercaseAlert |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings. Remarque : L'implémentation des points de terminaison a été supprimée de Backstory mi-2023. |
— |
| Alertes en majuscules | ListUppercaseAlerts |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings. Remarque : L'implémentation des points de terminaison a été supprimée de Backstory mi-2023. |
— |
| API d'ingestion | BatchCreateEntities |
v2 | ImportEntities | chronicle.googleapis.com/entities.import |
ImportEntities |
| API d'ingestion | BatchCreateEvents |
v2 | ImportStatsEvents | chronicle.googleapis.com/forwarders.importStatsEvents |
ImportStatsEvents |
| API d'ingestion | BatchCreateLogs |
v2 | ImportLogs | chronicle.googleapis.com/logs.import |
ImportLogs |
| API d'ingestion | BatchCreateUDMEvents |
v2 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| API d'ingestion | BatchCreateUnstructuredLogEntries |
v2 | ImportLogs | chronicle.googleapis.com/logs.import |
— |
| API d'ingestion | CreateEntities |
v1 | ImportEntities | chronicle.googleapis.com/entities.import |
ImportEntities |
| API d'ingestion | CreateUDMEvents |
v1 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| API d'ingestion | CreateUnstructuredLogEntries |
v1 | ImportLogs | chronicle.googleapis.com/logs.import |
ImportLogs |
| API d'ingestion | ListLogTypes |
v1 | ListLogTypes | chronicle.googleapis.com/logTypes.list |
ListLogTypes |
| API d'ingestion | ListSupportedLogTypes |
v2 | ListLogTypeSettings | chronicle.googleapis.com/logTypeSettings.list |
ListLogTypeSettings |
| API d'ingestion | PutEvent |
v1 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| API d'ingestion | PutLog |
v1 | UpdateLogType | chronicle.googleapis.com/logTypes.update |
UpdateLogType |
Pour en savoir plus sur la migration de l'API Ingestion vers l'API Chronicle, consultez Méthodes d'ingestion de l'API Chronicle.
Points de terminaison non mappés et supprimés
Le tableau suivant liste les anciens points de terminaison d'API qui ne sont pas mappés à l'API Chronicle moderne et qui seront supprimés, ainsi que la justification commerciale :
| Zone de la fonctionnalité | Ancienne méthode API | Ancienne version de l'API | Justification |
|---|---|---|---|
| Ancien RBAC | CreateSubject |
v1 | Obsolète : le contrôle des accès est désormais régi par des rôles IAM Google Cloud granulaires. |
| Ancien RBAC | DeleteSubject |
v1 | Obsolète : le contrôle des accès est désormais régi par des rôles IAM Google Cloud précis. |
| Ancien RBAC | GetSubject |
v1 | Obsolète : le contrôle des accès est désormais régi par des rôles IAM Google Cloud précis. |
| Ancien RBAC | ListRoles |
v1 | Obsolète : le contrôle des accès est désormais régi par des rôles IAM Google Cloud précis. |
| Ancien RBAC | ListSubjects |
v1 | Obsolète : le contrôle des accès est désormais régi par des rôles IAM Google Cloud granulaires. |
| Ancien RBAC | UpdateRole |
v1 | Obsolète : le contrôle des accès est désormais régi par des rôles IAM Google Cloud granulaires. |
| Ancien RBAC | UpdateSubject |
v1 | Obsolète : le contrôle des accès est désormais régi par des rôles IAM Google Cloud granulaires. |
| Analyseur | ListCbnParserErrors |
v1 | N'est plus requis ni disponible dans le workflow moderne de gestion des analyseurs. |
| Partenaire | EnableIAM |
v1 | La fonctionnalité était déjà obsolète et est gérée à l'aide des mécanismes Google Cloud standards. |
| Partenaire | GenerateIamMigrationCommands |
v1 | La fonctionnalité était déjà obsolète et est redondante dans l'architecture moderne. |
| Partenaire | GenerateIdPMetadata |
v1 | Redondant dans l'architecture moderne Google Cloud. |
| Partenaire | GetIngestionFilter |
v1 | Redondant dans l'architecture moderne intégrée à Google Cloud. |
| Partenaire | SetGCPProjectLink |
v1 | Redondant dans l'architecture moderne Google Cloud. |
| Alertes en majuscules | CreateCorrespondence |
v1 | La fonctionnalité était déjà obsolète. |
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.