SIEM API 엔드포인트 매핑
다음에서 지원:
Google SecOps
SIEM
이 문서에서는 기존 SIEM API 엔드포인트 (Customer Management API를 포함한 Backstory 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 프로젝트에서 파트너의 서비스 계정 또는 워크로드 아이덴티티 제휴 주 구성원에게 roles/chronicle.admin, roles/chronicle.viewer 또는 커스텀 역할과 같은 IAM 역할을 부여해야 합니다. |
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 |
| 피드 | CreateFeed |
v1 | CreateFeed | chronicle.googleapis.com/feeds.create |
CreateFeed |
| 피드 | DeleteFeed |
v1 | DeleteFeed | chronicle.googleapis.com/feeds.delete |
DeleteFeed |
| 피드 | DisableFeed |
v1 | DisableFeed | chronicle.googleapis.com/feeds.disable |
DisableFeed |
| 피드 | EnableFeed |
v1 | EnableFeed | chronicle.googleapis.com/feeds.enable |
EnableFeed |
| 피드 | FetchFeedServiceAccount |
v1 | FetchServiceAccountForCustomer | chronicle.googleapis.com/feedServiceAccounts.fetch |
FetchServiceAccountForCustomer |
| 피드 | GetFeed |
v1 | GetFeed | chronicle.googleapis.com/feeds.get |
GetFeed |
| 피드 | GetFeedSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| 피드 | GetLogTypeSchema |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| 피드 | ListFeeds |
v1 | ListFeeds | chronicle.googleapis.com/feeds.list |
ListFeeds |
| 피드 | ListFeedSourceTypeSchemas |
v1 | ListFeedSourceTypeSchemas | chronicle.googleapis.com/feedSourceTypeSchemas.list |
ListFeedSourceTypeSchemas |
| 피드 | ListLogTypeSchemas |
v1 | ListLogTypeSchemas | chronicle.googleapis.com/logTypeSchemas.list |
ListLogTypeSchemas |
| 피드 | 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 전문가에게 문의하여 답변을 받으세요.