SIEM API 端点映射
支持：
Google SecOps
SIEM
本文档将旧版 SIEM API 端点（Backstory API，包括 Customer Management API 和 Ingestion API）映射到其对应的现代 Chronicle API 端点。
授权和合作伙伴委托
在 Chronicle API 中，Identity and Access Management (IAM) 取代了旧版 API 密钥和令牌，用于访问权限控制。如需直接访问实例，请使用服务账号或工作负载身份联合主账号的 OAuth 2.0 凭证进行身份验证。该主账号必须在托管实例的项目中拥有所需的 IAM 角色。
对于合作伙伴，授权取决于资源所有权。托管资源的项目决定了合作伙伴需要哪些凭据和 IAM 权限。将租户操作限定为租户委托的凭据，符合核心安全原则，即合作伙伴在未获得租户明确许可的情况下，不应能够访问、检索或修改租户数据。下表比较了旧版 Backstory API 和 Chronicle API 中的合作伙伴授权：
| API | 方法 | 资源范围 | 授权 |
|---|---|---|---|
| 旧版 Backstory API | /v1/partner/customer/* 个端点 |
合作伙伴的所有客户代码 | 合作伙伴使用自己的合作伙伴令牌或 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}/... |
仅凭合作伙伴凭证无法访问或修改租户数据。租户管理员必须在租户的 Google Cloud 项目中向合作伙伴的服务账号或工作负载身份联合主账号授予 IAM 角色，例如 roles/chronicle.admin、roles/chronicle.viewer 或自定义角色。 |
API 映射表
| 功能区域 | 旧版 API 方法 | 旧版 API 版本 | 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 |
| Feed | CreateFeed |
v1 | CreateFeed | chronicle.googleapis.com/feeds.create |
CreateFeed |
| Feed | DeleteFeed |
v1 | DeleteFeed | chronicle.googleapis.com/feeds.delete |
DeleteFeed |
| Feed | DisableFeed |
v1 | DisableFeed | chronicle.googleapis.com/feeds.disable |
DisableFeed |
| Feed | EnableFeed |
v1 | EnableFeed | chronicle.googleapis.com/feeds.enable |
EnableFeed |
| Feed | FetchFeedServiceAccount |
v1 | FetchServiceAccountForCustomer | chronicle.googleapis.com/feedServiceAccounts.fetch |
FetchServiceAccountForCustomer |
| Feed | GetFeed |
v1 | GetFeed | chronicle.googleapis.com/feeds.get |
GetFeed |
| Feed | GetFeedSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Feed | GetLogTypeSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Feed | ListFeeds |
v1 | ListFeeds | chronicle.googleapis.com/feeds.list |
ListFeeds |
| Feed | ListFeedSourceTypeSchemas |
v1 | ListFeedSourceTypeSchemas | chronicle.googleapis.com/feedSourceTypeSchemas.list |
ListFeedSourceTypeSchemas |
| Feed | ListLogTypeSchemas |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| Feed | UpdateFeed |
v1 | UpdateFeed | chronicle.googleapis.com/feeds.update |
UpdateFeed |
| 转发器 | CreateForwarder |
v2 | CreateForwarder | chronicle.googleapis.com/forwarders.create |
CreateForwarder |
| 转发器 | GetForwarder |
v2 | GetForwarder | chronicle.googleapis.com/forwarders.get |
GetForwarder |
| 转发器 | ListForwarders |
v2 | ListForwarders | chronicle.googleapis.com/forwarders.list |
ListForwarders |
| 转发器 | UpdateForwarder |
v2 | UpdateForwarder | chronicle.googleapis.com/forwarders.update |
UpdateForwarder |
| 转发器 | DeleteForwarder |
v2 | DeleteForwarder | chronicle.googleapis.com/forwarders.delete |
DeleteForwarder |
| 转发器 | GenerateForwarderFiles |
v2 | GenerateForwarderFiles | chronicle.googleapis.com/forwarders.generateFiles |
— |
| 转发器 | CreateCollector |
v2 | CreateCollector | chronicle.googleapis.com/collectors.create |
CreateCollector |
| 转发器 | GetCollector |
v2 | GetCollector | chronicle.googleapis.com/collectors.get |
GetCollector |
| 转发器 | ListCollectors |
v2 | ListCollectors | chronicle.googleapis.com/collectors.list |
ListCollectors |
| 转发器 | UpdateCollector |
v2 | UpdateCollector | chronicle.googleapis.com/collectors.update |
UpdateCollector |
| 转发器 | 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 |
| 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 |
— |
| 规则 | 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。注意：端点实现已于 2023 年年中从 Backstory 中移除。 |
— |
| 大写字母提醒 | ListUppercaseAlerts |
v1 | LegacySearchFindings | chronicle.googleapis.com/legacies.legacySearchFindings。注意：端点实现已于 2023 年年中从 Backstory 中移除。 |
— |
| 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 提取方法。
未映射和已移除的端点
下表列出了未映射到新版 Chronicle API 且计划移除的旧版 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 专业人士的解答。