Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Wiz を Google SecOps と統合する

このドキュメントでは、Wiz を Google Security Operations（Google SecOps）と統合する方法について説明します。

始める前に

統合を使用するには、API ルート、クライアント ID、クライアントシークレットが必要です。

これらの認証情報を生成する方法については、サービスアカウントの設定をご覧ください。

サービスアカウントに必要な権限とスコープ

Google SecOps で実行するオペレーションに適した API 権限スコープが Wiz サービスアカウントに付与されていることを確認します。

読み取りとクエリオペレーション

オペレーション / 目的	使用リソース	必要な権限 / スコープ
接続をテストする	Ping アクション	`read:issues`
問題の詳細を取得する	Get Issue Details アクション	`read:issues` `read:posture_issues` `read:threat_issues` `read:comments`
リソースの脆弱性の検出結果を一覧表示する	リソースの脆弱性検出結果を一覧表示するアクション	`read:vulnerabilities`
Blue Agent Analysis を取得する	Blue Agent Analysis アクションを取得する	`read:threat_issues`

書き込みオペレーションと変更オペレーション（ミューテーション）

オペレーション / 目的	使用リソース	必要な権限 / スコープ
問題を再開	Reopen Issue Action	`write:issue_status` `update:posture_issue_status` `write:threat_issue_status`
問題を解決	Resolve Issue アクション	`write:threat_issue_status` `write:threat_issues`
問題を無視	問題を無視するアクション	`update:posture_issue_ignore` `write:issue_ignore`
Add Comment To Issue（問題にコメントを追加）	Add Comment To Issue アクション	`write:issue_comments` `write:threat_issue_comments` `write:comments`

統合のパラメータ

Wiz 統合には次のパラメータが必要です。

パラメータ	説明
`API Root`	必須。 Wiz テナントの GraphQL API エンドポイント URL。エンドポイントは `https://api.<region>.app.wiz.io/graphql`（Wiz for Gov の場合は `https://api.<region>.app.wiz.us/graphql`）の形式にする必要があります。ここで、`<region>` は割り当てられた Wiz データセンターリージョン（`us1`、`us2`、`eu1`、`eu2` など）を表します。正確なエンドポイント URL を取得するには、Wiz テナントの詳細を参照してください。番号なしの一般的な地域別 URL は使用しないでください。
`Authentication URL`	省略可。 OAuth アクセストークンの生成に使用される認証 URL。商用環境の場合は、`https://auth.app.wiz.io` を使用します。Wiz for Gov（FedRAMP）環境の場合は、`https://auth.app.wiz.us` を使用します。デフォルト値は `https://auth.app.wiz.io` です。
`Client ID`	必須。 Wiz API 認証情報に関連付けられているクライアント ID。
`Client Secret`	必須。 Wiz API 認証情報に関連付けられたクライアントシークレット。
`Verify SSL`	必須。選択すると、統合によって Wiz サーバーに接続するときに SSL 証明書が検証されます。デフォルトで有効になっています。

Google SecOps で統合を構成する手順については、統合を構成するをご覧ください。

必要に応じて、後の段階で変更できます。統合インスタンスを構成すると、ハンドブックで使用できるようになります。複数のインスタンスの構成とサポートの詳細については、複数のインスタンスのサポートをご覧ください。

操作

アクションの詳細については、デスクから保留中のアクションに対応すると手動による対策を実行するをご覧ください。

Ping

Ping アクションを使用して、Wiz への接続をテストします。

このアクションは Google SecOps エンティティに対しては実行されません。

アクションへの入力

なし

アクションの出力

[Ping] アクションでは、次の出力が提供されます。

アクションの出力タイプ	対象
ケースウォールのアタッチメント	利用不可
ケースウォールのリンク	利用不可
ケースウォールテーブル	利用不可
拡充テーブル	利用不可
JSON の結果	利用不可
出力メッセージ	利用可能
スクリプトの結果。	利用可能

出力メッセージ

Ping アクションは、次の出力メッセージを返すことができます。

出力メッセージメッセージの説明

出力メッセージ	メッセージの説明
`Successfully connected to the Wiz server with the provided connection parameters!`	アクションが成功しました。
`Failed to connect to the Wiz server! Error is ERROR_REASON`	操作に失敗しました。サーバーへの接続、入力パラメータ、または認証情報を確認してください。

Successfully connected to the Wiz server with the provided connection parameters!

アクションが成功しました。

