這些範例展示了工作負載需求如何轉化為 MXC 資源權限。 你可以先用 C#、TypeScript 或 Rust 快速入門,然後根據你的工作負載調整設定。
以下的 JSON 使用 MXC 1.0.0 架構的原始形狀。 完整配置包含版本與指令;標示為片段的區段必須整合進現有的配置中。 當你用 C#、TypeScript 或 Rust 撰寫時,請使用對應的 V1 SDK 類型,這些類型不需要特定的結構描述版本。
這些是 Windows 的例子。 用主機上的現有資源取代路徑,審慎授予任何額外工具相依性的權限,並確認你的 SDK 版本和後端是否支援所選的控制項。
執行一個有存放庫範圍的工具
此完整配置使用與快速啟動相同的讀取輸入/寫入輸出模式。 在執行前先建立 C:\src\my-app\input.txt 和 C:\src\mxc-output 目錄。 指令可以讀取來源目錄並寫入輸出目錄,但無法寫入來源目錄,也無法使用網路或使用者介面。
{
"$schema": "https://raw.githubusercontent.com/microsoft/mxc/main/schemas/stable/mxc-config.schema.1.0.0.json",
"version": "1.0.0",
"containment": "process",
"process": {
"commandLine": "C:\\Windows\\System32\\cmd.exe /d /c type input.txt > C:\\src\\mxc-output\\result.txt",
"cwd": "C:\\src\\my-app",
"env": [
"SystemRoot=C:\\Windows",
"LOCALAPPDATA=C:\\src\\mxc-output",
"TEMP=C:\\src\\mxc-output",
"TMP=C:\\src\\mxc-output"
],
"timeout": 30000
},
"filesystem": {
"readonlyPaths": ["C:\\src\\my-app", "C:\\Windows\\System32\\cmd.exe"],
"readwritePaths": ["C:\\src\\mxc-output"]
},
"network": {
"egress": { "default": "deny" },
"ingress": { "default": "deny", "hostLoopback": "deny" }
},
"ui": {
"disable": true,
"clipboard": "none",
"injection": false
}
}
這個例子假設 Windows 安裝在 C:\Windows;請使用你主機上的實際系統目錄。 Windows ProcessContainer 請求若有明確env清單,必須同時包含 SystemRoot 和 LOCALAPPDATA。 當你用建置或分析工具取代指令時,請設定快取和暫存檔案使用專用可寫目錄,而不是授權整個儲存庫的寫入權限。
在更廣泛的授權中保護認證資訊
前述配置允許對 C:\src\my-app 進行讀取權限。 如果該目錄包含環境檔案或秘密目錄,請將此 片段加入其現有 filesystem 區塊,並保留唯讀與可讀寫清單:
{
"deniedPaths": [
"C:\\src\\my-app\\.env",
"C:\\src\\my-app\\secrets"
]
}
這些被拒絕的路徑都在已允許的來源目錄中。 將無關的存放庫和使用者設定檔目錄放在授權範圍之外。
盡可能將秘密存放在已授權的樹狀結構之外。 確認所選後端的允許與拒絕重疊;有些掛載目錄後端會拒絕巢狀拒絕,而非強制執行。
允許直接存取 IP 範圍
此 配置片段取代了該 network 區段。 它允許 TCP 埠 443 外發至核准的 CIDR 範圍,並拒絕其他出口、入口及主機迴路存取。 從可信賴的配置提供核准的範圍,而不是從工作負載接受這些範圍。
{
"network": {
"egress": {
"default": "deny",
"allow": [
{
"to": [{ "cidr": "192.0.2.0/24" }],
"ports": [{ "protocol": "tcp", "port": 443 }]
}
]
},
"ingress": { "default": "deny", "hostLoopback": "deny" }
}
}
192.0.2.0/24 是一個僅供文件記錄的範圍。 用指定服務核准的地址替換。 該規則允許在該埠使用 TCP,而非僅限於 HTTPS、單一主機名稱或單一應用程式服務。 直接主機名稱解析可能需要另外的 DNS 規則。
此範例需要支援直接出口規則的後端與主機。 不要和 runtimeConfig.networkProxy 一起使用。 對於基於主機名稱的 HTTP(S)決策,請改用支援的以 Proxy 為基礎的設定。
使用應用程式提供的代理
你的主機應用程式必須先啟動代理程式,才能啟動工作負載。 此範例設定 MXC 以使用現有代理;它不會實作、啟動或核准代理的請求處理政策。
以下設定片段針對支援作業系統範圍代理強制路徑的 Windows ProcessContainer。 合併到完整設定中,保留指令、檔案系統權限、逾時和使用者介面限制。 將端點和對等節點名稱替換成你目前執行中的代理的端點和對等節點名稱。
{
"containment": "processcontainer",
"network": {
"egress": { "default": "deny" },
"ingress": { "default": "allow", "hostLoopback": "deny" }
},
"runtimeConfig": {
"networkProxy": "http://127.0.0.1:8080"
},
"processContainer": {
"network": {
"allowedProxyPeer": "<package-family-name-or-appcontainer-profile-name>"
}
}
}
allowedProxyPeer 識別代理已安裝的套件或未封裝的 AppContainer 設定檔。 代理必須監聽已設定的迴圈位址與埠口,並符合文件中記載的 Windows 先決條件。 MXC 不會從網址推斷出那個身分識別。
Important
這種 Windows 映射需要 ingress.default: "allow",同時也允許私有網路伺服器流量。
hostLoopback: "deny" 在設定的代理對等端可聯繫時,保持一般主機回送存取關閉。 這個範例不是全入站拒絕的配置。
在強制路徑上,直接上網仍被拒絕。 代理伺服器控制它轉發哪些 HTTP(S) 請求。 沒有 AppContainer 身分的純粹、未封裝主機 Proxy 需要不同且更廣泛的相容性設定;不要移除 allowedProxyPeer,並假設相同的限制仍然存在。
使用對應的 SDK 類型,並在依賴僅限透過 proxy 的存取前先確認支援。 請參閱 ProcessContainer 代理部署選項 以了解 Windows 的前置條件,以及其他後端的 定向網路。
允許可見工具,但不提供廣泛的使用者介面存取權限
對於需要可見視窗與剪貼簿輸入的工作負載,此 配置片段會取代 ui。 它允許視窗操作和剪貼簿讀取,但不支援剪貼簿寫入或合成鍵盤與指標輸入:
{
"ui": {
"disable": false,
"clipboard": "read",
"injection": false
}
}
在 V1 SDK ContainerRequest 中,等效的 UI 屬性為 disable、clipboard 和 allowInputInjection。 僅在工作負載需要時,才允許讀取剪貼簿。 檢查執行時的使用者介面支援,並在每個目標主機上測試所需的限制。
重複使用可感知狀態的沙箱
當指令必須共享環境時,請使用狀態感知執行。 配置並啟動它,執行指令,完成後停止它並取消配置。 在失敗和取消後安排清理,而不只是成功時才安排清理。
狀態感知呼叫會為每個指令使用相位特定的 ProvisionRequest 和獨立的 ExecutionRequest,而非上述完整的一次性設定。 Provisioning 會回傳不透明的 ContainerId;將其原封不動地傳遞給後續階段。 在 .NET 中使用 MxcLifecycle、TypeScript 的生命週期函式(例如 provisionContainer),或 Rust 的 v1::container 函式(例如 provision_container),搭配 V1 生命週期 API 所支援的後端 IsolationSession 或 WSLc。 請參閱生命週期概念、MXC 容器生命週期,以及 .NET、TypeScript 或 Rust SDK 指南以了解具體需求。
在選擇前,先確認每個生命週期後端會強制執行的內容。 IsolationSession 將工作負載的使用者與會話分開,但不套用 MXC 檔案系統、使用者介面或網路過濾,且其請求必須明確允許所有網路流量。 WSLc 網路要麼完全隔離,要麼完全橋接,沒有每個目的地的規則。 詳情請參閱 選擇容器類型 及 後端選擇與設定。
請確認這些範例
針對每個經調整的政策,測試預期行為與試圖濫用的情況:
- 確認可讀取所需輸入,且可寫入所需輸出。
- 確認憑證和無關檔案仍然無法存取。
- 確認直接連線、本地網路連線、回環連線和入站連線是否符合政策。
- 針對透過 Proxy 的存取,確認已核准的請求可成功,而直接連線至網際網路的嘗試會失敗。
- 確認剪貼簿、輸入注入和可見視窗是否符合 UI 政策。
- 確認逾時和清理在成功、失敗和取消後能正常運作。
使用學習模式調查存取權限缺失。 不要自動授予代表執行所觀察到的每個資源。