將 Wiz 與 Google SecOps 整合
本文說明如何將 Wiz 與 Google Security Operations (Google SecOps) 整合。
事前準備
如要使用整合功能,您需要 API 根、用戶端 ID 和用戶端密鑰。
如要進一步瞭解如何產生這些憑證,請參閱「服務帳戶設定」。
必要的服務帳戶權限和範圍
請確認 Wiz 服務帳戶具備適當的 API 權限範圍,可執行您要在 Google SecOps 執行的作業。
讀取和查詢作業
| 作業/目的 | 使用者 | 必要權限/範圍 |
|---|---|---|
| 測試連線能力 | Ping 動作 | read:issues |
| 取得問題詳細資料 | 取得問題詳細資料動作 | read:issuesread:posture_issuesread:threat_issuesread:comments |
| 列出資源安全漏洞發現項目 | 列出資源安全漏洞發現項目動作 | read:vulnerabilities |
| 取得藍色代理分析 | 取得藍色代理分析動作 | read:threat_issues |
寫入和修改作業 (異動)
| 作業/目的 | 使用者 | 必要權限/範圍 |
|---|---|---|
| 重新開啟問題 | 重新開啟問題動作 | write:issue_statusupdate:posture_issue_statuswrite:threat_issue_status |
| 解決問題 | 解決問題操作 | write:threat_issue_statuswrite:threat_issues |
| 忽略問題 | 忽略問題動作 | update:posture_issue_ignorewrite:issue_ignore |
| 在問題中新增註解 | 在問題中新增註解動作 | write:issue_commentswrite:threat_issue_commentswrite:comments |
整合參數
Wiz 整合需要下列參數:
| 參數 | 說明 |
|---|---|
API Root |
這是必填欄位。 Wiz 租戶的 GraphQL API 端點網址。 端點必須採用 請參閱 Wiz 租戶詳細資料,取得確切的端點網址。請勿使用未編號的一般區域網址。 |
Authentication URL |
選填。 用於產生 OAuth 存取權杖的驗證網址。如果是商業環境,請使用 預設值為 |
Client ID |
這是必填欄位。 與 Wiz API 憑證相關聯的用戶端 ID。 |
Client Secret |
這是必填欄位。 與 Wiz API 憑證相關聯的用戶端密鑰。 |
Verify SSL |
這是必填欄位。 如果選取,整合作業會在連線至 Wiz 伺服器時驗證 SSL 憑證。 (預設為啟用)。 |
如要瞭解如何在 Google SecOps 中設定整合功能,請參閱「設定整合功能」。
如有需要,您可以在後續階段進行變更。設定整合執行個體後,即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體,請參閱「支援多個執行個體」。
動作
如要進一步瞭解動作,請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。
乒乓
使用 Ping 動作測試與 Wiz 的連線。
這項動作不會在 Google SecOps 實體上執行。
動作輸入內容
無
動作輸出內容
Ping 動作會提供下列輸出內容:
| 動作輸出類型 | 可用性 |
|---|---|
| 案件總覽附件 | 無法使用 |
| 案件總覽連結 | 無法使用 |
| 案件總覽表格 | 無法使用 |
| 補充資訊表格 | 無法使用 |
| JSON 結果 | 無法使用 |
| 輸出訊息 | 可用 |
| 指令碼結果。 | 可用 |
輸出訊息
Ping 動作可能會傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作成功。 |
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」動作可傳回下列輸出訊息:
| 輸出訊息 | 訊息說明 |
|---|---|
|
動作成功。 |
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 中的「 |
動作成功。 |
Error executing action "Reopen Issue". Reason: ERROR_REASON |
動作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「Reopen Issue」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
True或False |
忽略問題
使用「忽略問題」動作,忽略 Wiz 中的指定問題。
這項動作不會在 Google SecOps 實體上執行。
動作輸入內容
「忽略問題」動作需要下列參數:
| 參數 | 說明 |
|---|---|
Issue ID |
這是必填欄位。 Wiz 中的問題專屬 ID。 |
Resolution Reason |
這是必填欄位。 問題解決的原因。 可能的值如下:
預設值為 |
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 中的「 |
動作成功。 |
Error executing action "Ignore Issue". Reason: ERROR_REASON |
動作失敗。 請檢查伺服器連線、輸入參數或憑證。 |
指令碼執行結果
下表列出使用「Ignore Issue」動作時,指令碼結果輸出的值:
| 指令碼結果名稱 | 值 |
|---|---|
is_success |
True或False |
解決問題
使用「解決問題」動作,解決 Wiz 中的特定問題。
這項動作不會在 Google SecOps 實體上執行。
動作輸入內容
「解決問題」動作需要下列參數:
| 參數 | 說明 |
|---|---|
Issue ID |
這是必填欄位。 Wiz 中的問題專屬 ID。 |
Resolution Reason |
這是必填欄位。 問題解決的原因。 可能的值如下:
預設值為 |
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 中的「 |
動作成功。 |
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 中的「 |
動作成功。 |
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 中的「 |
動作成功。 |
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 |
這是必填欄位。 要同步處理案件的環境名稱。 預設值為 |
Wiz API Root |
這是必填欄位。 租戶的 Wiz GraphQL API 端點。 端點必須採用 請參閱 Wiz 租戶詳細資料,取得確切的端點網址。請勿使用未編號的一般區域網址。 預設預留位置值為 |
Wiz Authentication URL |
選填。 用於產生 OAuth 存取權杖的驗證網址。如果是商業環境,請使用 預設值為 |
Wiz Client ID |
這是必填欄位。 Wiz API 服務帳戶的用戶端 ID。 |
Wiz Client Secret |
這是必填欄位。 Wiz API 服務帳戶的用戶端密鑰。 |
Max Hours Backwards |
選填。 從初始工作疊代前幾小時開始擷取更新案件 (範圍:1 到 720,預設值:24)。這個參數適用於首次執行的工作,或在上次執行時間戳記重設時做為備用。 |
Verify SSL |
這是必填欄位。 如果選取,整合功能會在連線至 Wiz 伺服器時驗證 SSL 憑證。 預設為選取。 |
Fields to sync |
這是必填欄位。 以半形逗號分隔的項目清單,用於決定應同步處理哪些欄位。只有這裡明確列出的欄位會同步。可能的值包括: 預設值為 |
還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。