建立自訂動作

支援的服務:

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

建立自訂動作

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

  1. 依序前往「自動化」>「IDE」。如果使用的是 SOAR 專用平台,請依序前往「Response」>「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 專業人員尋求解答。