在 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 內容與解決方案」。
你無法在同一工作區建立與同一個儲存庫及分支的重複連線。
請確認你已使用想要用於此連線的憑證登入原始碼控制應用程式。
在 Defender 入口網站中,選擇「內容管理>儲存庫」。
選擇新增。
在 「建立新部署連線 」頁面,輸入連線名稱。
輸入連線的描述。
從 Source Control 中,選擇你想連接的儲存庫類型。
選取授權。
完成您使用的原始碼控制提供者所需的步驟:
當提示輸入你的 GitHub 憑證時。
第一次新增連線時,系統會提示你授權連線至 Microsoft Sentinel。 如果你已經在同一瀏覽器登入 GitHub 帳號,你的 GitHub 憑證會自動被填入。
在 儲存庫中,選擇你想連接的儲存庫。
選擇 新增儲存庫。
當你第一次連接儲存庫時,會開啟一個新的瀏覽器視窗或分頁,並提示你安裝 Azure-Sentinel 應用程式。
在 GitHub 中,選擇你想安裝 Azure-Sentinel 應用程式的儲存庫。
安裝 Azure-Sentinel 應用程式。
返回「 建立新部署連線 」頁面。
從 「分支」中,選擇您想要連接的分支。
從 「目標」中選擇部署目標:
- Workspace 用來將內容部署到 ISOC 或 Microsoft Sentinel 工作區。
- Defender 全面偵測回應 可在租戶範圍內部署支援的 Defender 層級內容。
如果您的租戶沒有 ISOC 或 Microsoft Sentinel 工作空間,則只有 Defender 全面偵測回應 目標可用,前提是您的租戶符合 ISOC 資格。
從 內容類型中選擇您想要部署的內容類型。 可用的內容類型會根據所選目標進行篩選。
解析器和搜尋查詢都使用 Saved Searches API 來部署內容。 如果你選擇其中一種內容類型,而你的分支包含另一種內容類型,則兩種內容類型都會被部署。
對於其他內容類型,只有你選擇的內容類型會被部署。
選取 ,創建。
例如:
建立連線後,系統會在您的存放庫中產生新的工作流程或管線。 您儲存庫中支援的內容會部署到所選的工作區或 Defender 全面偵測回應 租戶層級目標。
部署時間可能會因你部署的內容量而有所不同。
查看部署狀態
要在 GitHub 查看部署狀態:
在 GitHub 開啟你的儲存庫。
選取動作索引標籤。
選擇工作流程
.yaml檔案以查看部署日誌與錯誤訊息。
要查看 Azure DevOps 的部署狀態:
在 Azure DevOps 開啟你的儲存庫。
選擇「 管線 」標籤。
部署完成後:
- 工作區層級內容會出現在 Defender 入口網站中對應的 Microsoft Sentinel 體驗中。
- Defender 層級內容會出現在相應的 Microsoft Defender 體驗中。
- 存放庫 頁面上的連線詳細資訊會顯示部署狀態、上次部署時間,以及部署記錄的連結。
「儲存庫」頁面提供您可存取的工作區儲存庫部署狀態統一檢視。 您可以在不分別選擇每個工作區的情況下,檢視部署狀態。
例如:
預設情況下,工作流程只會部署自上次部署以來修改過的內容。 你可以透過更改部署觸發條件、關閉智慧部署,或限制部署只能在特定根目錄中來自訂此行為。
欲了解更多資訊,請參閱 「自訂儲存庫部署」。
編輯內容
建立儲存庫連線後,請在儲存庫中編輯已連接的內容,而不是直接在 Microsoft Defender 編輯。
如果你在 Microsoft Defender 編輯已部署的內容,請將更新的內容匯出回你的原始碼控制倉庫。 否則,下次從儲存庫部署內容時,你的變更可能會被覆寫。
刪除內容
從儲存庫刪除內容並不會自動刪除先前部署到所選目標的內容。
要移除透過儲存庫部署的內容:
刪除你的儲存庫中的內容。
從相關的 Microsoft Sentinel 或 Microsoft Defender 介面中刪除對應的已部署內容。
你可以依來源名稱篩選內容,以協助辨識來自資料庫的內容。
移除儲存庫連線
移除儲存庫連線會停止日後將內容部署到所選目標。 先前已部署的內容仍保留在其部署目標中。
要使用 Bicep 檔案,您的儲存庫連線必須更新於 2024 年 11 月 1 日之後。 移除並重新建立舊連線以更新它。
要移除儲存庫連線:
選取 「內容管理」>儲存庫。
選擇你想移除的連線。
選擇 刪除。
選擇 「是 」以確認刪除。
移除連線後,先前部署的內容仍會保留在對應的工作區或 Microsoft Defender 體驗中。 移除連線後新增到資料庫的內容不會被部署。
如果你在移除連線時遇到錯誤,請檢查你的原始碼控制儲存庫,確認相關的 GitHub 工作流程或 Azure DevOps 管線已被刪除。
從你的 GitHub 倉庫移除 Microsoft Sentinel 應用程式
在你從 GitHub 倉庫移除 Microsoft Sentinel 應用程式之前,請先從 Microsoft Defender 的 Repositories 頁面移除所有相關的連線。
每個 Microsoft Sentinel 應用程式安裝都有一個獨特的 ID,用於新增或移除連線時的使用。 如果 ID 遺失或更改,請從 Repositories 頁面移除連線,並手動從 GitHub 倉庫移除該工作流程,以防止未來內容部署。