透過學習模式建立並精煉 MXC 政策

Microsoft 執行容器(MXC)沙盒預設為拒絕,因此受限的工作負載只能使用其原則所授予的檔案、能力及其他資源。

然而,預測一個工作負載可能需要存取的所有資源並不容易。 MXC 學習模式幫助你在 Windows 上建立最低權限政策,透過記錄工作負載嘗試存取的資源,讓你能從證據中建立或精煉政策,而非靠反覆嘗試。

Note

學習模式目前適用於在 Windows 上運行於 MXC ProcessContainer 上的工作負載。 使用 執行階段偵測 來確認主機是否支援 ProcessContainer。

選擇學習模式的行為

學習模式有兩種運作方式。 它們的差異在於,MXC 是否會在記錄存取情況的同時繼續執行該政策,而這決定了誰應該以及何時使用各自。

特性 拒絕並記錄 允許並記錄
未授予的存取權 已封鎖並已記錄 允許並已記錄
政策執行 強制執行,但 擷取可能會改變隔離層級 預設拒絕在此次執行中已放寬
一般使用者 應用程式開發者與政策撰寫者 評估現有工作負載的 IT 管理員與開發人員
何時使用它 當你開發應用程式及其隱私權政策時 在政策尚未存在之前,先了解可信工作負載存取了什麼
擷取 mode 值 block (預設值) allow

拒絕並記錄:開發應用程式與政策

在開發應用程式或代理及其 MXC 原則時,使用 deny 和 record(learningModeLogging)。 MXC 在錄製期間會持續執行該政策,所以未經授權的存取會如同你的使用者一樣失敗。 學習模式會新增每次遭政策封鎖的存取記錄。 在某些主機上,擷取會改變 MXC 選擇的隔離層級。 詳情請參閱 擷取先決條件計畫。

常見用途包括:

  • 診斷為何 contained 工作負載會失敗,並區分缺少的授權與無關錯誤。
  • 反覆修改原則草案,直到支援的情境成功且負面測試仍失敗為止。
  • 識別工作負載所要求的能力。
  • 讓你的應用程式使用者可以自行調整沙盒。 你的應用程式會記錄被封鎖的內容,並以自己的介面呈現,只有在使用者核准變更後才重新建立政策。

因為MXC持續執行這項政策,拒絕並記錄是較安全的選擇。 只要有可供測試的政策,即使不完整,也要使用。

允許並記錄:在建立原則前評估現有工作負載

當你需要先了解現有且受信任的工作負載會存取什麼,再對其套用 MXC 政策時,請使用 allow and record(permissiveLearningMode) 例如,IT 管理員可以在測試裝置上執行業務應用程式工具或指令碼,處理其典型任務,然後利用結果建立基線原則,再啟動強制執行。 開發者若將現有工具帶入 MXC,也可以用同樣的方法擬定首份政策。

「允許並記錄」會在此次執行中放寬預設拒絕的強制措施,因此應將工作負載視為以使用者的完整權限執行。 MXC 會記錄每一次原本會遭到原則拒絕的存取。 當此模式啟用時,MXC 也會在執行結果中一併回傳安全警告。 你的主機應該顯示該警告,而不是直接丟棄它。

在使用允許並記錄之前:

  • 只在受控的測試裝置或帳號上執行可信程式碼,並使用具代表性的非敏感資料。
  • 執行工作量中常見的任務。 某次執行未涵蓋的存取不會顯示在結果中。
  • 把結果當作起始盤點來處理。 移除不必要的授權,然後在部署前用拒絕和記錄來驗證草案原則。

Important

不要把允許並記錄學習模式暴露為代理可呼叫的生產工具。 必須由受信任的主機程式碼或個人核准其使用及其隨之而來的權限擴展。

擷取先決條件規劃

MXC 透過兩種擷取路徑之一收集學習模式的結果。 它會在執行時根據主機和請求的政策選擇路徑。 這適用於 captureDenials 在任一模式下,以及 wxc-exec.exe --audit 工作流程。

