將 Wiz 與 Google SecOps 整合

本文說明如何將 Wiz 與 Google Security Operations (Google SecOps) 整合。

事前準備

如要使用整合功能,您需要 API 根、用戶端 ID 和用戶端密鑰。

如要進一步瞭解如何產生這些憑證,請參閱「服務帳戶設定」。

必要的服務帳戶權限和範圍

請確認 Wiz 服務帳戶具備適當的 API 權限範圍,可執行您要在 Google SecOps 執行的作業。

讀取和查詢作業

作業/目的 使用者 必要權限/範圍
測試連線能力 Ping 動作 read:issues
取得問題詳細資料 取得問題詳細資料動作 read:issues
read:posture_issues
read:threat_issues
read:comments
列出資源安全漏洞發現項目 列出資源安全漏洞發現項目動作 read:vulnerabilities
取得藍色代理分析 取得藍色代理分析動作 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 端點網址。

端點必須採用 https://api.<region>.app.wiz.io/graphql 格式 (或 Wiz for Gov 的 https://api.<region>.app.wiz.us/graphql),其中 <region> 代表指派給您的 Wiz 資料中心區域 (例如 us1、us2、eu1 或 eu2)。

請參閱 Wiz 租戶詳細資料,取得確切的端點網址。請勿使用未編號的一般區域網址。

Authentication URL

選填。

用於產生 OAuth 存取權杖的驗證網址。如果是商業環境,請使用 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 動作測試與 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

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用 Ping 動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success True或False

取得問題詳細資料

使用「Get Issue Details」動作,取得 Wiz 中指定問題的相關資訊。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Get Issue Details」動作需要下列參數:

參數 說明
Issue ID

這是必填欄位。

要擷取或處理的 Wiz 問題專屬 ID。

動作輸出內容

「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

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Get Issue Details」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success True或False

重新開啟問題

使用「重新開啟問題」動作,在 Wiz 中重新開啟指定問題。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Reopen Issue」(重新開啟問題) 動作需要下列參數:

參數 說明
Issue ID

這是必填欄位。

要擷取或更新的問題在 Wiz 中的專屬 ID。

動作輸出內容

「重新開啟問題」動作會提供下列輸出內容:

動作輸出類型 可用性
案件總覽附件 無法使用
案件總覽連結 無法使用
案件總覽表格 無法使用
補充資訊表格 無法使用
JSON 結果 可用
輸出訊息 可用
指令碼執行結果 可用
JSON 結果

以下範例顯示使用「Reopen Issue」動作時,收到的 JSON 結果輸出內容:

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

「重新開啟問題」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

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 實體上執行。

動作輸入內容

「忽略問題」動作需要下列參數:

參數 說明
Issue ID

這是必填欄位。

Wiz 中的問題專屬 ID。

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」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Wiz 中的「Successfully ignored issue with ID ISSUE_ID」。

動作成功。
Error executing action "Ignore Issue". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Ignore Issue」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success True或False

解決問題

使用「解決問題」動作,解決 Wiz 中的特定問題。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「解決問題」動作需要下列參數:

參數 說明
Issue ID

這是必填欄位。

Wiz 中的問題專屬 ID。

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"
}
輸出訊息

「Resolve Issue」動作可能會傳回下列輸出訊息:

輸出訊息 訊息說明

Wiz 中的「Successfully resolved issue with ID ISSUE_ID」。

動作成功。
Error executing action "Resolve Issue". Reason: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Resolve Issue」(解決問題) 動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success True或False

在問題中新增留言

使用「Add Comment To Issue」動作,在 Wiz 中為指定問題新增註解。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Add Comment To Issue」動作需要下列參數:

參數 說明
Issue ID

這是必填欄位。

Wiz 中的問題專屬 ID。

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

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「Add Comment To Issue」動作時,指令碼結果輸出的值:

指令碼結果名稱 值
is_success True或False

取得藍色代理分析

使用「Get Blue Agent Analysis」動作,從 Wiz Blue Agent 取得指定威脅的分析詳細資料。

這項動作不會在 Google SecOps 實體上執行。

動作輸入內容

「Get Blue Agent Analysis」動作需要下列參數:

參數 說明
Threat ID

這是必填欄位。

Wiz 威脅 ID 的專屬 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

動作失敗。

請檢查伺服器連線、輸入參數或憑證。

指令碼執行結果

下表列出使用「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)。

請參閱 Wiz 租戶詳細資料,取得確切的端點網址。請勿使用未編號的一般區域網址。

預設預留位置值為 https://api.<region>.app.wiz.io/graphql。將 <region> 替換為指派給您的 Wiz 資料中心區域。

Wiz Authentication URL

選填。

用於產生 OAuth 存取權杖的驗證網址。如果是商業環境,請使用 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 專業人員尋求解答。