Failed to connect to the Wiz server!
      Error is  ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、Ping アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名	値
`is_success`	`True` または `False`

問題の詳細を取得する

問題の詳細を取得アクションを使用して、Wiz で指定された問題に関する情報を取得します。

このアクションは Google SecOps エンティティに対して実行されません。

アクションへの入力

[Get Issue Details] アクションには、次のパラメータが必要です。

パラメータ説明

パラメータ	説明
`Issue ID`	必須。取得または処理する Wiz の問題の固有識別子。

Issue ID

必須。

取得または処理する Wiz の問題の固有識別子。

アクションの出力

[Get Issue Details] アクションは、次の出力を提供します。

アクションの出力タイプ	対象
ケースウォールのアタッチメント	利用不可
ケースウォールのリンク	利用不可
ケースウォールテーブル	利用不可
拡充テーブル	利用不可
JSON の結果	利用可能
出力メッセージ	利用可能
スクリプトの結果	利用可能

JSON の結果

次の例は、Get Issue Details アクションを使用した場合に受信される JSON 結果の出力を示しています。

{
   "id": "f54e3fb9-a520-4e99-aacc-b99f6ae7f28d",
   "createdAt": "2025-07-26T11:47:43.94524Z",
   "updatedAt": "2025-07-31T07:34:54.445702Z",
   "status": "RESOLVED",
   "severity": "CRITICAL",
   "type": "TOXIC_COMBINATION",
   "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc.",
   "resolvedAt": "2025-07-31T07:34:54.445702Z",
   "entitySnapshot": {
       "cloudPlatform": "GCP",
       "id": "1971f945-3476-5b3d-a5a1-ab166c3e2eca",
       "name": "cluster-solr",
       "region": "us-central1",
       "subscriptionName": "Wiz-Labs",
       "type": "KUBERNETES_CLUSTER"
   },
   "projects": [
       {
           "id": "904cbc14-1c52-571c-a6b8-46fee263eb0f",
           "name": "GCP Lab"
       }
   ],
   "sourceRules": [
       {
           "id": "wc-id-1038",
           "name": "Container using an image infected with critical/high severity malware",
           "description": "This container is using an image that contains a file identified as a high/critical severity malware by ReversingLabs.\n\nMalware can imply a malicious actor's presence in your environment. The malware can be used for crypto-mining, data leakage, lateral movement to other resources in your environment, etc."
       }
   ]
}

出力メッセージ

[Get Issue Details] アクションは、次の出力メッセージを返すことができます。

出力メッセージメッセージの説明

出力メッセージ	メッセージの説明
`Successfully returned details for the following issue using information from Wiz: ISSUE_ID` `The action wasn't able to return details for the following entities using information from Wiz: ISSUE_ID`	アクションが成功しました。
`Error executing action "Get Issue Details". Reason: ERROR_REASON`	操作に失敗しました。サーバーへの接続、入力パラメータ、または認証情報を確認してください。

Successfully returned details for the following issue using information from Wiz: ISSUE_ID

The action wasn't able to return details for the following entities using information from Wiz: ISSUE_ID

アクションが成功しました。

Error executing action "Get Issue Details". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、Get Issue Details アクションを使用する場合のスクリプト結果出力の値を示します。

スクリプトの結果名	値
`is_success`	`True` または `False`

問題を再開する

[Reopen Issue] アクションを使用して、Wiz で指定した問題を再度開きます。

このアクションは Google SecOps エンティティに対して実行されません。

アクションへの入力

[Reopen Issue]（問題を再開）アクションには、次のパラメータが必要です。

パラメータ説明

パラメータ	説明
`Issue ID`	必須。取得または更新する Wiz の問題の固有識別子。

Issue ID

必須。

取得または更新する Wiz の問題の固有識別子。

アクションの出力

[Reopen Issue] アクションでは、次の出力が提供されます。

アクションの出力タイプ	対象
ケースウォールのアタッチメント	利用不可
ケースウォールのリンク	利用不可
ケースウォールテーブル	利用不可
拡充テーブル	利用不可
JSON の結果	利用可能
出力メッセージ	利用可能
スクリプトの結果	利用可能

JSON の結果

次の例は、[Reopen Issue] アクションを使用した場合に受信される JSON 結果の出力です。

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "OPEN",
    "dueAt": null,
    "resolutionReason": null
}

出力メッセージ

[Reopen Issue] アクションは、次の出力メッセージを返すことができます。

出力メッセージメッセージの説明