擷取路徑 當 MXC 使用它時 隔離層級 權限
原生擷取 Windows 提供 MXC 所需的程序安全環境與學習模式 API,並能代表所請求的策略 BaseContainer None
受保護擷取 原生擷取無法使用或無法代表所請求的原則 相容的 AppContainer 層級 MXC 啟動一個帶有 elevation 的簽名輔助程式plm.exe,以記錄 Windows 效能記錄器(WPR)的追蹤。 使用者必須核准 UAC 提示或提供管理員憑證。

原生擷取無法表示某些政策,例如 processContainer.leastPrivilege、某些網路代理設定,以及在主機原生不支援這些路徑時的拒絕路徑。 這些請求即使在支援原生擷取的主機上,也會使用受防護擷取。 若兩條路徑皆無法完整保留該策略,MXC 會回傳錯誤,而非削弱策略或跳過捕獲。

要知道請求會使用哪條路徑,請在啟動前,先啟用擷取並探查該請求。 探查程式不會建立容器。

SDK Call 待檢查的結果
.NET MxcContainer.Probe(request) Tier、Probes.NativeCaptureAvailable、Probes.GuardedCaptureAvailable
TypeScript probe(request) tier、probes.nativeCaptureAvailable、probes.guardedCaptureAvailable
Rust v1::probe(Some(&request)) tier、probes.native_capture_available、probes.guarded_capture_available

BaseContainer 層級代表原生擷取。 AppContainer 等級代表有守護的捕獲和提升權限提示。 原生擷取事實項目描述的是主機,而不是您的要求,所以也要檢查等級。

請考量這些差異:

  • 在應用程式中,開始擷取前先探測,並告知使用者何時擷取需要管理員批准。 不要假設擷取程序在每個主機上都是靜默執行的。
  • 當 IT 管理員評估工作負載時,請確認測試裝置是否支援原生擷取,或管理員是否能核准受保護擷取提示視窗。 AppContainer 層也可能需要 主機準備作業。
  • 將捕獲結果視為政策制定的證據。 因為受保護擷取可以在與正式環境不同的層級執行工作負載,建議用不使用擷取的執行來確認最終策略。

範例:透過 MXC SDK 啟用擷取

當你的應用程式承載工作負載時,使用 SDK 擷取功能。 若要在不撰寫主機程式碼的情況下評估工作負載,請參閱 從命令列使用學習模式。

從 SDK 快速入門開始,包括其寫入遭拒案例。 以下片段延續了該範例,並使用相同的工作負載與資源授與。 在 SDK 啟動工作負載前,立即插入所選片段。

範例使用 MXC 1.0 V1 SDK API。 在每個 SDK 中,你會在明確指定的 ProcessContainer 包含範圍選取上設定擷取,這會取代快速啟動中的抽象 process intent。

建立一個主機自有的擷取輸出目錄。 它不需要被其中包含的工作負載寫入。

在請求的明確 ProcessContainer 包含關係中設定擷取選項:

string captureDirectory = Path.GetFullPath("captures");
Directory.CreateDirectory(captureDirectory);

request.Containment = new Containment.ProcessContainer
{
    CaptureDenials = new CaptureDenialsPolicy
    {
        Mode = CaptureDenialsMode.Block,
        OutputPath = Path.Combine(captureDirectory, "denials.json"),
    },
};

在 block 模式下,寫入遭拒的情況仍然失敗。 捕捉拒絕並不代表獲得寫入權限。 對於已核准的允許並記錄執行,只需在 C# 中將模式改為 'allow'、在 TypeScript 中改為 CaptureDenialsMode::Allow,或在 Rust 中改為 CaptureDenialsMode.Allow。

在調整現有整合時,請保留其其他容器設定。 請使用專用的擷取選項,不要使用保留的內部 learningModeLogging 或 permissiveLearningMode 能力名稱。

找到已完成的擷取項目

等待執行與擷取作業完成後再讀取結果。 MXC 會在設定的檔名中插入唯一的執行識別碼,因此 denials.json 會變成類似 denials.<run-id>.json的名稱。 使用回報的路徑,而不是猜測該路徑或掃描最新的檔案。

在 MxcContainer.RunAsync(request) 完成並回報 result.Warnings 後,請檢查結果的中繼資料:

