SIEM API エンドポイントのマッピング
以下でサポートされています。
Google SecOps
SIEM
このドキュメントでは、以前の SIEM API エンドポイント（Customer Management API を含む Backstory API と Ingestion API）を、対応する最新の Chronicle API エンドポイントにマッピングします。
承認とパートナーへの委任
Chronicle API では、アクセス制御に従来の API キーとトークンではなく Identity and Access Management（IAM）を使用します。インスタンスに直接アクセスするには、サービス アカウントまたは Workload Identity 連携プリンシパルの 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 プロジェクトで、パートナーのサービス アカウントまたは Workload Identity 連携プリンシパルに 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 |
| フィード | 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 から削除されました。 |
— |
| Uppercase アラート | 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統合アーキテクチャでは冗長。 |
| Uppercase アラート | CreateCorrespondence |
v1 | 機能はすでに非推奨になっています。 |
さらにサポートが必要な場合 コミュニティ メンバーや Google SecOps のプロフェッショナルから回答を得ることができます。