在 Microsoft Defender 中使用 ISOC 將內容作為程式碼部署

在 Microsoft Defender 中使用整合安全作業中心(ISOC)的儲存庫,透過持續整合與持續交付(CI/CD)來管理與部署安全內容。

儲存庫連線支援以目標為基礎的部署模式。 根據您的租戶設定,您可以將內容部署到工作區,無論是 ISOC 或 Microsoft Sentinel,或是在租戶範圍內部署支援的 Defender 層級內容至 Microsoft Defender 全面偵測回應。

針對工作區的連線支援現有的工作區內容類型及支援的 Defender 層級內容。 以租戶為目標的連線支援 Defender 工作簿與自訂偵測功能。

您可以從 Microsoft Defender 入口網站或支援的外部原始碼控制儲存庫管理內容。 在您的儲存庫中所做的更新會自動部署到所選目標。

Prerequisites

在開始之前,請確保符合以下要求:

  • 您的房客 有資格申請 ISOC。
  • 針對工作區的連線,您有一個 ISOC 工作區,或在資源群組中擁有擁有者角色的既有 Microsoft Sentinel 工作區。 租戶目標連線不需要工作區。
  • 你在 Microsoft Entra ID 中擁有全域管理員角色,負責初始 CI/CD 設定。
  • 您想要部署的自訂內容檔案採用所選部署目標支援的格式。 有關支援格式,請參見 「規劃您的儲存庫內容」。
  • 您用來建立連接的帳戶位於您的家庭租用戶中。 外部身份如 B2B 訪客帳號和委派存取權不被支援。
  • (自訂偵測與 Defender 活頁簿)您擁有符合 ISOC 資格的授權,或包含 Microsoft Defender 全面偵測回應 的等效授權。 欲了解更多資訊,請參閱 「部署自訂偵測規則作為程式碼」。

GitHub 前置條件

在連接 GitHub 之前,請確保:

  • 你有協作者權限存取你的 GitHub 倉庫。
  • GitHub Actions 已啟用。

Azure DevOps 必要條件(僅限工作區)

在連接 Azure DevOps 之前,請確保:

  • 你有 Project 管理員的權限,存取你的 Azure DevOps 儲存庫。
  • 透過 OAuth 的第三方應用程式存取已啟用於 Azure DevOps 應用程式連線政策。
  • 你的 Azure DevOps 連線和你的 ISOC 工作空間在同一個租戶裡。

欲了解更多可部署內容類型的資訊,請參閱 「規劃您的儲存庫內容」。

支援的部署目標與內容類型

建立儲存庫連線時,請選擇您想要部署內容的目標。

部署目標 支援內容
Workspace 目前支援的 Microsoft Sentinel 工作區內容、自訂偵測功能及 Defender 活頁簿
Defender 全面偵測回應 自訂偵測與 Defender 活頁簿

可用的內容類型會根據所選部署目標及租戶資格進行篩選。

以工作區為目標的連線

使用針對工作區的連線將內容部署至ISOC工作區或現有的Microsoft Sentinel工作區。

針對工作區的連線支援現有的 Microsoft Sentinel 儲存庫內容類型及 Defender 層級內容。

以租戶為目標的連線

使用 Defender 全面偵測回應 目標在租戶範圍內部署支援的內容。

以租戶為目標的連線支援 Defender 工作簿與自訂偵測功能。 此部署目標不需要 ISOC 或 Microsoft Sentinel 工作區。

對於沒有工作空間的符合資格租戶,Defender 全面偵測回應 是唯一可用的部署目標。

連接資料庫

使用此程序為工作區或 Microsoft Defender 全面偵測回應 部署目標建立儲存庫連線。 可用的目標取決於您的租戶設定。

每個連線都可以部署其所選目標所支援的內容類型。 針對工作區的連線支援現有的工作區內容類型,包括分析規則、自動化規則、自訂偵測規則、搜尋查詢、解析器、操作手冊及活頁簿。 以租戶為目標的連線支援 Defender 工作簿與自訂偵測功能。

欲了解更多資訊,請參閱「關於 Microsoft Sentinel 內容與解決方案」。

