建立自訂動作

支援的國家/地區：

在「建立自訂整合項目」中，您為 Armis 整合項目建立了 Ping 動作。本文說明如何為 Armis 整合建立自訂動作，以擴充實體。並假設您具備 Python 和物件導向程式設計的工作知識。如需先決條件，請參閱 SDK 說明文件和自訂整合程序，並探索 SDK 模組。

建立自訂動作

如要建立自訂動作，請按照下列步驟操作：

  1. 前往「回應」>「IDE」，系統會顯示「IDE」頁面。
  2. 按一下「建立新項目」，然後選取「動作」。輸入名稱並選取整合作業。
  3. 點選「建立」。IDE 會建立新範本，並附上程式碼註解和說明。

Siemplify 動作物件

Siemplify 動作需要執行下列步驟：

  • 物件必須從 SiemplifyAction 類別例項化。
  • 物件必須使用類別的 end 方法，傳回輸出訊息和結果值。

結果值

每項動作都有輸出名稱，代表 SiemplifyAction 的 end 方法傳回的結果值。預設為 is_success，但您可以在整合式開發環境 (IDE) 中變更。您也可以設定動作失敗時的預設傳回值。 舉例來說，如果動作在五分鐘後逾時 (或因任何其他原因失敗)，ScriptResult 會設為 Timeout。

JSON 結果值

您也可以新增 JSON 結果，這有助於在教戰手冊中透視資料或手動分析。方法是使用 SiemplifyAction 結果屬性的 add_result_json 方法，或使用 add_entity_json 方法直接將 JSON 結果附加至實體。

匯入和常數

系統一律會匯入 `SiemplifyAction` 模組中的 `SiemplifyAction` 類別。其他常見的匯入項目包括：

  • SiemplifyUtils 的 output_handler，用於偵錯。
  • add_prefix_to_dict_keys 和 convert_dict_to_json_result_dict：用於轉換資料。
  • EntityTypes，判斷動作將在何種實體上執行。

這項動作也會重複使用在自訂整合程序中建立的 `ArmisManager`，並匯入標準 `json` 程式庫。

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