if (result.OutputMetadata?.CaptureDenialsError is { } captureError)
{
    Console.Error.WriteLine($"Denial capture failed: {captureError.Message}");
    return 1;
}

if (result.OutputMetadata?.CaptureDenials is not { } capture)
{
    Console.Error.WriteLine("The run did not produce denial capture metadata.");
    return 1;
}

Console.WriteLine($"Denial document: {capture.OutputPath}");
Console.WriteLine($"Unique denials: {capture.TotalDenials}");
if (capture.DeniedResourcesTruncated)
{
    Console.Error.WriteLine("The capture is incomplete; don't generate a policy from this run.");
    return 1;
}

保留快速入門對退出狀態、超時和 result.Warnings 的處理。 特別是,.NET SDK 會回傳關於寬鬆 Learning Mode 的警告,而非自動將這些警告寫入你的終端機。

如果你使用串流執行,請先完成終端機中的等待程序,再檢查 MxcProcess.OutputMetadata。 在不等待的情況下處置該程序,無法取代擷取完成作業。

拒絕讀取輸出

可操作的 JSON 文件會識別資源、嘗試存取,以及摘要。 對於快速啟動的拒絕寫入情況,代表性條目如下:

{
  "denials": [
    {
      "resource": "C:\\src\\MxcQuickstart\\workspace\\input\\blocked.txt",
      "resourceType": "file",
      "accessType": "write",
      "pid": 1234,
      "filetime": "132847890123456789"
    }
  ],
  "summary": {
    "exitCode": 1,
    "totalDenials": 1,
    "deniedResourcesTruncated": false
  }
}

這份文件是政策制定的證據,不是該工作負載所做一切的完整記錄。 該 resourceType 值決定如何讀取 resource。 例如,一個 file 項目包含一個絕對路徑,而一個 capability 項目包含一個能力名稱,例如 internetClient。 有些觀察無法以政策授權方式表達,單一輸入也無法涵蓋所有程式碼路徑。

在允許模式下,文件目前不包含能力請求。 以 deny 和 record 模式執行工作負載,找出它需要的功能。

如果 deniedResourcesTruncated 是 true,就不要從那次執行中產生策略。 空白文件也不代表工作負載是安全的,或所有預期限制都已套用。

MXC 也會在可操作文件旁寫入一個詳細記錄檔。 範例:denials.<run-id>.json 會產生 denials.<run-id>.verbose.json。 詳細資訊檔案是一個有界且經過遮蔽的診斷記錄,包含 MXC 政策無法執行的觀察值,例如登錄檔寫入。 輸出的元資料不會報告其路徑,因此需從可操作文件的路徑推導其路徑。 使用詳細資訊檔案來調查可採取行動的文件未說明的失敗,而不是把它當作授權清單。

區分拒絕存取與其他失敗

結果 怎麼辦?
MXC 拒絕該配置 檢查結構描述、欄位組合和選擇的後端。 不要給更多存取權來解決無效要求。
後端或擷取功能無法使用。 檢查支援資訊與 擷取的先決條件。 不要默默地停用必要的限制。
工作負載在強制執行時會失敗 檢視其退出狀態、錯誤輸出及已完成的拒絕記錄擷取。 工作負載失敗不一定是資源遭拒。
擷取失敗或內容不完整 即使工作負載成功結束,也要將證據視為不可取得或不完整。

結構化擷取則是收集可處理的文件。 較低階的 ProcessContainer learningMode 設定允許記錄拒絕並記錄事件,但本身並不會收集此文件。 當主機需要取用證據時,請使用擷取。

檢閱觀察到的存取

在更改政策前,請先分類每個結果。 例如:

發現 潛在行動
必要的輸入檔案 新增可涵蓋它的最窄唯讀路徑
必須的輸出或快取 新增任務專屬的讀寫路徑
憑證或無關的使用者檔案 維持拒絕狀態,必要時調整工作量
廣泛的上層目錄 先確定所需的子路徑,而不是授予父層權限
突發的網路、使用者介面或功能要求 在授權存取前,請確認該工作負載為何需要此存取權限
這是 MXC 無法在政策中表達的資源 改變工作負載或選擇能強制執行該需求的後端