出力メッセージ	メッセージの説明
Wiz の `Successfully reopened issue with ID ISSUE_ID`。	アクションが成功しました。
`Error executing action "Reopen Issue". Reason: ERROR_REASON`	操作に失敗しました。サーバーへの接続、入力パラメータ、または認証情報を確認してください。

Wiz の Successfully reopened issue with ID ISSUE_ID。

アクションが成功しました。

Error executing action "Reopen Issue". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、[Reopen Issue] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名	値
`is_success`	`True` または `False`

問題を無視

[問題を無視] アクションを使用して、Wiz で指定された問題を無視します。

このアクションは Google SecOps エンティティに対して実行されません。

アクションへの入力

[Ignore Issue]（問題を無視）アクションには、次のパラメータが必要です。

パラメータ説明

パラメータ	説明
`Issue ID`	必須。 Wiz の問題の一意の識別子。
`Resolution Reason`	必須。問題の解決理由。値は次のいずれかになります。 `False Positive` `Exception` `Won't Fix~` デフォルト値は `False Positive` です。
`Resolution Note`	省略可。問題解決に関する追加のコンテキストを提供するメモ。

Issue ID

必須。

Wiz の問題の一意の識別子。

Resolution Reason

必須。

問題の解決理由。

値は次のいずれかになります。

False Positive
Exception
Won't Fix~

デフォルト値は False Positive です。

Resolution Note

省略可。

問題解決に関する追加のコンテキストを提供するメモ。

アクションの出力

[Ignore Issue] アクションでは、次の出力が提供されます。

アクションの出力タイプ	対象
ケースウォールのアタッチメント	利用不可
ケースウォールのリンク	利用不可
ケースウォールテーブル	利用不可
拡充テーブル	利用不可
JSON の結果	利用可能
出力メッセージ	利用可能
スクリプトの結果	利用可能

JSON の結果

次の例は、[問題を無視] アクションを使用したときに受信した JSON 結果の出力を示しています。

{
    "id": "41facd3f-29b0-4fcf-9a0c-e7fc40416aa0",
    "note": "",
    "status": "REJECTED",
    "dueAt": null,
    "resolutionReason": "FALSE_POSITIVE"
}

出力メッセージ

[Ignore Issue] アクションは、次の出力メッセージを返すことがあります。

出力メッセージメッセージの説明

出力メッセージ	メッセージの説明
Wiz の `Successfully ignored issue with ID ISSUE_ID`。	アクションが成功しました。
`Error executing action "Ignore Issue". Reason: ERROR_REASON`	操作に失敗しました。サーバーへの接続、入力パラメータ、または認証情報を確認してください。

Wiz の Successfully ignored issue with ID ISSUE_ID。

アクションが成功しました。

Error executing action "Ignore Issue". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、[問題を無視] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名	値
`is_success`	`True` または `False`

問題を解決する

Wiz で指定された問題を解決するには、[Resolve Issue] アクションを使用します。

このアクションは Google SecOps エンティティに対して実行されません。

アクションへの入力

[Resolve Issue] アクションには、次のパラメータが必要です。

パラメータ説明

パラメータ	説明
`Issue ID`	必須。 Wiz の問題の一意の識別子。
`Resolution Reason`	必須。問題の解決理由。値は次のいずれかになります。 `Malicious Threat` `Not Malicious Threat` `Security Test Threat` `Planned Action Threat` `Inconclusive Threat` デフォルト値は `Not Malicious Threat` です。
`Resolution Note`	省略可。解決策に関する追加のコンテキストを提供するメモ。

Issue ID

必須。

Wiz の問題の一意の識別子。

Resolution Reason

必須。

問題の解決理由。

値は次のいずれかになります。

Malicious Threat
Not Malicious Threat
Security Test Threat
Planned Action Threat
Inconclusive Threat

デフォルト値は Not Malicious Threat です。

Resolution Note

省略可。

解決策に関する追加のコンテキストを提供するメモ。

アクションの出力

[Resolve Issue] アクションは、次の出力を提供します。

アクションの出力タイプ	対象
ケースウォールのアタッチメント	利用不可
ケースウォールのリンク	利用不可
ケースウォールテーブル	利用不可
拡充テーブル	利用不可
JSON の結果	利用可能
出力メッセージ	利用可能
スクリプトの結果	利用可能

JSON の結果

次の例は、[Resolve Issue] アクションを使用したときに受信した JSON 結果の出力を示しています。

