使用 IDE
支援的服務:
Google SecOps
SOAR
本文說明整合式開發環境 (IDE) 的正式環境模式。IDE 是用於查看、編輯和測試程式碼的架構。您可以查看商業整合的整合代碼,並從頭開始建立自訂整合,或複製商業整合的整合代碼。
IDE 是管理、匯入及匯出自訂整合項目的地方。
開啟 IDE
如要開啟 IDE,請按照下列步驟操作:
- 如要開啟 IDE,請在主選單中依序前往「Automation」>「IDE」。「IDE」頁面隨即開啟。
在「IDE」頁面中,您可以存取下列選項:
| 選項 | 說明 |
|---|---|
| 整合 類型 | 選擇「Integrations」(整合) 或「Types」(類型) (連接器、動作、工作、管理工具)。 |
| 匯出 匯入 | 從整合服務匯出一或多個項目。匯出個別項目時,系統會一併匯出依附項目,但匯出完整套件時則不會。 匯出的檔案是包含 JSON 檔案的 ZIP 封存檔。匯入時,您可以將個別項目新增至現有整合項目,或匯入完整套件。如果是舊版 (V1 - dataplane disabled) 匯出/匯入格式,套件必須包含 integrations.def 檔案和下列資料夾:ActionsDefinitions、ActionsScripts、Dependencies 和 Managers。如果是新的 (V2 - 已啟用 dataplane) 匯出/匯入格式,套件資料夾必須包含 metadata.json 檔案,且可包含下列資料夾:actions、connectors、jobs 和 dependencies。 請注意,您無法從已啟用 dataplane 的環境匯出整合項目,並匯入至未啟用 dataplane 的環境。但支援反向操作,也就是從未啟用資料層的環境,匯出至已啟用資料層的環境。 |
| 按一下「隱藏停用項目/顯示全部」切換鈕,即可「顯示」或「隱藏」停用的項目 (動作、連接器)。 | |
| 新增自訂整合、連接器、動作、工作或管理工具。 |
新增連接器
如要新增連接器,請按照下列步驟操作:
- 按一下「 建立新項目」,然後選取「連接器」。
- 輸入名稱和必要的整合項目。
- 點選「建立」。
- 新增整合詳細資料。
- 新增必要參數。
- 按一下「Connector」(連接器) 切換鈕,啟用連接器。
- 完成後,請點選「儲存」或按下
Ctrl + S。
「詳細資料」分頁提供下列選項:
| 選項 | 說明 |
|---|---|
| 刪除 | 僅適用於自訂整合項目。 |
| Play | 執行指令碼的測試方法。結果會顯示在「測試」分頁中,偵錯輸出內容則會顯示在「偵錯輸出」部分。 |
| file_json 管理 JSON 範例 | 在 JSON 範例匯入/匯出對話方塊中,確認已啟用「包括 JSON 結果」。接著,您可以匯入或匯出動作的 JSON 結果範例。 |
| 詳細資料 | 輸入使用者提供的輸入內容和其他參數,例如整合名稱。 |
| 版本管控 | 版本管控 - 選取動作/工作/連接器,然後按一下即可查看下列選項: 「另存為新版本」:將物件另存為新版本,並可選擇是否加入註解。查看版本記錄:查看及還原先前的版本。至少儲存一個版本後,才能使用這項功能。按一下「還原」,即可隨時還原為任一舊版本。您必須先點選動作/工作/連接器/管理工具上的「另存為新版本」,才能使用這項功能。 |
| 個重複項目 | 複製項目 (工作、動作、連接器、管理工具)。儲存後,副本會顯示在清單中,且不會有鎖頭圖示。 |
建立自訂整合項目
- 按一下「 建立新項目」,然後選取「整合」。
- 輸入名稱並按一下 [建立]。
-
從清單中選取已建立的整合項目,並提供下列資訊:
- 說明:顯示在 Content Hub 中,所有 Google Security Operations 使用者都能看到。
- SVG 圖示:上傳與整合項目一併顯示的 SVG 圖示。
- 圖片:上傳 Google SecOps 使用者的 Content Hub 圖片。
- 程式庫:使用 pip 新增 Python 程式庫。
- 指令碼依附元件:上傳「.WHL」、「.PY」、「.TAR」或「.GZ」檔案。這些指令碼可為整合作業增添更多功能。
- 參數:新增可設定的欄位,並定義類型、預設值和必要狀態。
- 完成後,請點選「儲存」。
建立工作
如要建立工作,請按照下列步驟操作:
- 按一下「 Create New Item」,然後選取「Job」。
- 輸入名稱和必要的整合項目。
- 點選「建立」。
- 選用:新增使用者或指令碼輸入內容的參數。
- 按一下「儲存」或按下
Ctrl + S。 - 按一下 arrow_right 「Play Item」執行指令碼。
- 依序前往「自動化」>「工作排程器」。
- 按一下「add 建立新工作」,然後選取剛建立的工作。
- 在「Response」>「Jobs Scheduler」中,選擇執行所建立工作 (指令碼) 的所需時間。
建立要在應對手冊中使用的動作
如要為應對手冊建立新動作,請按照下列步驟操作:
- 按一下「 建立新項目」,然後選取「動作」。
- 輸入名稱和所需整合項目 > 按一下「建立」。
- 視需要編輯程式碼。
- 如果動作應在 Playbook 中傳回 JSON 結果,請啟用「包括 JSON 結果」。
- 選用:新增參數,顯示為輸入欄位。
- 啟用動作,然後按一下「儲存」。
- 在「Polling Configuration」中,您可以設定逾時時間,以及動作逾時時的預設傳回值。您也可以設定預設值,在動作未於定義的逾時期間內完成時傳回。
現在,您可以在「Playbook」 > 「動作」中使用該動作。
建立自訂管理員
如要建立自訂管理員,請按照下列步驟操作:
- 按一下「Create New Item」,然後選取「Manager」。輸入名稱和必要的整合項目。
- 點選「建立」。
- 視需要編輯程式碼。
- 按一下「儲存」。
IDE 自訂程式碼安全防護
為確保執行程式碼環境安全,IDE 中的所有自訂 Python 程式碼都會在沙箱環境中執行。這個環境與主伺服器隔離,並以低權限使用者身分運作。只有在執行一般整合和自動化工作時,才能存取底層作業系統,且僅限於非管理指令和目錄的許可清單。這種沙箱機制可確保安全性,同時提供執行各種 Python 程式碼的彈性。還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。