Google Cloud API

本文件提供相關指引，協助您設定Google Cloud API，並與 Google Security Operations 整合。

用途

Google Cloud API 整合功能會使用 Google SecOps 功能，支援下列用途：

  • 自動化資源管理：在 Compute Engine 或 Cloud Storage 等 Google Cloud服務中執行動作，動態修復威脅或管理基礎架構。

  • 身分與存取權管理：以程式輔助方式調整 Identity and Access Management 政策或角色，因應偵測到的安全性事件。

  • 自訂 API 協調：與任何已啟用但沒有專屬整合功能的 Google Cloud API 互動，為複雜的自動化動作提供最大彈性。

  • 無金鑰驗證：使用 Workload Identity 安全存取 Google Cloud 資源，消除靜態服務帳戶金鑰的相關風險。

事前準備

在 Google SecOps 平台中設定整合功能前，請確認您具備下列項目：

  • 啟用目標 API：找出並啟用您要自動化的特定Google Cloud 服務。

  • IAM 權限：確認您的身分具備執行特定動作所需的角色。

  • 驗證方式：選擇建議的 Workload Identity 或服務帳戶 JSON 金鑰進行驗證。

找出並啟用目標 API

由於這項整合是通用閘道，因此沒有固定的 API。具體需求取決於您的用途。您必須在專案中啟用目標 API (例如 Compute Engine、Cloud Storage 或 IAM)，才能透過整合執行這些 API。

請按照下列程序找出並啟用目標 API：

  1. 在 Google Cloud 控制台中，依序前往「APIs & Services」(API 和服務) >「Library」(程式庫)。

  2. 搜尋並啟用必要服務。

設定 IAM 權限

這項整合使用的服務帳戶或身分必須具備適當的 IAM 角色。

  • 最小權限原則：僅授予預期 API 呼叫所需的特定角色。

  • 動態需求：權限會因作業而異。舉例來說，管理資源和列出資源需要不同的角色。

選取驗證方式

Google SecOps 支援兩種驗證路徑，可用於這項整合：

使用 Workload Identity 驗證身分 (建議)

Workload Identity 是最安全的方法，因為您不需要管理或輪替長期有效的 JSON 金鑰。這項服務會使用服務帳戶模擬功能，讓平台安全存取您的資源。

找出 Google SecOps 執行個體身分

請按照下列步驟找出執行個體的專屬身分：

  1. 在 Google SecOps 中，依序前往 「Content Hub」 >「Response Integrations」。

  2. 選取「Google Cloud API」整合。

  3. 在「Workload Identity Email」(Workload Identity 電子郵件) 欄位中，輸入目標服務帳戶電子郵件。

  4. 依序點選「儲存」和「測試」。測試預計會失敗。

  5. 按一下「Test」(測試) 右側的 close_small，然後在錯誤訊息中搜尋以 gke-init-python@... 或 soar-python@... 開頭的身分電子郵件。

  6. 複製這個專屬電子郵件地址。

授予模擬權限

請完成下列步驟，授權執行個體身分存取資源：

  1. 在 Google Cloud 控制台，依序前往 「IAM & Admin」(IAM 與管理) >「Service Accounts」(服務帳戶)。

    前往「Service Accounts」(服務帳戶)

  2. 選取目標服務帳戶，然後依序前往 「Permissions」(權限) >「Grant Access」(授予存取權)。

  3. 將不重複的電子郵件地址貼到「New principals」(新增主體) 欄位，並指派「Service Account Token Creator」(服務帳戶權杖建立者) 角色 (roles/iam.serviceAccountTokenCreator)。

使用 JSON 金鑰進行驗證

只有在環境中無法使用 Workload Identity 時，才應使用這個方法。

請按照下列程序，使用服務帳戶 JSON 金鑰驗證整合：

  1. 在 Google Cloud 控制台建立服務帳戶。

  2. 前往 「Keys」(金鑰) 分頁，然後依序選取 「Add key」(新增金鑰) >「Create new key」(建立新的金鑰)。

  3. 選取「JSON」做為金鑰類型，然後下載檔案。

  4. 複製這個檔案的完整內容，並在 Google SecOps 整合設定期間，貼到 Service Account Json File Content。

