Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

將整合範例與 Google SecOps 整合

本文件提供整合範例的完整指南，說明建構 Google Security Operations (Google SecOps) 動作、連接器和工作的常見設計模式。

整合參數

範例整合需要下列參數：

參數說明

參數	說明
`API Root`	這是必填欄位。整合執行個體的 API 根目錄。在本範例中，我們使用 VAT Comply 服務進行整合，API 根目錄為 `api.vatcomply.com`。預設值為 `http://api.vatcomply.com`。
`Password Field`	選填。 API 密碼欄位範例。這個參數僅供示範之用，API 不需要這個參數即可進行驗證。預設值為 `Google SecOps`。
`Verify SSL`	這是必填欄位。如果選取，動作會驗證 API 伺服器的 SSL 憑證。預設為選取。

API Root

這是必填欄位。

整合執行個體的 API 根目錄。

在本範例中，我們使用 VAT Comply 服務進行整合，API 根目錄為 api.vatcomply.com。

預設值為 http://api.vatcomply.com。

Password Field

選填。

API 密碼欄位範例。

這個參數僅供示範之用，API 不需要這個參數即可進行驗證。

預設值為 Google SecOps。

Verify SSL

這是必填欄位。

如果選取，動作會驗證 API 伺服器的 SSL 憑證。

預設為選取。

如要瞭解如何在 Google SecOps 中設定整合功能，請參閱「設定整合功能」。

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

動作

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

乒乓

使用 Ping 動作測試與整合項目的連線能力。

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

動作輸入內容

無

動作輸出內容

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

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

輸出訊息

Ping 動作可能會傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`Successfully connected to the API Service server with the provided connection parameters!`	動作成功。
`Failed to connect to the API Service server! Error is ERROR_REASON`	動作失敗。請檢查伺服器連線、輸入參數或憑證。

Successfully connected to the API Service server with the provided connection parameters!

動作成功。

Failed to connect to the
      API Service server!
      Error is  ERROR_REASON

動作失敗。

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

指令碼執行結果

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

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

簡單動作範例

這是 Google SecOps 基本動作的範例。

這項動作會根據提供的參數，從 api.vatcomply.com 服務擷取資料。

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

動作輸入內容

參數	說明
`Currencies String`	這個參數接受以半形逗號分隔的值清單。選填。以半形逗號分隔的幣別清單，用於指定要處理的幣別。預設值為 `USD, EUR`。
`Currencies DDL`	這個範例參數接受下拉式選單中的值。選填。要處理的幣別下拉式選單。預設值為 `Select One`。可能的值為： `Select One USD EUR CAD`
`Time Frame`	選填。結果的時間範圍。預設值為 `Today`。可能的值為： `Today Last 7 Days Custom` 如果選取 `Custom`，則必須一併提供 `Start Time` 參數的值。
`Start Time`	選填。結果的開始時間，採用 ISO 8601 格式。如果為 `Time Frame` 參數選取 `Custom`，則必須提供這個參數。 `Start Time` 和 `End Time` 之間的時間範圍不得超過七天。這項動作只會使用時間戳記的日期部分。
`End Time`	選填。結果的結束時間，採用 ISO 8601 格式。如果您為 `Time Frame` 選取 `Custom`，但未提供值，則動作會使用目前時間。 `Start Time` 和 `End Time` 之間的時間範圍不得超過七天。這項動作只會使用時間戳記的日期部分。
`Return JSON Result`	這是布林值輸入範例。選填。如果啟用，動作會傳回 JSON 結果。預設為選取。

動作輸出內容

「Search Graphs」動作會提供下列輸出內容：

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

案件總覽連結

這項動作會傳回下列連結：

貨幣：https://www.vatcomply.com/currencies/BASE_CURRENCY/date/DATE

案件總覽表格

這項動作會為每個 API 回應提供下表：

資料表名稱：Currency: {base} - {date}

表格欄：

貨幣 (rate.keyname)
Value (rate.keyname.value)

JSON 結果

以下範例顯示使用該動作時收到的 JSON 結果輸出：