你無法在同一工作區建立與同一個儲存庫及分支的重複連線。

  1. 登入 Microsoft Defender 入口網站。

  2. 請確認你已使用想要用於此連線的憑證登入原始碼控制應用程式。

  3. 在 Defender 入口網站中,選擇「內容管理>儲存庫」。

  4. 選擇新增。

  5. 在 「建立新部署連線 」頁面,輸入連線名稱。

  6. 輸入連線的描述。

  7. 從 Source Control 中,選擇你想連接的儲存庫類型。

  8. 選取授權。

  9. 完成您使用的原始碼控制提供者所需的步驟:

    1. 當提示輸入你的 GitHub 憑證時。

      第一次新增連線時,系統會提示你授權連線至 Microsoft Sentinel。 如果你已經在同一瀏覽器登入 GitHub 帳號,你的 GitHub 憑證會自動被填入。

    2. 在 儲存庫中,選擇你想連接的儲存庫。

    3. 選擇 新增儲存庫。

      當你第一次連接儲存庫時,會開啟一個新的瀏覽器視窗或分頁,並提示你安裝 Azure-Sentinel 應用程式。

    4. 在 GitHub 中,選擇你想安裝 Azure-Sentinel 應用程式的儲存庫。

    5. 安裝 Azure-Sentinel 應用程式。

    6. 返回「 建立新部署連線 」頁面。

    7. 從 「分支」中,選擇您想要連接的分支。

    8. 從 「目標」中選擇部署目標:

      • Workspace 用來將內容部署到 ISOC 或 Microsoft Sentinel 工作區。
      • Defender 全面偵測回應 可在租戶範圍內部署支援的 Defender 層級內容。

      如果您的租戶沒有 ISOC 或 Microsoft Sentinel 工作空間,則只有 Defender 全面偵測回應 目標可用,前提是您的租戶符合 ISOC 資格。

    9. 從 內容類型中選擇您想要部署的內容類型。 可用的內容類型會根據所選目標進行篩選。

      解析器和搜尋查詢都使用 Saved Searches API 來部署內容。 如果你選擇其中一種內容類型,而你的分支包含另一種內容類型,則兩種內容類型都會被部署。

      對於其他內容類型,只有你選擇的內容類型會被部署。

    10. 選取 ,創建。

      例如:

      新的 GitHub 儲存庫連線截圖。

建立連線後,系統會在您的存放庫中產生新的工作流程或管線。 您儲存庫中支援的內容會部署到所選的工作區或 Defender 全面偵測回應 租戶層級目標。

部署時間可能會因你部署的內容量而有所不同。

查看部署狀態

要在 GitHub 查看部署狀態:

  1. 在 GitHub 開啟你的儲存庫。

  2. 選取動作索引標籤。

  3. 選擇工作流程 .yaml 檔案以查看部署日誌與錯誤訊息。

要查看 Azure DevOps 的部署狀態:

  1. 在 Azure DevOps 開啟你的儲存庫。

  2. 選擇「 管線 」標籤。

部署完成後:

  • 工作區層級內容會出現在 Defender 入口網站中對應的 Microsoft Sentinel 體驗中。
  • Defender 層級內容會出現在相應的 Microsoft Defender 體驗中。
  • 存放庫 頁面上的連線詳細資訊會顯示部署狀態、上次部署時間,以及部署記錄的連結。

「儲存庫」頁面提供您可存取的工作區儲存庫部署狀態統一檢視。 您可以在不分別選擇每個工作區的情況下,檢視部署狀態。

例如:

儲存庫連線截圖,顯示部署日誌與狀態。

預設情況下,工作流程只會部署自上次部署以來修改過的內容。 你可以透過更改部署觸發條件、關閉智慧部署,或限制部署只能在特定根目錄中來自訂此行為。

欲了解更多資訊,請參閱 「自訂儲存庫部署」。

編輯內容

建立儲存庫連線後,請在儲存庫中編輯已連接的內容,而不是直接在 Microsoft Defender 編輯。

如果你在 Microsoft Defender 編輯已部署的內容,請將更新的內容匯出回你的原始碼控制倉庫。 否則,下次從儲存庫部署內容時,你的變更可能會被覆寫。

刪除內容

從儲存庫刪除內容並不會自動刪除先前部署到所選目標的內容。

要移除透過儲存庫部署的內容:

  1. 刪除你的儲存庫中的內容。

  2. 從相關的 Microsoft Sentinel 或 Microsoft Defender 介面中刪除對應的已部署內容。

你可以依來源名稱篩選內容,以協助辨識來自資料庫的內容。

依儲存庫來源名稱篩選的分析規則截圖。

移除儲存庫連線

移除儲存庫連線會停止日後將內容部署到所選目標。 先前已部署的內容仍保留在其部署目標中。

要使用 Bicep 檔案,您的儲存庫連線必須更新於 2024 年 11 月 1 日之後。 移除並重新建立舊連線以更新它。

要移除儲存庫連線:

  1. 登入 Microsoft Defender 入口網站。

  2. 選取 「內容管理」>儲存庫。

  3. 選擇你想移除的連線。

  4. 選擇 刪除。

  5. 選擇 「是 」以確認刪除。

移除連線後,先前部署的內容仍會保留在對應的工作區或 Microsoft Defender 體驗中。 移除連線後新增到資料庫的內容不會被部署。

如果你在移除連線時遇到錯誤,請檢查你的原始碼控制儲存庫,確認相關的 GitHub 工作流程或 Azure DevOps 管線已被刪除。

從你的 GitHub 倉庫移除 Microsoft Sentinel 應用程式

在你從 GitHub 倉庫移除 Microsoft Sentinel 應用程式之前,請先從 Microsoft Defender 的 Repositories 頁面移除所有相關的連線。

每個 Microsoft Sentinel 應用程式安裝都有一個獨特的 ID,用於新增或移除連線時的使用。 如果 ID 遺失或更改,請從 Repositories 頁面移除連線,並手動從 GitHub 倉庫移除該工作流程,以防止未來內容部署。