將 Google Cloud API 與 Google SecOps SOAR 整合

整合時需要下列參數：

參數 說明
Test URL 選用

用於驗證 Google Cloud API 驗證機制的測試網址。這個參數會使用 GET 要求。
Service Account Json File Content 選用

服務帳戶金鑰 JSON 檔案的內容。

您可以設定這個參數、Workload Identity Email 參數，或設定上述所有整合參數。

如要設定這項參數，請提供您在建立服務帳戶時下載的服務帳戶金鑰 JSON 檔案完整內容。

如要進一步瞭解如何使用服務帳戶做為驗證方式，請參閱「服務帳戶總覽」和「服務帳戶模擬」。

在這項整合中，使用服務帳戶金鑰 JSON 檔案進行驗證的優先順序，高於 Workload Identity 電子郵件。
Organization ID 選用

要在整合中使用的組織 ID。

如要在執行動作期間擷取這個參數的值，請設定下列預留位置：{{org_id}}。
Project ID 選用

要在整合作業中使用的專案 ID。

如要在執行動作期間擷取這個參數的值，請設定下列預留位置：{{project_id}}。
Quota Project ID 選用

用於 Google Cloud API 和計費的 Google Cloud 專案 ID。您必須將 Service Usage Consumer 角色授予服務帳戶，才能使用這項參數。

整合功能會將這個參數值附加至所有 API 要求。

如未設定這個參數的值，整合作業會從 Google Cloud 服務帳戶擷取專案 ID。
Workload Identity Email 選用

服務帳戶的用戶端電子郵件地址。

您可以設定這個參數或 Service Account Json File Content 參數。

在這項整合中，使用服務帳戶金鑰 JSON 檔案進行驗證的優先順序高於 Workload Identity 電子郵件。

如要使用 Workload Identity 模擬服務帳戶，請將 Service Account Token Creator 角色授予服務帳戶的 Google SecOps 執行個體身分。如要進一步瞭解 Workload Identity 和使用方式，請參閱「Workload Identity」。
OAuth Scopes 選用

以半形逗號分隔的 OAuth 範圍清單，用於執行 Google Cloud API 要求。
Verify SSL 必要

如果選取這個選項，整合功能會驗證用於連線至 Google Cloud 服務的 SSL 憑證是否有效。

預設為選取。

如需在 Google SecOps 中設定整合功能的相關操作說明，請參閱「設定整合功能」。

如有需要，您可以在後續階段進行變更。設定整合執行個體後，即可在應對手冊中使用。如要進一步瞭解如何設定及支援多個執行個體，請參閱「支援多個執行個體」。

動作

如要進一步瞭解動作，請參閱「 在工作區回應待處理動作」和「在案件中執行手動動作」。

執行 HTTP 要求

使用「Execute HTTP Request」(執行 HTTP 要求) 動作，建構並執行針對目標網址的自訂 HTTP API 要求。

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

動作行為

這項動作支援複雜行為，包括非同步輪詢、動態酬載建構和檔案管理。

非同步輪詢

如果提供 Expected Response Values，動作會以非同步模式運作。在這種模式下，動作會重複輪詢目標端點，追蹤回應狀態 (例如等待長時間執行的工作完成)。

這項動作會根據參數中提供的 JSON 條件評估回應主體，並持續執行，直到符合條件或動作逾時為止。

條件邏輯

這項動作支援下列邏輯，可用於追蹤回應狀態：

  • 單一欄位比對：動作會等待特定欄位達到單一值。

    {
  "state": "finished"
}

  • 多個值 (OR 邏輯)：如果欄位與所提供清單中的任何值相符，動作就會停止執行。這項功能可用於在「成功」和「錯誤」狀態下停止，避免不必要的輪詢。

    {
  "state": ["finished", "error"]
}

  • 多個欄位 (AND 邏輯)：動作會等待所有指定欄位同時符合各自的值。

    {
  "state": "finished",
  "percentage": "100"
}

  • 合併邏輯：您可以在 JSON 物件中合併多個條件。

    {
  "state": ["finished", "error"],
  "percentage": "10"
}
JSON 剖析行為