觀察到的存取可以來自啟動、探索、選用功能、錯誤處理,或是單一執行中使用的特定輸入。 不要以為每個請求都是必要的。 在快速啟動的負面測試中,被拒絕的寫入是預期結果,而非缺失的權限。

範例:從命令列使用 Learning 模式

要評估工作負載而不撰寫主端程式碼,可以使用 wxc-exec.exe 命令列工具搭配 JSON 設定檔來執行工作負載。 關於設定格式,請參閱 撰寫並驗證 MXC 原則。

安裝 MXC SDK 套件並不會將 wxc-exec.exe 新增到您的 PATH。 從與你 SDK 版本相符的 mxc-release-binaries.zip下載 ,並依照完整路徑執行該工具。 以下範例假設你將壓縮檔解壓到 C:\Tools\Mxc 並使用該 x64 資料夾。 在 Arm64 裝置上,使用 arm64 資料夾。

使用任一行為擷取

選擇 ProcessContainer containment,並新增 captureDenials 到設定的 processContainer 區段。 例如,一位 IT 管理員評估尚未制定原則的工作負載時,可以使用以下模式 allow:

{
  "$schema": "https://raw.githubusercontent.com/microsoft/mxc/main/schemas/stable/mxc-config.schema.1.0.0.json",
  "version": "1.0.0",
  "containment": "processcontainer",
  "process": {
    "commandLine": "C:\\Tools\\Contoso\\ReportTool.exe"
  },
  "processContainer": {
    "captureDenials": {
      "mode": "allow",
      "outputPath": "C:\\MxcAudit\\denials.json"
    }
  }
}

執行前建立輸出目錄,然後將設定檔傳給工具:

C:\Tools\Mxc\x64\wxc-exec.exe audit-config.json

執行結束後,wxc-exec 會寫入一行 JSON 到標準錯誤,包含實際輸出路徑及摘要:

{"type":"captureDenials","outputPath":"C:\\MxcAudit\\denials.<run-id>.json","exitCode":0,"totalDenials":2,"deniedResourcesTruncated":false}

使用回報的路徑來讀取文件。 要驗證處於強制執行狀態的草擬政策,請將你的授權加入設定,並將模式改為 block。

提出調整後的設定

對於開發者主導的政策制定,稽核工作流程會執行允許與記錄擷取,並提出修訂後的設定:

C:\Tools\Mxc\x64\wxc-exec.exe --audit --config <path-to-config>

稽核工作流程會產生拒絕文件、追蹤檔案、來源設定快照,以及一個將觀察到的存取合併到該設定中的 Adjusted_*.json 檔案。 調整後的配置是供審查的提案,而非核准的政策。 當擷取被截斷時,MXC 不會產生它,SDK 擷取則完全不會產生它。

稽核工作流程僅支援 ProcessContainer。 不要將 processContainer.captureDenials 與明確的 --audit 設定合併。 完整的 CLI 與 SDK 介面契約,請參閱 GitHub 上的學習模式功能。

完成學習循環

使用此工作流程從發現階段轉向強制執行政策:

  1. 在啟用學習模式前,先選擇容器模型。
  2. 如果工作負載還沒有政策,且你無法直接寫出一個狹義的政策,可以在受控環境中以「允許並記錄」模式執行。 執行其一般工作。
  3. 根據證據擬定一個狹義政策,並移除廣泛且無關的授權。
  4. 在草擬政策下執行工作負載,並以拒絕與記錄處理,並解決剩餘的拒絕,包括所需的權限。
  5. 重複這個過程,並呈現代表性的成功、失敗和邊緣案例輸入。
  6. 移除所有學習、捕捉與稽核設定,並執行最終的強制執行測試。 Capture 可以改變 MXC 選擇的隔離層級,因此這次執行確認了該策略在生產環境中的行為。

當受支援的工作負載成功且負面測試仍如預期失敗時,停止擴展存取權限。

編碼代理可以協助解釋觀察結果,但務必審查並核准任何資源存取政策的變更。