MXC 政策描述了工作負載可存取的內容。 先從預設全部拒絕的權限設定開始,只新增特定任務所需的資源,並在你應用程式支援的每個平台上用具代表性的輸入驗證結果。 每個後端也提供啟動工作負載所需的作業系統資源;預設拒絕並不代表程序在沒有系統環境的情況下執行。
將與政策相關的決策保留在可信的應用程式程式碼中。 工具、外掛、腳本或 AI 生成的指令可以報告它的需求,但它不應該選擇自己的隔離模型或擴展自己的存取權限。
了解政策與設定
MXC 將資源權限與執行指令的設定分開:
- 原則設定描述跨平台意圖,例如可讀取路徑、可寫入路徑、網路目的地、UI 存取及逾時。
- 執行 設定會新增指令、工作目錄、環境和容器選擇。
在 V1 SDK 中,ContainerRequest 同時攜帶兩者。 在 .NET 中,從指令建立一個ContainerRequest,設定其原則與執行屬性,然後呼叫MxcContainer.RunAsync或 spawn API。 在 TypeScript 中,將物件傳遞給 ContainerRequest 或 spawn 函式。 在 Rust 裡,建一個 ContainerRequest 結構體並傳給 v1::run 或 spawn 函式。 除非你的工作負載需要特定的後端,否則建議優先使用 Process 抽象容器意圖。
以下語言中立的政策設定描述一個以存放庫為範圍的工作。 它們使用 TypeScript ContainerRequest 屬性名稱;.NET 使用相同的結構,並採用 PascalCase 名稱,例如 ReadonlyPaths,而 Rust 則使用 snake_case 名稱,例如 readonly_paths。 它們不是完整的請求:不包含指令或選擇後端。 建立目錄並更新路徑,再調整它們。
{
"filesystem": {
"readonlyPaths": ["C:\\src\\my-app"],
"readwritePaths": ["C:\\src\\mxc-output"],
"deniedPaths": ["C:\\src\\my-app\\.env"]
},
"network": {
"egress": { "default": "deny" },
"ingress": { "default": "deny", "hostLoopback": "deny" }
},
"ui": {
"disable": true,
"clipboard": "none",
"allowInputInjection": false
},
"timeoutMs": 30000
}
使用SDK類型,而不是將請求屬性複製到原始執行設定中。 這些形狀不同:例如,請求的 timeoutMs 映射到配置的 process.timeout,ui.allowInputInjection 映射到 ui.injection,而 network.runtimeConfig 映射到頂層的 runtimeConfig 區段。 請參閱 SDK 快速入門,以取得完整的 C#、TypeScript 和 Rust 範例。
選擇相容的結構描述
請將這三個問題分開:
| 相容性軸 | 要檢查的事項 |
|---|---|
| SDK 與產品發佈 | 套件提供哪些 API 與執行時元件 |
| 政策結構描述 | 釋出接受的是哪一種具體的組態合約 |
| 主機功能 | 所選環境在執行時可以強制執行哪些限制 |
MXC 1.0 V1 SDK 內部使用穩定的 1.0.0 架構,所以你不需要在 ContainerRequest 中指定架構描述版本。 schema 版本僅適用於你撰寫原始 JSON 執行設定時,例如供 wxc-exec 命令列工具使用的檔案。
原始配置必須宣告一個精確的已註冊 version。 MXC 1.0 接受 1.0.0,目前穩定的結構描述,以及 0.9.0-alpha,最小支援的結構描述。 MXC 會拒絕缺少的版本、早於 0.9.0-alpha 的已淘汰版本(例如 0.8.0-alpha),以及未註冊的拼寫,如 1.0 或 1.0.1。
1.1.0-alpha開發契約在發表前可能會變更,所以不要用它來做生產配置。 選取此項並不代表已啟用實驗性後端。
將 SDK 和同一版本的原生執行時元件放在一起。 請參閱 MXC 架構版本管理 以了解註冊合約。
限定檔案存取
依照工作負載如何使用路徑來分類:
| 存取 | 用它來做 |
|---|---|
| 唯讀 | 原始碼、工具、函式庫與設定,工作負載必須檢查但不得更改 |
| 讀寫 | 任務專屬的輸出、快取或暫存目錄 |
| 否認 | 憑證、無關的存放庫、敏感設定,以及較廣泛授權中的較窄路徑 |
給予最狹窄且可行的路徑。 例如,當指令只寫入測試輸出時,授予一個測試結果目錄而非儲存庫根目錄。 將從環境變數、套件管理器或工具搜尋中發現的路徑視為審查候選路徑,而非自動授權。
包含工具二進位檔、函式庫、設定以及工作負載實際需要的臨時路徑。 SDK 提供檔案系統探索輔助工具,但其結果不屬於經核准的政策。 在新增候選路徑前,請先檢視每一條路徑。
設定工作目錄不會讓你存取該目錄。 明確地將它加入適當的檔案系統清單。
除非你已經用選定的後端測試過,否則避免依賴重疊路徑規則。 後端使用不同的檔案存取機制,有些無法在映射或掛載的目錄中表示拒絕規則。
控制網路存取
除非任務需要,否則請保持拒絕網路存取。 選擇一個由所選後端能夠強制執行的網路模型:
| Model | 用它來做 |
|---|---|
| 無外部存取 | 僅需已授權的本機資源的分析或轉換 |
| 透過 IP/CIDR、通訊協定和連接埠規則進行直接存取 | 需要特定直接連線的任務,例如與已知服務端點的 TCP 連接 |
| HTTP(S) 透過應用程式提供的 Proxy | 代理伺服器控制的請求目的地或應用層級權限 |
方向性網路政策會分隔:
- 從工作負載傳出到網路目的地。
- 從私人或本地網路進入工作負載中的接聽程式。
- 主機回送:工作負載與主機上的服務之間,雙向。
IP/CIDR 和埠規則無法識別應用程式協定或主機名稱。 允許 TCP 埠 443 並不代表連線使用 HTTPS 或只連接到一個命名服務。 當工作負載直接解析目的地時,DNS 請求也可能需要存取權限。
支援的結構會拒絕已停用的網路欄位,如 defaultPolicy、allowedHosts、blockedHosts 和 network.proxy。 改用 egress 和 ingress 方向欄位。 請參閱 網路政策範例。
使用自訂網路代理
你的主機應用程式會在啟動工作負載之前先提供並啟動代理伺服器。 MXC 不會提供或管理生產代理伺服器。 代理伺服器決定允許哪些請求與目的地;MXC 會設定支援的用戶端使用代理伺服器,並套用後端的網路限制。
定向要求利用網路區段的 runtimeConfig.networkProxy 設定來識別具有明確埠口的 HTTP(S) 迴路端點。 在原始執行配置中,此設定為頂層 runtimeConfig.networkProxy。 此端點是執行時設定,而非應用層允許清單。 代理模式需要預設拒絕輸出流量,且無法與直接輸出流量允許或拒絕規則合併使用。
客戶端路由和強制執行不同。 代理環境變數或平台設定會告訴支援代理的 HTTP 用戶端該將請求傳送到哪裡。 僅透過 Proxy 的強制路徑也必須防止直接的網際網路連線;僅靠協作式 Proxy 設定並不足以建立這種限制。
MXC 不會透明地透過 HTTP(S)代理重新導向 SSH、任意的 TCP/UDP 或其他非 HTTP 協定。 主機迴圈與私有網路行為也會因後端而異。 請檢視 自訂代理設定範例 及其前提條件,而非假設同一個片段在所有地方都能運作。
限制對使用者介面的存取
預設情況下,不要讓背景工作負載來建立視窗、讀寫剪貼簿,或注入鍵盤和指標輸入。 只有當 UI 存取權是工作負載預期使用者體驗的一部分時,才可提供 UI 存取權。
輸入注入指的是合成的鍵盤或指標輸入,而非任意的程式碼注入到其他程序。
UI 控制則依主機與後端而異。 利用執行時支援資訊驗證你的安全設計所需的每一項限制。
受限執行
為每個應該在已知時間內完成的代理動作、工具呼叫或腳本設定一個逾時。 只提供程序所需的環境變數,並將秘密資料排除在程序環境與可讀檔案路徑之外。 不要以為省略環境就會建立空的環境:後端預設和 SDK 繼承選項不同。
選擇符合此任務的生命週期。 對於獨立指令,建議使用一次性執行。 只有當指令必須共享已安裝的工具、身份、檔案或作業系統狀態時,才使用狀態感知沙盒。
驗證原則是否有效
在你傳送保單之前:
- 利用你 SDK 的 執行階段探索 功能,並檢查所選後端的前置條件。
- 建立設定並處理政策驗證或後端無法使用錯誤,且不削弱政策。
- 用應有的資源,跑代表性的成功測試案例。
- 執行負面案例,嘗試讀取機密資訊、寫入輸出目錄外、使用未經核准的網路路徑,或存取不允許的使用者介面。
- 使用 學習模式 調查缺少的存取權限,並在更改政策前檢視每個結果。
- 移除所有學習或稽核設定,並執行最後一次強制測試。
當主機無法強制執行必要的控制項時,失敗。 不要默默選擇一個存取範圍更廣的後端,或移除政策欄位來執行工作負載。 成功的解析或啟動並不代表所有預期的限制都成立。