評估條件時，動作會遵循下列規則：

  • 全域搜尋：這項動作會在整個 JSON 回應物件中搜尋指定索引鍵。請提供與 JSON 中完全相同的鍵名稱，不要在前面加上父項物件名稱或使用前置字元 (例如使用 "state"，而非 "data_state" 或 "data-state")。

  • 多個相同鍵：如果回應在 JSON 階層的不同層級中包含多個同名鍵，則只有在所有相符的鍵名稱都符合相同的預期值時，才會達到預期輸出內容。

    舉例來說，如要在 JSON 回應中搜尋 finished 狀態並忽略其他狀態，請將 Expected Response Values 中的所有 state 鍵設為 finished：

    {
"data": {
  "state": "finished"
  },
  "state": "finished"
}
主體酬載結構

這項動作會根據 Headers 中提供的 Content-Type 標頭建構要求主體。

以下是建構範例使用的 Body Payload 輸入內容：

{
  "Id": "123123",
  "sorting": "asc"
}

  • application/x-www-form-urlencoded：動作會產生 Id=123123&sorting=asc 酬載。

  • application/json：這項動作會產生下列 JSON 酬載：

    {
  "Id": "123123",
  "sorting": "asc"
}

  • XML：如果第三方產品需要 XML，請直接在 Body Payload 中提供 XML 格式的輸入內容：

    <?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="[http://schemas.xmlsoap.org/soap/envelope/](http://schemas.xmlsoap.org/soap/envelope/)">
<soap:Body>
  <NumberToWords xmlns="[http://www.dataaccess.com/webservicesserver/](http://www.dataaccess.com/webservicesserver/)">
    <ubiNum>500</ubiNum>
  </NumberToWords>
</soap:Body>
</soap:Envelope>
檔案處理

這項動作支援下列檔案管理工作流程：

  • 下載檔案：

    • 如要以 base64 格式傳回檔案資料，做為 JSON 結果的一部分，請選取 Base64 Output。

    • 如要將檔案直接儲存至案件牆，並以 ZIP 封存檔的形式儲存，請選取 Save To Case Wall。

  • 上傳檔案：如要上傳檔案，請將檔案轉換為 Base64 編碼字串，並納入 Body Payload 值。

    以下範例顯示圖片檔轉換為 Base64 編碼字串：

    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

  • 安全性：如果是機密檔案 (例如惡意軟體)，請選取 Password Protect Zip。這會自動使用密碼 infected 加密以 Save To Case Wall 建立的已儲存 ZIP 封存檔。

應對手冊區塊設定

下列設定示範如何在自動戰術區塊中使用「Execute HTTP Request」(執行 HTTP 要求) 動作。請參考這個範例，瞭解如何套用預留位置和輸入前置字元。

使用區塊輸入做為預留位置時，必須加上 Input. 前置字元 (例如 [Input.comment])。

  • 方法：PUT

  • 網址路徑：

    https://{API_URL}/[Input.table_name]/[Input.sys_id]

  • 標頭：

    {
  "Content-type": "application/json; charset=utf-8",
  "Accept": "application/json",
  "User-Agent": "GoogleSecops"
}

  • Body Payload：

    {
  "work_notes": "[Input.comment]"
}

動作輸入內容

「Execute HTTP Request」(執行 HTTP 要求) 動作需要下列參數：

參數 說明
Method 選用

要求中使用的方法。

預設值為 GET。

可能的值包括：
  • GET
  • POST
  • PUT
  • PATCH
  • DELETE
  • HEAD
  • OPTIONS
URL Path 選用

要執行的網址。

預設值為 https://。
URL Params 選用

網址參數。

這項動作會使用提供的任何值，以及您在「網址路徑」參數中直接提供的值。

這項參數需要 JSON 物件格式做為輸入內容。預設值如下：

{
    "URL Field Name": "URL_FIELD_VALUE"
    }
Headers 選用

HTTP 要求中使用的標頭。

這個參數需要 JSON 物件格式做為輸入內容。預設值如下：

{
    "Content-Type": "application/json; charset=utf-8",
    "Accept": "application/json",
    "User-Agent" : "GoogleSecOps"
    }
Cookie 選用

