Asignación de extremo de API de SIEM
Se admite en los siguientes sistemas operativos:
Google SecOps
SIEM
En este documento, se asignan los endpoints de API de SIEM heredada (API de Backstory, incluida la API de Customer Management y la API de Ingestion) a sus endpoints de API correspondientes de la API de Chronicle moderna.
Autorización y delegación de socios
En la API de Chronicle, Identity and Access Management (IAM) reemplaza las claves de API y los tokens heredados para el control de acceso. Para acceder a una instancia directamente, autentícate con credenciales de OAuth 2.0 para una cuenta de servicio o una principal de la federación de identidades para cargas de trabajo. Esa principal debe tener los roles de IAM necesarios en el proyecto que aloja la instancia.
En el caso de los socios, la autorización depende de la propiedad de los recursos. El proyecto que aloja un recurso determina qué credenciales y permisos de IAM necesita un socio. Limitar las operaciones de los inquilinos a las credenciales delegadas por ellos se alinea con el principio de seguridad fundamental de que los socios no deben poder acceder a los datos de los inquilinos, recuperarlos ni modificarlos sin el permiso explícito otorgado por el inquilino. En la siguiente tabla, se compara la autorización de socios en la API heredada de Backstory y la API de Chronicle:
| API | Métodos | Permiso del recurso | Autorización |
|---|---|---|---|
| API de Backstory heredada | /v1/partner/customer/* extremos |
Todos los códigos de cliente del socio | Los socios llaman a estos extremos directamente con sus propios tokens de socio o claves de API. |
API de Chronicle: TenantService |
CreateTenant, ListTenants y UpdateTenant |
Instancia del socio: projects/{partner_project}/locations/{location}/instances/{partner_instance}/tenants/* |
Los socios llaman a estos métodos directamente con sus propias cuentas de servicio o credenciales que tienen permisos de chronicle.googleapis.com/tenants.* en el proyecto del socio. |
API de Chronicle: Otros servicios, como InstanceService y ForwarderService |
GetInstance, UpdateInstance, GenerateForwarderFiles y otros métodos con alcance para el arrendatario |
Instancia del usuario: projects/{tenant_project}/locations/{location}/instances/{tenant_instance}/... |
Las credenciales de socio por sí solas no pueden acceder a los datos del usuario ni modificarlos. El administrador del usuario debe otorgar roles de IAM, como roles/chronicle.admin, roles/chronicle.viewer o un rol personalizado, a la cuenta de servicio del socio o a la principal de la federación de identidades para cargas de trabajo en el proyecto de Google Cloud del usuario. |
Tabla de asignación de APIs
| Área de características | Método de API heredado | Versión de la API heredada | Método de la API de Chronicle | Se requiere permiso de IAM | Asignación detallada de solicitudes y respuestas |
|---|---|---|---|---|---|
| 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 |
| Caso | CreateOrUpdateCase |
v1 | LegacyCreateOrUpdateCase | chronicle.googleapis.com/legacies.legacyCreateOrUpdateCase |
LegacyCreateOrUpdateCase |
| Exportación de datos | CancelDataExport |
v1 | CancelDataExport | chronicle.googleapis.com/dataExports.cancel |
— |
| Exportación de datos | CreateDataExport |
v1 | CreateDataExport | chronicle.googleapis.com/dataExports.create |
— |
| Exportación de datos | GetDataExport |
v1 | GetDataExport | chronicle.googleapis.com/dataExports.get |
— |
| Exportación de datos | 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 |
| Reenviador | CreateForwarder |
v2 | CreateForwarder | chronicle.googleapis.com/forwarders.create |
CreateForwarder |
| Reenviador | GetForwarder |
v2 | GetForwarder | chronicle.googleapis.com/forwarders.get |
GetForwarder |
| Reenviador | ListForwarders |
v2 | ListForwarders | chronicle.googleapis.com/forwarders.list |
ListForwarders |
| Reenviador | UpdateForwarder |
v2 | UpdateForwarder | chronicle.googleapis.com/forwarders.update |
UpdateForwarder |
| Reenviador | DeleteForwarder |
v2 | DeleteForwarder | chronicle.googleapis.com/forwarders.delete |
DeleteForwarder |
| Reenviador | GenerateForwarderFiles |
v2 | GenerateForwarderFiles | chronicle.googleapis.com/forwarders.generateFiles |
— |
| Reenviador | CreateCollector |
v2 | CreateCollector | chronicle.googleapis.com/collectors.create |
CreateCollector |
| Reenviador | GetCollector |
v2 | GetCollector | chronicle.googleapis.com/collectors.get |
GetCollector |
| Reenviador | ListCollectors |
v2 | ListCollectors | chronicle.googleapis.com/collectors.list |
ListCollectors |
| Reenviador | UpdateCollector |
v2 | UpdateCollector | chronicle.googleapis.com/collectors.update |
UpdateCollector |
| Reenviador | DeleteCollector |
v2 | DeleteCollector | chronicle.googleapis.com/collectors.delete |
DeleteCollector |
| Analizador | ArchiveCbnParser |
v1 | DeactivateParser | chronicle.googleapis.com/parsers.deactivate |
DeactivateParser |
| Analizador | CreateCbnParser |
v1 | CreateParser | chronicle.googleapis.com/parsers.create |
CreateParser |
| Analizador | GetCbnParser |
v1 | GetParser | chronicle.googleapis.com/parsers.get |
GetParser |
| Analizador | ListCbnParserHistory |
v1 | ListParsers | chronicle.googleapis.com/parsers.list |
ListParsers |
| Analizador | ListCbnParsers |
v1 | ListParsers | chronicle.googleapis.com/parsers.list |
ListParsers |
| Analizador | RetrieveSampleLogs |
v1 | ListLogs | chronicle.googleapis.com/logs.list |
ListLogs |
| Analizador | ValidateCbnParser |
v1 | CreateParser | chronicle.googleapis.com/parsers.create |
CreateParser |
| Socio | CreateCustomer |
v1 | CreateTenant | chronicle.googleapis.com/tenants.create |
CreateTenant |
| Socio | GetCustomer |
v1 | GetInstance | chronicle.googleapis.com/instances.get |
GetInstance |
| Socio | GetForwarderConfigs |
v1 | GenerateForwarderFiles | chronicle.googleapis.com/forwarders.generate |
GenerateForwarderFiles |
| Socio | ListCustomersOfPartner |
v1 | ListTenants | chronicle.googleapis.com/tenants.list |
ListTenants |
| Socio | SetAuthVersion |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Socio | SetComplianceRequirements |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Socio | SetUIState |
v1 | UpdateInstance | chronicle.googleapis.com/instances.update |
UpdateInstance |
| Socio | 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 |
— |
| Regla | GetRule |
v2 | GetRule | chronicle.googleapis.com/rules.get |
GetRule |
| Regla | CreateRule |
v2 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Regla | VerifyRule |
v2 | VerifyRuleText | chronicle.googleapis.com/rules.verifyRuleText |
VerifyRuleText |
| Regla | ListRules |
v2 | ListRules | chronicle.googleapis.com/rules.list |
ListRules |
| Regla | DeleteRule |
v2 | DeleteRule | chronicle.googleapis.com/rules.delete |
DeleteRule |
| Regla | ArchiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regla | UnarchiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regla | EnableLiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regla | DisableLiveRule |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regla | ListRuleVersions |
v2 | ListRuleVersions | chronicle.googleapis.com/ruleVersions.list |
— |
| Regla | CreateRuleVersion |
v2 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Regla | EnableAlerting |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regla | DisableAlerting |
v2 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Regla | ListDetections |
v2 | LegacySearchDetections | chronicle.googleapis.com/legacies.legacySearchDetections |
LegacySearchDetections |
| Regla | GetDetection |
v2 | LegacyGetDetection | chronicle.googleapis.com/legacies.legacyGetDetection |
LegacyGetDetection |
| Regla | StreamDetectionAlerts |
v2 | LegacyStreamDetectionAlerts | chronicle.googleapis.com/legacies.legacyStreamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Regla | StreamTestRule |
v2 | LegacyTestRuleStreaming | chronicle.googleapis.com/legacies.legacyTestRuleStreaming |
LegacyTestRuleStreaming |
| Reglas | CreateRule |
v1 | CreateRule | chronicle.googleapis.com/rules.create |
CreateRule |
| Reglas | GetRule |
v1 | GetRule | chronicle.googleapis.com/rules.get |
GetRule |
| Reglas | UpdateRule |
v1 | UpdateRule | chronicle.googleapis.com/rules.update |
UpdateRule |
| Reglas | DeleteRule |
v1 | DeleteRule | chronicle.googleapis.com/rules.delete |
DeleteRule |
| Reglas | EnableLiveRule |
v1 | UpdateRuleDeployment | chronicle.googleapis.com/ruleDeployments.update |
UpdateRuleDeployment |
| Reglas | ListResults |
v1 | LegacySearchRuleResults | chronicle.googleapis.com/legacies.legacySearchRuleResults |
LegacySearchRuleResults |
| Reglas | ListRules |
v1 | ListRules | chronicle.googleapis.com/rules.list |
ListRules |
| Reglas | RunRule |
v1 | CreateRetrohunt | chronicle.googleapis.com/retrohunts.create |
CreateRetrohunt |
| Alertas | StreamDetections |
v1 | StreamDetectionAlerts | chronicle.googleapis.com/legacies.streamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Alertas | StreamRuleNotifications |
v1 | StreamDetectionAlerts | chronicle.googleapis.com/legacies.streamDetectionAlerts |
LegacyStreamDetectionAlerts |
| Buscar | FetchUdmSearchView |
v1 | LegacyFetchUdmSearchView | chronicle.googleapis.com/legacies.legacyFetchUdmSearchView |
LegacyFetchUdmSearchView |
| Buscar | GetEvent |
v1 | GetEvent | chronicle.googleapis.com/events.get |
GetEvent |
| Registro | GetLog |
v1 | GetLog | chronicle.googleapis.com/logs.get |
— |
| Buscar | ListArtifactAssets |
v1 | FindRelatedEntities | chronicle.googleapis.com/entities.findRelated |
FindRelatedEntities |
| IOC | ListArtifactIoCDetails |
v1 | LegacySearchArtifactIoCDetails | chronicle.googleapis.com/legacies.legacySearchArtifactIoCDetails |
— |
| Buscar | ListEvents |
v1 | LegacySearchAssetEvents | chronicle.googleapis.com/legacies.legacySearchAssetEvents |
LegacySearchAssetEvents |
| IOC | ListIoCs |
v1 | ListIocMatches | chronicle.googleapis.com/iocMatches.list |
— |
| Buscar | SearchRawLogs |
v1 | SearchRawLogs | chronicle.googleapis.com/rawLogs.search |
SearchRawLogs |
| Buscar | UdmSearch |
v1 | UdmSearch | chronicle.googleapis.com/events.udmSearch |
UdmSearch |
| Buscar | ListAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Buscar | ListAssetAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Buscar | ListUserAliases |
v1 | SummarizeEntity | chronicle.googleapis.com/entities.summarize |
SummarizeEntity |
| Alertas en mayúsculas | GetUppercaseAlert |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings. Nota: La implementación de extremos se quitó de Backstory a mediados de 2023. |
— |
| Alertas en mayúsculas | ListUppercaseAlerts |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings. Nota: La implementación del extremo se quitó de Backstory a mediados de 2023. |
— |
| Stream Ingestion | BatchCreateEntities |
v2 | ImportEntities | chronicle.googleapis.com/entities.import |
ImportEntities |
| Stream Ingestion | BatchCreateEvents |
v2 | ImportStatsEvents | chronicle.googleapis.com/forwarders.importStatsEvents |
ImportStatsEvents |
| Stream Ingestion | BatchCreateLogs |
v2 | ImportLogs | chronicle.googleapis.com/logs.import |
ImportLogs |
| Stream Ingestion | BatchCreateUDMEvents |
v2 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| Stream Ingestion | BatchCreateUnstructuredLogEntries |
v2 | ImportLogs | chronicle.googleapis.com/logs.import |
— |
| Stream Ingestion | CreateEntities |
v1 | ImportEntities | chronicle.googleapis.com/entities.import |
ImportEntities |
| Stream Ingestion | CreateUDMEvents |
v1 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| Stream Ingestion | CreateUnstructuredLogEntries |
v1 | ImportLogs | chronicle.googleapis.com/logs.import |
ImportLogs |
| Stream Ingestion | ListLogTypes |
v1 | ListLogTypes | chronicle.googleapis.com/logTypes.list |
ListLogTypes |
| Stream Ingestion | ListSupportedLogTypes |
v2 | ListLogTypeSettings | chronicle.googleapis.com/logTypeSettings.list |
ListLogTypeSettings |
| Stream Ingestion | PutEvent |
v1 | ImportEvents | chronicle.googleapis.com/events.import |
ImportEvents |
| Stream Ingestion | PutLog |
v1 | UpdateLogType | chronicle.googleapis.com/logTypes.update |
UpdateLogType |
Para obtener más información sobre la migración de la API de Ingestion a la API de Chronicle, consulta Métodos de transferencia de datos de la API de Chronicle.
Extremos sin asignar y quitados
En la siguiente tabla, se enumeran los endpoints de API heredados que no se asignan a la API moderna de Chronicle y que se programaron para su eliminación, junto con la justificación comercial:
| Área de características | Método de API heredado | Versión de la API heredada | Justificación |
|---|---|---|---|
| RBAC heredado | CreateSubject |
v1 | Obsoleto. El control de acceso ahora se rige por roles de IAM Google Cloud detallados. |
| RBAC heredado | DeleteSubject |
v1 | Obsoleto; el control de acceso ahora se rige por roles de IAM detallados de Google Cloud . |
| RBAC heredado | GetSubject |
v1 | Obsoleto; el control de acceso ahora se rige por roles de IAM detallados de Google Cloud . |
| RBAC heredado | ListRoles |
v1 | Obsoleto; el control de acceso ahora se rige por roles de IAM detallados de Google Cloud . |
| RBAC heredado | ListSubjects |
v1 | Obsoleto; el control de acceso ahora se rige por roles de IAM detallados de Google Cloud . |
| RBAC heredado | UpdateRole |
v1 | Obsoleto. El control de acceso ahora se rige por roles de IAM Google Cloud detallados. |
| RBAC heredado | UpdateSubject |
v1 | Obsoleto. El control de acceso ahora se rige por roles de IAM Google Cloud detallados. |
| Analizador | ListCbnParserErrors |
v1 | Ya no es necesario ni está disponible en el flujo de trabajo moderno de administración de analizadores. |
| Socio | EnableIAM |
v1 | El componente ya estaba en desuso y se controla con mecanismos Google Cloud estándar. |
| Socio | GenerateIamMigrationCommands |
v1 | La función ya se dio de baja y es redundante en la arquitectura moderna. |
| Socio | GenerateIdPMetadata |
v1 | Es redundante en la arquitectura moderna integrada en Google Cloud. |
| Socio | GetIngestionFilter |
v1 | Es redundante en la arquitectura moderna integrada en Google Cloud. |
| Socio | SetGCPProjectLink |
v1 | Redundante en la arquitectura moderna integrada en Google Cloud. |
| Alertas en mayúsculas | CreateCorrespondence |
v1 | La función ya dejó de estar disponible. |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.