建立自訂動作

支援的服務：

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

建立自訂動作

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

  1. 依序前往「Automation」>「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` 類別。其他常見的匯入項目包括：

  • output_handler (來自 SiemplifyUtils) 進行偵錯。
  • add_prefix_to_dict_keys 和 convert_dict_to_json_result_dict：用於轉換資料。
  • EntityTypes：判斷動作要對哪種實體執行。

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

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