要在 Cookie 標頭中使用的參數。

這個參數會覆寫 Headers 參數中提供的 Cookie。

這項參數需要 JSON 物件格式做為輸入內容。預設值如下：

{
    "Cookie_1": "COOKIE_1_VALUE"
    }
Body Payload
 選用

HTTP 要求的主體。這項動作會根據 Headers 參數中提供的 Content-Type 標頭值，建構不同的酬載。

這個參數需要 JSON 物件格式做為輸入內容，除非第三方產品需要 XML 或 multipart/form-data 內容。如果使用 API 要求提交或上傳檔案，請在「Body Payload」參數中提供檔案的 Base64 編碼版本，並將標頭設為 "Content-type": "multipart/form-data"。

預設值如下：

{
    "Body Field Name": "BODY_FIELD_VALUE"
    }
Expected Response Values

選填。

JSON 物件，包含定義回應主體必要狀態的欄位值組合。
Save To Case Wall 選用

如果選取，系統會儲存檔案，並將儲存的檔案附加至案件總覽。檔案會以 .zip 副檔名封存。.zip 檔案未受密碼保護。

預設為未選取。
Password Protect Zip 選用

如果選取，這項動作會將密碼新增至使用 Save To Case Wall 參數建立的 .zip 檔案。密碼如下：infected。

處理可疑檔案時，請使用這個參數。

預設為選取。
Follow Redirects 選用

如果選取，動作會遵循重新導向。

預設為選取。
Fail on 4xx/5xx 選用

如果選取，當回應的狀態碼為 4xx 或 5xx 錯誤時，動作就會失敗。

預設為選取。
Base64 Output 選用

如果選取，動作會將回應轉換為 base64 格式。

下載檔案時，請使用這個參數。

JSON 結果不得超過 15 MB。

預設為未選取。
Fields To Return 必要

要傳回的欄位。可能的值如下：

  • response_data
  • redirects
  • response_code
  • response_cookies
  • response_headers
  • apparent_encoding
Request Timeout 必要

在動作失敗前，等待伺服器傳送資料的時間。

預設值為 120 秒。

動作輸出內容

「執行 HTTP 要求」動作會提供下列輸出內容：

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

以下範例說明使用「執行 HTTP 要求」動作時，收到的 JSON 結果輸出內容：

{
   "response_data": {
       "data": {
           "relationships": {
               "comment": [
                   {
                       "name": "item",
                       "description": "Object to which the comment belongs to."
                   },
                   {
                       "name": "author",
                       "description": "User who wrote the comment."
                   }
               ]
           }
       }
   },
   "redirects": [],
   "response_code": 200,
   "cookies": {},
   "response_headers": {
       "Content-Type": "application/json",
       "X-Cloud-Trace-Context": "VALUE",
       "Date": "Fri, 03 Nov 2023 16:14:13 GMT",
       "Server": "Google Frontend",
       "Content-Length": "36084"
   },
   "apparent_encoding": "ascii"
}
輸出訊息

「Execute HTTP Request」(執行 HTTP 要求) 動作會提供下列輸出訊息：

輸出訊息 訊息說明

Successfully executed API request.

Successfully executed API request, but the status code {4xx/5xx} was returned. Please check the request or try again later.

 動作成功。
Failed to execute API request. Error: ERROR_REASON

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼執行結果

下表說明使用「Execute HTTP Request」(執行 HTTP 要求) 動作時，指令碼結果輸出的值：

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

乒乓

使用 Ping 動作測試與 Google Cloud的連線。

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

動作輸入內容

無

動作輸出內容

Ping 動作會提供下列輸出內容：

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

以下範例說明使用 Ping 動作時，收到的 JSON 結果輸出內容：

{
"endpoint": "TEST_URL"
}
輸出訊息

Ping 動作會提供下列輸出訊息：

輸出訊息 訊息說明
Successfully tested connectivity. 動作成功。
Failed to test connectivity.

動作失敗。

請檢查伺服器連線、輸入參數或憑證。
指令碼執行結果

下表說明使用 Ping 動作時，指令碼結果輸出的值：

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

還有其他問題嗎？向社群成員和 Google SecOps 專業人員尋求解答。