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

Wiz を Google SecOps と統合する

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

始める前に

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

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

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

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

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

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

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

オペレーション / 目的	使用アカウント	必要な権限 / スコープ
問題を再オープンする	問題の再開アクション	`write:issue_status` `update:posture_issue_status` `write:threat_issue_status`
問題を解決する	問題解決アクション	`write:threat_issue_status` `write:threat_issues`
問題を無視	問題を無視するアクション	`update:posture_issue_ignore` `write:issue_ignore`
問題にコメントを追加する	問題にコメントを追加するアクション	`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 アクションは、次の出力メッセージを返すことができます。

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

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

Successfully reopened issue with ID ISSUE_ID（Wiz）。

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

Error executing action "Reopen Issue". Reason: ERROR_REASON

アクションが失敗しました。

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

スクリプトの結果

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

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

問題を無視

Wiz で指定した問題を無視するには、[Ignore Issue] アクションを使用します。

このアクションは 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 の結果

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

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

出力メッセージ

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

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

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

Successfully ignored issue with ID ISSUE_ID（Wiz）。

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

Error executing action "Ignore Issue". Reason: ERROR_REASON

アクションが失敗しました。

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

スクリプトの結果

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

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

問題を解決する

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

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

アクションへの入力

問題の解決アクションには、次のパラメータが必要です。

パラメータ説明

パラメータ	説明
`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

省略可。

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

アクションの出力

問題の解決アクションでは、次の出力が提供されます。

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

JSON の結果

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

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

出力メッセージ

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

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

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

Successfully resolved issue with ID ISSUE_ID（Wiz）。

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

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 アクションは、次の出力メッセージを返すことがあります。

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

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

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

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

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

アクションが失敗しました。

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

スクリプトの結果

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

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

Blue Agent の分析を取得する

Get Blue Agent Analysis アクションを使用して、指定された脅威に関する Wiz ブルーエージェントの分析の詳細を取得します。

このアクションは 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 アクションは、次の出力メッセージを返すことができます。

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

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

Successfully retrieved blue agent analysis for threat ID THREAT_ID（Wiz）。

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

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 の分析を取得する

アクションへの入力

アクションの出力

JSON の結果

出力メッセージ

スクリプトの結果

ジョブ

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

ジョブ パラメータ

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

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

ジョブパラメータ