[
   {
       "date": "2000-03-03",
       "exchange_rates": [
           {
               "base": "USD",
               "rates": {
                   "EUR": 1.035303861683404,
                   "USD": 1.0,
                   "JPY": 107.8476032715602,
                   "CYP": 0.5955481933947614,
                   "CZK": 36.87752355316285,
                   "DKK": 7.711357283362667,
                   "EEK": 16.19898540221555,
                   "GBP": 0.6332953721917383,
                   "HUF": 265.60720571487735,
                   "LTL": 4.001035303861683,
                   "LVL": 0.5954032508541256,
                   "MTL": 0.4235428098146806,
                   "PLN": 4.125168236877524,
                   "ROL": 18961.590226731547,
                   "SEK": 8.769023708458434,
                   "SIT": 209.5625841184388,
                   "SKK": 43.26845429133451,
                   "CHF": 1.6630085930220522,
                   "ISK": 73.39269075473652,
                   "NOK": 8.369396417848638,
                   "TRL": 574745.8329019567,
                   "AUD": 1.647479035096801,
                   "CAD": 1.454705456051351,
                   "HKD": 7.782379128274149,
                   "KRW": 1119.9503054146392,
                   "NZD": 2.0485557511129517,
                   "SGD": 1.7232632777720263,
                   "ZAR": 6.4730303344031475
               }
           },
           {
               "base": "EUR",
               "rates": {
                   "EUR": 1.0,
                   "USD": 0.9659,
                   "JPY": 104.17,
                   "CYP": 0.57524,
                   "CZK": 35.62,
                   "DKK": 7.4484,
                   "EEK": 15.6466,
                   "GBP": 0.6117,
                   "HUF": 256.55,
                   "LTL": 3.8646,
                   "LVL": 0.5751,
                   "MTL": 0.4091,
                   "PLN": 3.9845,
                   "ROL": 18315.0,
                   "SEK": 8.47,
                   "SIT": 202.4165,
                   "SKK": 41.793,
                   "CHF": 1.6063,
                   "ISK": 70.89,
                   "NOK": 8.084,
                   "TRL": 555147.0,
                   "AUD": 1.5913,
                   "CAD": 1.4051,
                   "HKD": 7.517,
                   "KRW": 1081.76,
                   "NZD": 1.9787,
                   "SGD": 1.6645,
                   "ZAR": 6.2523
               }
           }
       ]
   }
]

輸出訊息

這項動作可傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`Successfully returned information about the following currencies from START_TIME to END_TIME: "CURRENCIES"`	動作成功。
`Error executing action "ACTION_NAME". Reason: ERROR_REASON`	動作失敗。請檢查伺服器連線、輸入參數或憑證。

Successfully returned information about the following currencies from START_TIME to END_TIME: "CURRENCIES"

動作成功。

Error executing action
      "ACTION_NAME". Reason:
      ERROR_REASON

動作失敗。

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

指令碼執行結果

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

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

「Enrich Entity」動作範例

這個動作可與 Google SecOps 中的實體搭配使用，並強化實體。

這項動作會對參數 Entity Type 中提供的所有 Google SecOps 實體執行。

動作輸入內容

「Enrich Entity」(充實實體) 動作需要下列參數：

參數說明

參數	說明
`Entity Type`	這是必填欄位。要處理的警告範圍實體。預設值為 `All Entities`。可能的值為： `IP Hash User`

Entity Type

這是必填欄位。

要處理的警告範圍實體。

預設值為 All Entities。

可能的值為：


      IP
      Hash
      User

動作輸出內容

「Enrich Entity」動作會提供下列輸出內容：

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

實體擴充表格

「Enrich Entity」(擴充實體) 動作支援下列實體擴充功能：

補充資料欄位	來源 (JSON 金鑰)	適用範圍
`SampleIntegration_enriched`	`true`	JSON 結果中提供。
`SampleIntegration_timestamp`	`timestamp`	JSON 結果中提供。

JSON 結果

以下範例顯示使用「Enrich Entity」動作時，收到的 JSON 結果輸出內容：

{
   "Entity": "Entity",
   "EntityResult": [
       {
           "enriched": "true",
           "timestamp": "12123213123"
       }
   ]
}

輸出訊息

「Enrich Entity」動作可傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`Successfully enriched the following entities: ENTITIES`	動作成功。
`No eligible entities were found in the scope of the alert.`	動作失敗。請檢查伺服器連線、輸入參數或憑證。

Successfully enriched the following entities: ENTITIES

動作成功。

No eligible entities were found in the scope of the alert.

動作失敗。

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

指令碼執行結果

下表列出使用「Enrich Entity」動作時，指令碼結果輸出的值：

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

非同步動作範例

這是 Google SecOps 非同步動作的範例。

在達到逾時時間或案件具有 Case Tag To Wait For 參數中指定的標記之前，動作不會完成執行。

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

動作輸入內容

Async 動作需要下列參數：

參數說明

參數	說明
`Case IDs`	選填。以半形逗號分隔的待處理案件清單。如未提供，動作會使用執行動作時的案件 ID。
`Case Tag To Wait For`	這是必填欄位。這項動作會等待案件標記這個值，然後完成執行。

Case IDs

選填。

以半形逗號分隔的待處理案件清單。

如未提供，動作會使用執行動作時的案件 ID。

Case Tag To Wait For

這是必填欄位。

這項動作會等待案件標記這個值，然後完成執行。

動作輸出內容

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

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

JSON 結果

以下範例顯示使用 Async 動作時，收到的 JSON 結果輸出：

[{
   "case_id": "123",
   "tags": ["Async"]
}, {
   "case_id": "123",
   "tags": ["Async"]
},]

輸出訊息

Async 動作可能會傳回下列輸出訊息：

輸出訊息訊息說明

輸出訊息	訊息說明
`The following cases have tag TAG: CASE_ID`	動作成功。
`Error executing action "Async Action Example". Reason: ERROR_REASON`	動作失敗。請檢查伺服器連線、輸入參數或憑證。

The following cases have tag TAG: CASE_ID

