使用 IDE

支援的服務:

本文說明整合式開發環境 (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 的環境。但支援反向操作,也就是從未啟用資料層的環境,匯出至已啟用資料層的環境。
按一下「隱藏停用項目/顯示全部」切換鈕,即可「顯示」或「隱藏」停用的項目 (動作、連接器)。
新增自訂整合、連接器、動作、工作或管理工具。

新增連接器

如要新增連接器,請按照下列步驟操作:

  1. 按一下「 建立新項目」,然後選取「連接器」。
  2. 輸入名稱和必要的整合項目。
  3. 點選「建立」。
  4. 新增整合詳細資料。
  5. 新增必要參數。
  6. 按一下「Connector」(連接器) 切換鈕,啟用連接器。
  7. 完成後,請點選「儲存」或按下 Ctrl + S。

「詳細資料」分頁提供下列選項:

選項 說明
刪除 僅適用於自訂整合項目。
Play 執行指令碼的測試方法。結果會顯示在「測試」分頁中,偵錯輸出內容則會顯示在「偵錯輸出」部分。
file_json 管理 JSON 範例 在 JSON 範例匯入/匯出對話方塊中,確認已啟用「包括 JSON 結果」。接著,您可以匯入或匯出動作的 JSON 結果範例。
詳細資料輸入使用者提供的輸入內容和其他參數,例如整合名稱。
版本管控 版本管控 - 選取動作/工作/連接器,然後按一下即可查看下列選項: 「另存為新版本」:將物件另存為新版本,並可選擇是否加入註解。查看版本記錄:查看及還原先前的版本。至少儲存一個版本後,才能使用這項功能。按一下「還原」,即可隨時還原為任一舊版本。您必須先點選動作/工作/連接器/管理工具上的「另存為新版本」,才能使用這項功能。
個重複項目 複製項目 (工作、動作、連接器、管理工具)。儲存後,副本會顯示在清單中,且不會有鎖頭圖示。

建立自訂整合項目

  1. 按一下「 建立新項目」,然後選取「整合」。
  2. 輸入名稱並按一下 [建立]。
  3. 從清單中選取已建立的整合項目,並提供下列資訊:
    • 說明:顯示在 Content Hub 中,所有 Google Security Operations 使用者都能看到。
    • SVG 圖示:上傳與整合項目一併顯示的 SVG 圖示。
    • 圖片:上傳 Google SecOps 使用者的 Content Hub 圖片。
    • 程式庫:使用 pip 新增 Python 程式庫。
    • 指令碼依附元件:上傳「.WHL」、「.PY」、「.TAR」或「.GZ」檔案。這些指令碼可為整合作業增添更多功能。
    • 參數:新增可設定的欄位,並定義類型、預設值和必要狀態。
  4. 完成後,請點選「儲存」。

建立工作

如要建立工作,請按照下列步驟操作:

  1. 按一下「 Create New Item」,然後選取「Job」。
  2. 輸入名稱和必要的整合項目。
  3. 點選「建立」。
  4. 選用:新增使用者或指令碼輸入內容的參數。
  5. 按一下「儲存」或按下 Ctrl + S。
  6. 按一下 arrow_right 「Play Item」執行指令碼。
  7. 依序前往「自動化」>「工作排程器」。
  8. 按一下「add 建立新工作」,然後選取剛建立的工作。
  9. 在「Response」>「Jobs Scheduler」中,選擇執行所建立工作 (指令碼) 的所需時間。

建立要在應對手冊中使用的動作

如要為應對手冊建立新動作,請按照下列步驟操作:

  1. 按一下「 建立新項目」,然後選取「動作」。
  2. 輸入名稱和所需整合項目 > 按一下「建立」。
  3. 視需要編輯程式碼。
  4. 如果動作應在 Playbook 中傳回 JSON 結果,請啟用「包括 JSON 結果」。
  5. 選用:新增參數,顯示為輸入欄位。
  6. 啟用動作,然後按一下「儲存」。
  7. 在「Polling Configuration」中,您可以設定逾時時間,以及動作逾時時的預設傳回值。您也可以設定預設值,在動作未於定義的逾時期間內完成時傳回。

現在,您可以在「Playbook」 > 「動作」中使用該動作。

建立自訂管理員

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

  1. 按一下「Create New Item」,然後選取「Manager」。輸入名稱和必要的整合項目。
  2. 點選「建立」。
  3. 視需要編輯程式碼。
  4. 按一下「儲存」。

IDE 自訂程式碼安全防護

為確保執行程式碼環境安全,IDE 中的所有自訂 Python 程式碼都會在沙箱環境中執行。這個環境與主伺服器隔離,並以低權限使用者身分運作。只有在執行一般整合和自動化工作時,才能存取底層作業系統,且僅限於非管理指令和目錄的許可清單。這種沙箱機制可確保安全性,同時提供執行各種 Python 程式碼的彈性。

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