{
    "id": "0db2222f-7d1f-501a-9ad5-fe669c7da036",
    "resolutionNote": "",
    "status": "RESOLVED",
    "dueAt": null,
    "resolutionReason": "NOT_MALICIOUS_THREAT"
}

出力メッセージ

[問題を解決] アクションは、次の出力メッセージを返すことがあります。

出力メッセージメッセージの説明

出力メッセージ	メッセージの説明
Wiz の `Successfully resolved issue with ID ISSUE_ID`。	アクションが成功しました。
`Error executing action "Resolve Issue". Reason: ERROR_REASON`	操作に失敗しました。サーバーへの接続、入力パラメータ、または認証情報を確認してください。

Wiz の Successfully resolved issue with ID ISSUE_ID。

アクションが成功しました。

Error executing action "Resolve Issue". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、[問題を解決] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名	値
`is_success`	`True` または `False`

問題にコメントを追加する

Add Comment To Issue アクションを使用して、Wiz の指定された問題にコメントを追加します。

このアクションは Google SecOps エンティティに対して実行されません。

アクションへの入力

[Add Comment To Issue] アクションには、次のパラメータが必要です。

パラメータ説明

パラメータ	説明
`Issue ID`	必須。 Wiz の問題の一意の識別子。
`Comment`	必須。問題に追加するコメントのテキスト。

Issue ID

必須。

Wiz の問題の一意の識別子。

Comment

必須。

問題に追加するコメントのテキスト。

アクションの出力

[Add Comment To Issue] アクションでは、次の出力が提供されます。

アクションの出力タイプ	対象
ケースウォールのアタッチメント	利用不可
ケースウォールのリンク	利用不可
ケースウォールテーブル	利用不可
拡充テーブル	利用不可
JSON の結果	利用可能
出力メッセージ	利用可能
スクリプトの結果	利用可能

JSON の結果

次の例は、[Add Comment To Issue] アクションを使用した場合に受信される JSON 結果の出力例を示しています。

{
  "createdAt": "2025-08-01T11:59:00.843434941Z", "id":
  "6f997da2-85a0-4be2-b205-83ea19e9b17a", "text": "testing"
}

出力メッセージ

[Add Comment To Issue] アクションは、次の出力メッセージを返すことがあります。

出力メッセージメッセージの説明

出力メッセージ	メッセージの説明
Wiz の `Successfully added a comment to the issue with ID ISSUE_ID`。	アクションが成功しました。
`Error executing action "Add Comment To Issue". Reason: ERROR_REASON`	操作に失敗しました。サーバーへの接続、入力パラメータ、または認証情報を確認してください。

Wiz の Successfully added a comment to the issue with ID ISSUE_ID。

アクションが成功しました。

Error executing action "Add Comment To Issue". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、Add Comment To Issue アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名	値
`is_success`	`True` または `False`

Blue Agent Analysis を取得する

Get Blue Agent Analysis アクションを使用して、指定した脅威に対する Wiz Blue Agent の分析の詳細を取得します。

このアクションは Google SecOps エンティティに対して実行されません。

アクションへの入力

Get Blue Agent Analysis アクションには、次のパラメータが必要です。

パラメータ説明

パラメータ	説明
`Threat ID`	必須。 Wiz 脅威 ID の固有識別子。

Threat ID

必須。

Wiz 脅威 ID の固有識別子。

アクションの出力

[Get Blue Agent Analysis] アクションは、次の出力を提供します。

アクションの出力タイプ	対象
ケースウォールのアタッチメント	利用不可
ケースウォールのリンク	利用不可
ケースウォールテーブル	利用不可
拡充テーブル	利用不可
JSON の結果	利用可能
出力メッセージ	利用可能
スクリプトの結果	利用可能

JSON の結果

次の例は、Get Blue Agent Analysis アクションを使用した場合に受信する JSON 結果の出力です。

{
  "id": "threat-12345",
  "threatType": "MALWARE_DETECTION",
  "status": "COMPLETED",
  "analysis": {
    "summary": "Blue Agent analysis details",
    "riskScore": "HIGH"
  }
}

出力メッセージ

[Get Blue Agent Analysis] アクションは、次の出力メッセージを返すことができます。

出力メッセージメッセージの説明

出力メッセージ	メッセージの説明
Wiz の `Successfully retrieved blue agent analysis for threat ID THREAT_ID`。	アクションが成功しました。
`Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON`	操作に失敗しました。サーバーへの接続、入力パラメータ、または認証情報を確認してください。