動作成功。

Error executing action
      "Async Action Example". Reason:
      ERROR_REASON

動作失敗。

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

指令碼執行結果

下表列出使用「Async」動作時，指令碼結果輸出的值：

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

連接器

如要進一步瞭解如何在 Google SecOps 中設定連接器，請參閱「擷取資料 (連接器)」。

整合範例 - 簡易連接器範例

使用整合範例 - 簡易連接器範例，從 api.vatcomply.com 服務擷取貨幣匯率和其他資料。

如要使用動態清單，請使用 alert_type 參數。

連接器輸入

Google Threat Intelligence - DTM Alerts Connector 需要下列參數：

參數	說明
`Product Field Name`	這是必填欄位。儲存產品名稱的欄位名稱。產品名稱主要會影響對應。為簡化及改善連接器的對應程序，預設值會解析為程式碼參照的備用值。如果這個參數的輸入內容無效，預設會解析為備用值。預設值為 `Product Name`。
`Event Field Name`	必要。決定事件名稱 (子類型) 的欄位名稱。預設值為 `event_type`。
`Environment Field Name`	選填。儲存環境名稱的欄位名稱。如果缺少環境欄位，連接器會使用預設值。預設值為 `""`。
`Environment Regex Pattern`	選填。規則運算式模式，用於對 `Environment Field Name` 欄位中的值執行。這個參數可讓您使用規則運算式邏輯，操控環境欄位。使用預設值 `.*` 擷取必要的原始 `Environment Field Name` 值。如果規則運算式模式為空值或空白，或環境值為空值，則最終環境結果為預設環境。
`Script Timeout (Seconds)`	這是必填欄位。執行目前指令碼的 Python 程序逾時限制 (以秒為單位)。預設值為 `180`。
`API Root`	這是必填欄位。整合執行個體的 API 根目錄。在本範例中，我們使用 [VAT Comply](https://www.vatcomply.com/) 服務進行整合，API 根目錄為 `api.vatcomply.com`。預設值為 `http://api.vatcomply.com`。
`Password Field`	選填。 API 密碼欄位範例。這個參數僅供示範之用，API 不需要這個參數即可進行驗證。預設值為 `Google SecOps`。
`Currencies To Fetch`	選填。要擷取的貨幣匯率。預設值為 `USD, EUR`。
`Create Alert Per Exchange Rate`	選填。啟用後，連接器會為每種匯率建立個別快訊。
`Alert Severity`	選填。警告的嚴重性等級。可能的值為： `Critical` `High` `Medium` `Low` `Informational` 預設值為 `Informational`。
`Add Attachment`	選填。啟用後，連接器會在快訊中加入 JSON 物件。預設值為 `True`。
`Max Days Backwards`	這是必填欄位。要擷取幾天前的快訊。最大值為 `30`。預設值為 `1`。
`Max Alerts To Fetch`	這是必填欄位。每次連接器疊代要處理的警告數量。預設值為 `3`。
`Use dynamic list as a blocklist`	這是必填欄位。如果選取，連接器會將動態清單做為封鎖清單。預設為未選取。
`Disable Overflow`	選填。如果選取，連接器會忽略 Google SecOps 溢位機制。預設為選取。
`Verify SSL`	這是必填欄位。如果選取，動作會驗證 API 伺服器的 SSL 憑證。預設為選取。
`Proxy Server Address`	選填。要使用的 Proxy 伺服器位址。
`Proxy Username`	選填。用於驗證的 Proxy 使用者名稱。
`Proxy Password`	選填。用於驗證的 Proxy 密碼。

工作

範例整合允許使用下列工作：

簡易工作範例

簡易工作範例

使用「Simple Job Example」工作自動管理案件。

這項工作有兩項主要功能：

如果案件有 Closed 標記，請關閉案件。
如果案件有 Currency 標記，請新增註解。

工作輸入內容

如要設定這項工作，請使用下列參數：

參數

參數
`API Root`	這是必填欄位。整合執行個體的 API 根目錄。在本範例中，我們使用 [VAT Comply](https://www.vatcomply.com/) 服務進行整合，API 根目錄為 `api.vatcomply.com`。預設值為 `http://api.vatcomply.com`。
`Password Field`	選填。 API 密碼欄位範例。這個參數僅供示範之用，API 不需要這個參數即可進行驗證。預設值為 `Google SecOps`。
`Verify SSL`	這是必填欄位。如果選取，動作會驗證 API 伺服器的 SSL 憑證。預設為選取。

API Root

這是必填欄位。

整合執行個體的 API 根目錄。

在本範例中，我們使用 [VAT Comply](https://www.vatcomply.com/) 服務進行整合，API 根目錄為 `api.vatcomply.com`。

預設值為 http://api.vatcomply.com。

Password Field

選填。

API 密碼欄位範例。

這個參數僅供示範之用，API 不需要這個參數即可進行驗證。

預設值為 Google SecOps。

Verify SSL

這是必填欄位。

如果選取，動作會驗證 API 伺服器的 SSL 憑證。

預設為選取。

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