Wiz の Successfully retrieved blue agent analysis for threat ID THREAT_ID。

アクションが成功しました。

Error executing action "Get Blue Agent Analysis". Reason: ERROR_REASON

操作に失敗しました。

サーバーへの接続、入力パラメータ、または認証情報を確認してください。

スクリプトの結果

次の表に、[Get Blue Agent Analysis] アクションを使用した場合のスクリプト結果出力の値を示します。

スクリプトの結果名	値
`is_success`	`True` または `False`

ジョブ

ジョブの詳細については、新しいジョブを構成すると高度なスケジューリングをご覧ください。

Wiz と Google SecOps の双方向同期ジョブ

Wiz と Google SecOps の双方向同期ジョブを使用して、Wiz の脅威と Google SecOps のケース間の継続的な同期を維持します。

求人のパラメータ

Wiz と Google SecOps の双方向同期ジョブには、次のパラメータが必要です。

パラメータ	説明
`Environment Name`	必須。ケースを同期する環境の名前。デフォルト値は `Default Environment` です。
`Wiz API Root`	必須。テナントの Wiz GraphQL API エンドポイント。エンドポイントは `https://api.<region>.app.wiz.io/graphql`（Wiz for Gov の場合は `https://api.<region>.app.wiz.us/graphql`）の形式にする必要があります。ここで、`<region>` は割り当てられた Wiz データセンターリージョン（`us1`、`us2`、`eu1`、`eu2` など）を表します。正確なエンドポイント URL を取得するには、Wiz テナントの詳細を参照してください。番号なしの一般的な地域別 URL は使用しないでください。デフォルトのプレースホルダ値は `https://api.<region>.app.wiz.io/graphql` です。`<region>` は、割り当てられた Wiz データセンターリージョンに置き換えます。
`Wiz Authentication URL`	省略可。 OAuth アクセストークンの生成に使用される認証 URL。商用環境の場合は、`https://auth.app.wiz.io` を使用します。Wiz for Gov（FedRAMP）環境の場合は、`https://auth.app.wiz.us` を使用します。デフォルト値は `https://auth.app.wiz.io` です。
`Wiz Client ID`	必須。 Wiz API サービスアカウントのクライアント ID。
`Wiz Client Secret`	必須。 Wiz API サービスアカウントのクライアントシークレット。
`Max Hours Backwards`	省略可。最初のジョブの反復処理の前に、更新されたケースを取得する時間数（範囲: 1 ～ 720、デフォルト: 24）。このパラメータは、最初のジョブ実行に適用されるか、最後の実行タイムスタンプがリセットされた場合のフォールバックとして適用されます。
`Verify SSL`	必須。選択すると、Wiz サーバーに接続するときに SSL 証明書が検証されます。デフォルトで選択されています。
`Fields to sync`	必須。同期するフィールドを決定する項目のカンマ区切りのリスト。ここに明示的にリストされているフィールドのみが同期されます。指定できる値は、`Status`、`Comments`、`Product Link`、`Severity` です。デフォルト値は `Status, Comments, Product Link, Severity` です。

さらにサポートが必要な場合 コミュニティメンバーや Google SecOps のプロフェッショナルから回答を得ることができます。

Wiz を Google SecOps と統合する

始める前に

サービス アカウントに必要な権限とスコープ

読み取りとクエリ オペレーション

書き込みオペレーションと変更オペレーション（ミューテーション）

統合のパラメータ

操作

Ping

アクションへの入力

アクションの出力

出力メッセージ

スクリプトの結果

問題の詳細を取得する

アクションへの入力

アクションの出力

JSON の結果

出力メッセージ

スクリプトの結果

問題を再開する

アクションへの入力

アクションの出力

JSON の結果

出力メッセージ

スクリプトの結果

問題を無視

アクションへの入力

アクションの出力

JSON の結果

出力メッセージ

スクリプトの結果

問題を解決する

アクションへの入力

アクションの出力

JSON の結果

出力メッセージ

スクリプトの結果

問題にコメントを追加する

アクションへの入力

アクションの出力

JSON の結果

出力メッセージ

スクリプトの結果

Blue Agent Analysis を取得する

アクションへの入力

アクションの出力

JSON の結果

出力メッセージ

スクリプトの結果

ジョブ

Wiz と Google SecOps の双方向同期ジョブ

求人のパラメータ

サービスアカウントに必要な権限とスコープ

読み取りとクエリオペレーション