部署 Codex 前,你需要決定它可以存取哪些帳戶、檔案與服務,以及可以執行哪些操作。本指南協助企業管理員將這些決定落實為設定、驗證設定效果,並找出需要額外防護之處。
這些安全建議可協助你授予開發人員使用 Codex 所需的存取權,同時降低意外變更、敏感資料外洩,以及防護措施本身遭到更動的風險。你可以據此選擇符合工作流程與風險管理要求的控制措施,瞭解其限制,並在自己的環境中驗證實際效果。這些措施可搭配組織現有的身分、端點、網路與服務防護措施使用。
你可以從特定任務著手,例如只允許登入公司工作區,也可以從較廣泛的目標著手,例如在保護正式環境的同時讓開發人員使用 Codex。
依工作需求選擇起點:
-
個別設定指南逐一說明各項控制措施,包括設定步驟、驗證項目、還原方式與適用限制。
-
組合設定指南說明如何搭配使用多項控制措施,以及身分管理、原始碼控管、部署等系統中的防護措施,以達成常見的安全目標。
你可以依組織需求調整範例。使用各項設定範例時,請一併閱讀相關說明,確認設定位置、適用的用戶端或環境,以及能控制和無法控制的事項。
擴大部署前,先在測試端點試用設定。確認預期允許的工作流程能順利完成,且刻意限制的操作確實遭到封鎖。根據測試結果調整設定,並向即將使用 Codex 的人員說明限制範圍。
選擇起點
使用頁面大綱開啟下方的章節。
| 你的目標 | 建議從這裡開始 |
|---|---|
| 設定一項特定的控制措施 | 個別設定指南 |
| 讓開發人員使用 Codex,同時保護正式環境 | 讓開發人員使用 Codex,同時保護正式環境 |
| 降低內部程式碼遭公開發布的風險 | 降低內部程式碼遭公開發布的風險 |
| 防止 Codex 更改自身的防護措施 | 防止 Codex 更改自身的防護措施 |
組合設定指南列出各項目標所需的控制措施、外部防護措施與驗證項目。
開始前的準備
-
盤點管理範圍內的用戶端與執行環境:桌面應用程式、CLI、IDE 擴充功能、Codex 雲端、CI 執行器與遠端主機。
-
大規模部署前,先在測試端點試行設定。
-
記錄支援的最低 Codex 版本。權限設定檔允許清單需要 Codex 0.138.0 或更新版本。
-
為每組受管理設定保留可供還原的副本。
-
每次變更後,各測試一個允許的工作流程與一個刻意封鎖的工作流程。
受管理的要求是由管理員強制執行的限制,受管理的預設值則是啟動時使用的值。對於支援的身分驗證、沙盒、核准、MCP、外掛程式、掛鉤與網路限制,請透過要求強制執行。身分驗證要求必須在本機部署或透過 macOS MDM 派送,雲端管理的要求無法強制執行這些限制。請參閱受管理設定與設定參考。
設定應放在哪裡
將範例設定部署至試行群組前,請先依組織需求調整。下列 TOML 區塊是部分政策設定。請將所需設定合併至現有檔案,避免重複定義資料表,並替換範例名稱、網域與路徑。驗證項目說明你應在自己的環境中確認的預期結果。
對於本機 Codex,管理員可在 macOS 與 Linux 的 /etc/codex/requirements.toml 或 Windows 的 %ProgramData%\OpenAI\Codex\requirements.toml 中部署強制要求。在受管理的 macOS 裝置上,MDM 可派送 com.openai.codex:requirements_toml_base64 偏好設定。你也可以在管理控制台的智慧體安全性下設定雲端管理的政策:選取政策與適用的環境或作業系統,然後設定要求。請保護政策檔案及其上層目錄,防止 Codex 使用者修改。一般 config.toml 或受管理的預設設定提供啟動時使用的值,無法強制執行要求。請參閱受管理設定與智慧體安全性。
個別設定指南
選擇所需的控制措施,展開指南即可查看設定、驗證項目、還原方式與適用限制。每驗證一個項目就勾選一次。如果瀏覽器儲存空間可用,進度會儲存在此瀏覽器中。
| 控制項目 | 設定指南 |
|---|---|
| 身分驗證 | 只允許登入公司工作區 |
| 執行階段權限 | 限制權限設定檔與完整存取權 |
| MCP 伺服器 | 只允許已核准的 MCP 伺服器 |
| 監控與稽核 | 監控 Codex 活動 |
| 網路 | 限制網路連線目的地 |
| 檔案與憑證 | 保護機密資料與無關的程式碼庫 |
| 敏感指令 | 要求敏感指令須經核准 |
如果員工必須透過公司的 ChatGPT 工作區登入 Codex,且受管理端點禁止使用個人 ChatGPT 帳戶或 API 金鑰驗證,請使用本指南。
預期結果
在公司管理的裝置上,Codex 只接受透過 ChatGPT 登入公司的 ChatGPT 工作區。
先決條件
-
已取得核准使用的 ChatGPT Enterprise 工作區 UUID。
-
已有可將 Codex 受管理設定派送至端點的方式。
-
已決定禁止在受管理端點使用 API 金鑰驗證。
設定
-
在內部設定程式碼庫中記錄已核准的工作區 UUID。
-
在本機
requirements.toml中加入強制身分驗證要求:allowed_login_methods = ["chatgpt"] allowed_chatgpt_workspaces = ["00000000-0000-0000-0000-000000000000"]第一個設定鍵只允許 ChatGPT 驗證,第二個則將登入範圍限制在已核准的工作區。請將範例 UUID 替換為你的工作區 UUID。請參閱要求設定參考。
-
透過本機
requirements.toml或 macOS MDM 部署要求,所需路徑請參閱設定應放在哪裡。這些身分驗證要求會在載入憑證及擷取雲端政策之前生效。如果放在雲端管理的要求中,Codex 會忽略它們。請防止使用者修改檔案及其上層目錄。舊版managed_config.toml的預設值無法強制執行這項限制。 -
試行期間,請讓使用者登出,或移除先前儲存的個人 Codex 工作階段。請勿假設新政策會讓既有工作階段失效。
-
搭配工作區角色與群組存取權使用登入限制。身分驗證控制可用來登入的身分,RBAC 則控制該身分可使用的 Codex 功能。請參閱身分驗證。
驗證
-
登出 Codex。
-
嘗試使用個人 ChatGPT 帳戶登入。預期結果:登入個人工作區的要求遭拒。
-
嘗試使用 API 金鑰登入 Codex。預期結果:API 金鑰登入遭拒。
-
使用公司帳戶登入已核准的工作區。預期結果:登入成功。
-
重新啟動桌面應用程式、CLI 與 IDE 擴充功能,再次執行上述檢查。
還原
還原先前的本機身分驗證要求,然後重新部署已審查的設定組合。
適用範圍與限制
這項設定只控制受管理端點上的受管理 Codex 用戶端。如果要求是「禁止透過公司資產將 Codex 用於個人用途」,請搭配端點應用程式控制措施與網路政策。
如果開發人員需要唯讀或僅限工作區的存取權,而你希望防止他們選取完整存取權,或透過 --yolo 略過核准與沙盒限制,請使用本指南。
預期結果
使用者只能選取已核准的唯讀或僅限工作區的設定檔,無法選取
danger-full-access、approval_policy = "never"或--yolo。
設定
-
定義已核准的工作區設定檔:
[permissions.corp-workspace] description = "Company workspace access with no unrestricted host access." extends = ":workspace" -
強制執行設定檔與核准政策的使用限制:
allowed_approval_policies = ["on-request", "untrusted"] allowed_approvals_reviewers = ["user"] default_permissions = "corp-workspace" [allowed_permission_profiles] ":read-only" = true "corp-workspace" = true ":danger-full-access" = false允許清單列出所有允許的設定檔。未列入清單或設為 false 的設定檔一律遭拒,包含未來版本新增的設定檔。請參閱設定參考。
-
對於仍使用
sandbox_mode的舊版用戶端,請使用下列設定:allowed_approval_policies = ["on-request", "untrusted"] allowed_sandbox_modes = ["read-only", "workspace-write"] -
將這些設定以管理員強制執行的要求派送,請勿放在使用者可編輯的設定檔中。
-
日後若要允許自動審查,請先測試,再明確加入這個選項。自動審查會改由其他審查者判斷是否允許操作超出限制範圍,無法恢復已移除的限制。請參閱自動審查。
驗證
-
開啟權限選擇器。預期結果:無法選取完整存取權,或選取後遭拒。
-
使用
--dangerously-bypass-approvals-and-sandbox啟動。預期結果:Codex 拒絕啟動或強制使用相容的設定檔。 -
使用
--sandbox danger-full-access --ask-for-approval never啟動。預期結果:啟動遭拒。 -
執行一般工作區任務。預期結果:任務成功,超出限制範圍的操作仍須核准。
還原
還原先前的要求設定組合。除非另有核准的例外情況,否則仍應封鎖不受限制的存取。
適用範圍與限制
這項設定控制 Codex 的執行階段權限,無法移除作業系統帳戶原有的特殊權限。
如果組織需要決定 Codex 可以使用哪些 MCP 伺服器,並強制執行核准清單,請使用本指南。
允許使用伺服器與設定伺服器是兩個獨立步驟。允許清單中的項目只會允許相符的伺服器,不會建立伺服器設定。請另行設定伺服器,使用相符的名稱與身分,並設定其所需的驗證方式。
預期結果
Codex 只會啟用設定中的名稱與身分皆符合企業核准清單的 MCP 伺服器。
設定
-
盤點每台已核准伺服器的負責人、用途、傳輸方式、確切的執行檔或 URL、驗證方式、資料分類,以及具備寫入能力的工具。
-
先拒絕所有伺服器。空白的受管理資料表會停用所有 MCP 伺服器:
[mcp_servers] -
依確切的 URL 新增已核准的 HTTP 伺服器:
[mcp_servers.internal_docs] identity = { url = "https://mcp.example.com/docs" } -
依執行檔與位置引數新增已核准的 stdio 伺服器:
[mcp_servers.internal_build.identity] command = { executable = "/usr/local/bin/company-mcp", args = [ { match = "exact", value = "serve" }, { match = "prefix", value = "--workspace=" }, ] }結構化比對器會檢查執行檔、引數數量與引數順序,但不會限制
cwd、env或env_vars。核准 stdio 伺服器前,你必須能控制其完整的啟動環境。請保護執行檔及其相依項目,並防止不受信任的使用者設定或專案設定指定可能改變伺服器行為的工作目錄或環境。如果無法獨立強制執行這項限制,請勿核准該 stdio 伺服器,改用已審查的 HTTP 伺服器。 -
在
plugins.<plugin>.mcp_servers.<server>下另行新增外掛程式隨附的 MCP 伺服器身分。 -
將核准清單存放在經過審查的設定程式碼庫中,並以管理員強制執行的要求部署。
只有當伺服器的名稱與身分皆符合某個已核准項目時,用戶端才會啟用該伺服器。請參閱受管理設定。
驗證
-
完全依照核准項目設定伺服器。預期結果:伺服器啟動。
-
變更 URL 中的一個字元。預期結果:伺服器遭停用。
-
變更 stdio 引數的數量或順序,或提供不符合已設定引數規則的引數。預期結果:伺服器遭停用。符合允許前置字串的值仍可使用。
-
在用完即可捨棄的受信任專案中,保留相符的執行檔與引數,嘗試以無害的值覆寫
cwd、env與env_vars。單靠身分比對不會拒絕這些覆寫設定。請確認獨立管理啟動環境的控制措施會拒絕不安全的覆寫設定,或確認該 stdio 伺服器仍未獲核准。請勿使用真正的注入攻擊內容。 -
新增未核准的名稱。預期結果:伺服器遭停用。
-
測試外掛程式隨附的伺服器。預期結果:伺服器只有在使用已核准的身分時才能運作。
還原
移除剛新增的項目。若要立即停止所有 MCP 使用活動,請部署空白的 mcp_servers 資料表。
適用範圍與限制
將身分列入允許清單,無法證明伺服器的工具、上游資料、憑證或啟動環境安全無虞。本機 stdio MCP 程序在本機指令沙盒外執行。即使執行檔與引數相符,也無法限制伺服器的存取權,或防止伺服器透過環境設定載入程式碼。請另行審查完整的啟動環境與伺服器權限。請參閱 MCP 身分要求。
如果安全團隊需要瞭解 Codex 在端點與網路中的活動,請使用本指南。你可以彙整執行事件、工具事件、核准決策、工作區稽核記錄與網路日誌,以便調查。
預期結果
安全團隊可以交叉比對 Codex 執行記錄、工具使用決策、核准記錄、工作區稽核記錄與實際的對外網路流量,無須依賴模型對自身行為的描述。
使用四種佐證資料來源
-
Codex OpenTelemetry:執行、API、模型、沙盒、核准與工具事件。
-
受管理的生命週期掛鉤:端點上與工具使用及權限要求相關的記錄。
-
網路代理伺服器或閘道日誌:實際的 DNS/HTTP 目的地與連線結果。
-
Compliance API:工作區層級的稽核與調查記錄。
單一來源無法完整監控網路活動。
設定
-
將 Codex OpenTelemetry 日誌傳送至收集器,並排除提示詞原文:
[otel] environment = "enterprise" log_user_prompt = false [otel.exporter.otlp-http] endpoint = "https://otel.example.com/v1/logs" protocol = "binary" headers = { "x-otlp-api-key" = "${OTLP_TOKEN}" }啟動用戶端前,請透過已核准的機密資料管理工具或程序環境,將
OTLP_TOKEN提供給 Codex 程序。請勿將權杖放入部署的 TOML 檔案或納入原始碼控管。Codex 可傳送對話開始事件、API 要求、串流事件、提示詞中繼資料、工具使用決策與工具結果。請參閱進階設定。
-
在專案本身的設定之外部署 OTel。專案的
.codex/config.toml檔案無法覆寫遙測資料的傳送路徑。 -
為
SessionStart、PreToolUse、PermissionRequest、PostToolUse、Stop與SessionEnd新增受管理的生命週期掛鉤。 -
將掛鉤指令碼安裝在管理員管理的目錄中。如果應忽略使用者、專案與外掛程式的掛鉤,請設定
allow_managed_hooks_only = true。 -
讓沙盒內指令的網路流量通過獨立記錄日誌的代理伺服器。OTel 會記錄工具已執行,代理伺服器則會記錄子程序嘗試連線的目的地。
-
為網頁搜尋、應用程式、連接器、MCP 伺服器、瀏覽器活動與 Codex 雲端另行設定遙測。本機指令的代理伺服器規則不會自動涵蓋這些活動。
-
將 Compliance API 支援的記錄串流至 SIEM,並套用組織自己的資料保留與法律保全措施。請參閱 Compliance API 與稽核事件。
-
交叉比對使用者或服務帳戶、主機或執行器、對話 ID、模型、用戶端版本、權限設定檔、核准決策、目的地與工具名稱。
驗證
在受控的工作階段中執行下列操作:
-
讀取一個允許讀取的檔案。
-
嘗試讀取一個禁止讀取的檔案。
-
執行一項允許的指令。
-
嘗試發出一項應遭封鎖的對外要求。
-
提出核准要求,並收到拒絕決定。
-
結束工作階段。
各資料來源的預期結果:
-
OTel 顯示執行與工具事件。
-
掛鉤顯示工作階段的生命週期。
-
代理伺服器日誌顯示允許與封鎖的目的地。
-
合規資料擷取流程收到支援的記錄。
-
SIEM 將這些記錄與對應的使用者或工作負載建立關聯。
還原
還原先前的設定以停用匯出器與掛鉤。還原遙測設定時,請保留代理伺服器的獨立日誌記錄功能。
適用範圍與限制
請勿承諾 Codex 遙測會擷取所有指令引數、每個輸出位元組或所有網路封包。請記錄每一層實際涵蓋的範圍。
如果 Codex 不應存取網際網路,或只能連線至已核准的目的地,請使用本指南。請依你要設定的環境選擇本機或雲端步驟,並留意兩者的政策適用範圍不同。
預期結果
依所選設定,Codex 無法存取網際網路,或只能連線至已核准的網域。Codex 雲端(舊版)環境還可限制 HTTP 方法。
設定目前版本的 Codex 雲端
-
依信任層級建立不同的環境,例如 no-internet-review、approved-dependencies-build 與 cyber-lab。
-
在環境設定中,關閉允許存取所有公用網際網路資源與啟用套件管理工具網域。
-
需要存取公用網際網路時,在其他允許的網域下新增已核准的確切主機名稱。移除允許連線至未核准公用目的地的 HTTP 機密資料。若要封鎖 VPN 以外的公用網際網路存取,請將該清單留白,並移除允許連線至公用目的地的 HTTP 機密資料。
-
在設定階段儲存設定並測試服務。發布或重新發布環境,然後在新任務中測試能否連線至已核准與未核准的目的地。請另行審查設定指令碼:固定相依項目版本、優先使用已核准的鏡像站,並避免下載未經審查的執行檔。
請參閱連線至服務。目前版本的 Codex 雲端設定未提供舊版的 HTTP 方法選擇器。
設定 Codex 雲端(舊版)
-
不需要智慧體存取網際網路時,請將此功能保持為關閉。舊版雲端預設會在智慧體執行階段封鎖網際網路,但設定指令碼仍可連線以安裝相依項目。
-
智慧體需要存取網際網路時,請將此功能設為開啟,並採用範圍有限的允許清單。先選擇無,再新增確切的網域。
-
對於只需下載的工作流程,僅允許
GET、HEAD與OPTIONS。這會封鎖POST、PUT、PATCH、DELETE與其他方法。請另行審查設定指令碼,因為智慧體執行階段的限制不會管控這些指令碼的網際網路存取。
請參閱舊版智慧體網際網路存取。這些預設選項與 HTTP 方法控制措施僅適用於舊版雲端。
設定本機 Codex
-
在管理員管理的
requirements.toml中定義並選取已核准的網路設定檔,並限制使用者只能使用該設定檔:default_permissions = "corp-build" [allowed_permission_profiles] "corp-build" = true [permissions.corp-build] description = "Workspace access with approved dependency destinations." extends = ":workspace" [permissions.corp-build.network] enabled = true allow_local_binding = false [permissions.corp-build.network.domains] "registry.npmjs.org" = "allow" "pypi.org" = "allow" "files.pythonhosted.org" = "allow" -
依照受管理設定部署已審查的要求設定組合。僅為設定檔命名不會使其生效。
default_permissions會選取該設定檔,允許清單則防止使用者選取其他設定檔。 -
在同一組要求設定中啟用管理員管理的代理伺服器,以強制執行網域限制,防止使用者自行擴大允許範圍。請一併部署代理伺服器與啟用網路的設定檔。如果只啟用設定檔的網路功能,卻未啟用代理伺服器,指令就能直接存取網路,不受設定檔中的網域規則限制:
注意:
[experimental_network]是實驗性設定,未來可能變更。擴大部署前,請在每個支援的本機用戶端版本與作業系統上驗證。Windows 的支援有限,在你的環境中確認限制確實生效後,才能將此政策套用至 Windows 使用者。[experimental_network] enabled = true managed_allowed_domains_only = true [experimental_network.domains] "registry.npmjs.org" = "allow" "pypi.org" = "allow" "files.pythonhosted.org" = "allow" -
除非工作流程需要,否則請勿啟用本機連接埠繫結。請另行設定私有網路目標的存取權。允許某個網域不會自動核准其私有位址。請參閱網路存取要求。
-
請另行設定網頁搜尋、應用程式、MCP 伺服器、瀏覽器活動與 Codex 雲端。本機沙盒規則無法控制這些活動。
驗證
-
向已核准的網域傳送要求,並確認要求成功。
-
向未核准的網域傳送要求,並確認要求遭到封鎖。
-
向 localhost、私有 IP 位址與雲端中繼資料端點傳送要求。確認每項要求都遭到封鎖,除非已明確核准。
-
在 Codex 雲端(舊版)中,嘗試向允許的網域傳送
POST要求。確認只允許GET、HEAD與OPTIONS時,該要求會遭到封鎖。 -
確認代理伺服器或閘道日誌中同時包含獲准與遭拒的要求記錄。
還原
將環境的網際網路存取設回關閉,或還原先前的網域政策。避免還原成不受限制的網際網路存取。
適用範圍與限制
如果指令獲准提升權限並完全脫離沙盒,就可能略過本機指令的代理伺服器。依賴這項限制前,請分別測試一般沙盒指令與已核准提升權限的指令。
即使是允許的網域,也可能代管含有提示注入的內容、遭竄改的套件或不安全的文件。
如果 Codex 需要存取已核准的原始碼目錄,但不應接觸機密資料、.env 檔案、SSH 金鑰與無關的程式碼庫,請使用本指南。以下說明如何限制檔案存取,並減少執行指令時傳入子程序的含憑證環境變數。
預期結果
Codex 可以在已核准的原始碼目錄中工作,但無法讀取常見的機密檔案,也不會繼承大量含有憑證的環境變數。
設定
-
在工作區設定檔中定義禁止讀取的路徑模式:
[permissions.corp-workspace] description = "Workspace edits with secret-bearing paths denied." extends = ":workspace" [permissions.corp-workspace.filesystem] glob_scan_max_depth = 6 [permissions.corp-workspace.filesystem.":workspace_roots"] "**/.env*" = "deny" "**/*.pem" = "deny" "**/*.p12" = "deny" "**/id_*" = "deny" "**/.aws/**" = "deny" "**/.kube/**" = "deny" -
將已知的憑證目錄、簽署金鑰、正式環境設定與相鄰程式碼庫的確切路徑加入禁止存取的範圍。
-
在系統的
/etc/codex/config.toml或使用者的~/.codex/config.toml中,減少執行指令時傳入子程序的環境變數:[shell_environment_policy] inherit = "core" ignore_default_excludes = false [shell_environment_policy.filters] "AWS_*" = "exclude" "AZURE_*" = "exclude" "GITHUB_*" = "exclude" "*_TOKEN" = "exclude" "*_SECRET" = "exclude" "*_PASSWORD" = "exclude"這是使用者可以調整的預設值,無法強制執行。它能減少繼承的變數,但無法防止存取憑證檔案、憑證輔助程式、shell 啟動時載入的內容或其他身分。請參閱進階設定。
-
在管理員管理的
requirements.toml中選取受限設定檔,並只允許使用該設定檔。內建設定檔不會繼承該設定檔對機密檔案的存取限制:default_permissions = "corp-workspace" [allowed_permission_profiles] "corp-workspace" = true ":danger-full-access" = false -
選擇適合雲端環境的憑證傳遞方式:
- 在目前版本的 Codex 雲端中,請使用 HTTP 機密資料傳送憑證至允許的 HTTPS 服務。程式收到的是預留位置。在設定與執行任務期間,若連線至已核准目的地的連接埠 443,代理伺服器會將預留位置替換為實際值。原始憑證不會存入本機程序或檔案。直接設定的環境變數則可由程式存取。請參閱環境變數與網路機密資料。
- 在 Codex 雲端(舊版)中,機密資料可供設定階段進行身分驗證,並會在智慧體執行階段前移除。環境變數則會在整段對話期間保留。請參閱舊版雲端環境。
-
如果智慧體需要驗證身分,請使用獨立的憑證代理服務提供短效憑證,並將憑證的適用範圍限於確切的目標與操作。請參閱建議設定。
驗證
建立下列無害的測試檔案:
.env.test
test-key.pem
.aws/credentials
.kube/config然後要求 Codex 執行下列操作:
-
讀取一般檔案。
-
逐一讀取上述測試檔案。
-
遞迴搜尋機密資料。
-
印出指令執行時的環境變數。
-
讀取相鄰的程式碼庫。
預期結果:一般檔案可成功讀取,禁止存取的檔案與相鄰程式碼庫仍無法存取,已排除的變數也不會出現在指令的執行環境中。
還原
還原先前的設定檔。調查工作流程失敗的原因時,請保留對可高度確定含有機密資料的檔案所設的讀取限制。
適用範圍與限制
檔案系統的存取限制無法移除已貼入提示詞、已提交至可讀取的原始碼、由連接器傳回,或已寫入模型可存取日誌的機密資料。
如果 git push、部署、資料庫遷移、雲端 CLI 指令等操作必須經過核准才能執行,請使用本指南。先決定哪些指令應提示審查、哪些必須禁止,再為這些指令設定規則。
預期結果
即使模型判斷敏感指令適合執行,這些指令仍一律會暫停等候核准,或遭到禁止。
設定
- 決定哪些指令應提示核准、哪些應禁止執行。
| 指令類別 | 處理方式 |
|---|---|
git push、git commit |
提示核准 |
terraform apply |
提示核准 |
kubectl apply/delete/patch |
提示核准 |
| 資料庫遷移 | 提示核准 |
| 破壞性的主機指令 | 禁止執行 |
-
新增由管理員強制執行的指令規則:
[rules] prefix_rules = [ { pattern = [{ token = "git" }, { any_of = ["push", "commit"] }], decision = "prompt", justification = "Require review before mutating shared Git state." }, { pattern = [{ token = "terraform" }, { token = "apply" }], decision = "prompt", justification = "Require review before infrastructure changes." }, { pattern = [{ token = "kubectl" }, { any_of = ["apply", "delete", "patch"] }], decision = "prompt", justification = "Require review before Kubernetes changes." }, { pattern = [{ token = "rm" }], decision = "forbidden", justification = "Destructive removal is not permitted in managed Codex workflows." }, ]要求設定中的規則可以要求提示核准或禁止指令,但不能直接允許指令。請參閱受管理設定。
-
對於高風險設定檔,如果 shell 包裝程式可能掩蓋敏感指令,請在同一個
prefix_rules陣列中加入 shell 包裝程式規則:{ pattern = [{ any_of = ["bash", "sh", "zsh"] }], decision = "prompt", justification = "Review shell wrappers that could obscure sensitive commands." },這項規則會頻繁觸發提示,請視需要使用。
-
如果指令必須由人員核准,請強制執行下列設定:
allowed_approval_policies = ["on-request", "untrusted"] allowed_approvals_reviewers = ["user"]自動審查會改變負責審查的對象,無法保證每次都能做出安全的決定。請參閱自動審查。
-
將 PermissionRequest、工具使用決策與工具結果事件傳送至安全事件處理流程。
驗證
-
執行
git status。預期結果:不會出現核准提示。 -
執行
git push。預期結果:出現核准提示。 -
執行
terraform apply。預期結果:出現核准提示。 -
執行
kubectl delete pod test。預期結果:出現核准提示。 -
執行
rm -rf test-directory。預期結果:指令遭到禁止。 -
拒絕一項核准要求。預期結果:指令未執行,且日誌記錄了拒絕決定。
-
重新啟動用戶端並再次執行檢查。預期結果:規則仍然生效。
還原
還原先前的要求設定組合。如果指令詞元的比對範圍過廣,請縮小比對範圍,避免移除整類敏感指令的規則。
適用範圍與限制
前置比對規則無法涵蓋完整的作業系統政策。請搭配沙盒、最小權限的作業系統帳戶、網路限制、雲端 IAM、分支保護、部署核准與資料庫授權使用。
企業安全目標的組合設定指南
以下範例說明如何搭配使用各項控制措施,以達成常見的企業安全目標。請在管理範圍內的每個用戶端與環境中測試設定。
採用的個別設定指南: 限制權限設定檔與完整存取權、保護機密資料與無關的程式碼庫、要求敏感指令須經核准。
開發人員已獲授權存取正式環境。你希望 Codex 能協助開發,同時防止它在未經審查的情況下變更正式環境。
-
定義已核准的工作區設定檔,並強制限制可使用的設定檔與核准政策。將這些設定以管理員強制執行的要求派送,防止使用者覆寫。
-
以另一個權限較低的身分執行 Codex,或在無法存取或取得正式環境寫入憑證的環境中執行。開發人員仍可透過另外授權的工作流程存取正式環境。
-
盡量減少執行指令時傳入子程序的環境變數。如果智慧體需要驗證身分,請使用獨立的憑證代理服務提供短效憑證,並將憑證的適用範圍限於確切的目標與操作。
-
決定哪些指令應提示核准、哪些應禁止執行。指定影響重大的指令須由人員核准,例如
git push、terraform apply、Kubernetes 變更與資料庫遷移。對於絕不能執行的指令,請明確禁止。 -
在 Codex 之外獨立強制執行正式環境 IAM、分支保護與部署核准。
限制權限設定檔並要求由人員審查
在管理員管理的 requirements.toml 中,允許使用內建的工作區與唯讀設定檔,並要求需核准的操作由使用者審查:
allowed_approval_policies = ["on-request"]
allowed_approvals_reviewers = ["user"]
default_permissions = ":workspace"
[allowed_permission_profiles]
":read-only" = true
":workspace" = true工作區設定檔允許在沙盒內操作工作區。權限需求較少的任務可使用唯讀設定檔。完整存取權設定檔未列入允許清單。
如果用戶端需要明確指定相容的選項,請在用戶端設定中加入 approval_policy = "on-request"。on-request 允許在需要時提示核准,不會針對每項指令都發出提示。請為需要審查的操作加入明確規則,並保留正式環境的獨立授權機制。
受管理的設定檔允許清單需要 Codex 0.138.0 或更新版本。對於較舊的用戶端,請依文件使用並測試舊版沙盒模式的要求設定。
重新啟動每個試行用戶端,確認已核准的設定檔能正常運作,並確認不允許的完整存取權設定檔會遭拒。
將 Codex 身分與正式環境憑證分開
在裝置管理或開發環境佈建系統中,建立專供 Codex 使用的使用者帳戶、容器或開發主機,只授予存取必要原始碼與開發服務的權限。請勿將開發人員的正式環境憑證檔案、權杖輔助程式或鑰匙圈掛載至該環境,並防止該身分取得具備正式環境寫入權限的角色。
如果智慧體需要存取服務,請設定組織的憑證代理服務,使其簽發僅適用於指定開發資源與操作的短效憑證。開發人員仍可使用平常的身分,透過另外授權的正式環境工作流程執行操作。
例如,在 AWS IAM 中開啟角色,選取 Codex 開發角色,然後在權限下新增已審查的內嵌政策。以下列政策為例,請將帳戶與角色替換為你自己的值:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "DenyAssumeExampleProductionRole",
"Effect": "Deny",
"Action": "sts:AssumeRole",
"Resource": "arn:aws:iam::111122223333:role/ExampleProductionRole"
}
]
}此範例會拒絕擔任指定角色的要求,但不會拒絕擔任其他角色的要求。也請移除直接授予的正式環境權限、限制其他正式環境角色與憑證來源,並審查信任政策與組織層級的控制措施。
選取具代表性的開發與正式環境權限來測試開發角色,測試時請勿變更正式環境。請參閱 AWS IAM 角色政策範例。
減少 shell 環境中的變數
若要設定全系統的啟動預設值,請使用 /etc/codex/config.toml。若只要設定一位使用者,請使用 ~/.codex/config.toml。在該檔案中指定執行指令時子程序可繼承的環境變數:
[shell_environment_policy]
inherit = "core"
ignore_default_excludes = false
[shell_environment_policy.filters]
"AWS_*" = "exclude"
"AZURE_*" = "exclude"
"GITHUB_*" = "exclude"
"*_TOKEN" = "exclude"
"*_SECRET" = "exclude"
"*_PASSWORD" = "exclude"這項預設值可以調整,無法強制限制憑證存取。使用者設定、shell 啟動時載入的內容或快照、憑證輔助程式及其他憑證來源仍可能暴露憑證。
如果工作流程允許,可在 requirements.toml 中使用下列選用限制,停用登入 shell 與 shell 快照:
allow_login_shell = false
[features]
shell_snapshot = false請先試行這些設定,因為部分工作流程依賴登入 shell 的初始化程序。
使用符合篩選規則的無害模擬變數啟動 Codex,並檢查執行指令時子程序的環境。如果已停用登入 shell,也請確認啟動登入 shell 的要求會遭拒。另行確認執行指令的身分無法存取真正的正式環境憑證。請參閱 shell 環境政策。
針對指定的高影響指令提示核准
針對組織使用的指令新增強制規則。例如:
[rules]
prefix_rules = [
{ pattern = [{ token = "git" }, { token = "push" }], decision = "prompt", justification = "Review Git pushes." },
{ pattern = [{ token = "terraform" }, { token = "apply" }], decision = "prompt", justification = "Review infrastructure changes." },
{ pattern = [{ token = "kubectl" }, { any_of = ["apply", "delete", "patch"] }], decision = "prompt", justification = "Review cluster changes." },
{ pattern = [{ token = "python3" }, { token = "manage.py" }, { token = "migrate" }], decision = "prompt", justification = "Review database migrations." },
]對於絕不能執行的指令,請使用 forbidden。請依實際使用的部署與遷移工具替換或新增比對模式。
這些規則會比對指令開頭,無法涵蓋所有等效操作。請分別測試絕對路徑、包裝程式、不同的引數順序、其他用戶端與其他工具。
在用完即可捨棄的目標上執行一般指令,要求執行清單中的操作,拒絕核准要求,並確認該操作未執行。請參閱強制執行指令規則。
在 Codex 之外強制執行程式碼庫與部署核准
在原始碼控管平台中保護 main 等正式環境分支。要求變更須經審查、取得必要核准並通過狀態檢查,同時審查哪些角色可以略過這些要求。在對應的部署系統中設定部署核准,並在資料庫本身設定資料庫權限。
使用用完即可捨棄的程式碼庫,確認經審查的變更可以套用,且未經授權的直接推送會遭拒。無論操作是否透過 Codex 提出,這些控制措施都適用。
驗證
在用完即可捨棄的測試目標上:
-
執行一般工作區任務。預期結果:任務成功。
-
嘗試執行一項具代表性的敏感指令,並拒絕核准要求。預期結果:遭拒的指令未執行。
-
確認 Codex 身分無法取得正式環境的寫入權限。
-
重新啟動用戶端並再次執行檢查。
適用範圍與限制
前置比對規則無法涵蓋完整的作業系統政策。請搭配沙盒、最小權限的作業系統帳戶、網路限制、雲端 IAM、分支保護、部署核准與資料庫授權使用。
採用的個別設定指南: 保護機密資料與無關的程式碼庫、限制網路連線目的地、只允許已核准的 MCP 伺服器、要求敏感指令須經核准。
開發人員使用 Codex 處理內部程式碼庫,而你希望降低程式碼遭推送到公開程式碼庫、以公開程式碼片段發布,或傳送至其他未核准目的地的風險。
-
將已知憑證目錄與無關程式碼庫的確切路徑加入禁止存取的範圍,並盡量減少執行指令時傳入子程序的環境變數。
-
智慧體需要存取網際網路時,請使用範圍有限的已核准網域允許清單。只允許已核准的 MCP 伺服器名稱與身分,並針對
git push等指定的發布指令要求審查,或禁止執行。 -
使用原始碼控管平台的掛鉤與權限、公開程式碼庫與程式碼片段的相關政策,以及適合組織的資料外洩防護措施。
禁止存取無關的程式碼庫與憑證檔案
在管理員管理的 requirements.toml 中,加入本機智慧體禁止讀取的確切路徑:
[permissions.filesystem]
deny_read = ["~/.ssh", "~/.aws/credentials", "~/.kube/config", "/work/unrelated-repository"]請將範例替換為受管理裝置上的實際路徑。這項受管理的限制適用於所有允許的權限設定檔。如果只在一個自訂設定檔中禁止讀取,選用其他設定檔的使用者就不受保護。請優先指定已知的確切路徑。如果使用 glob 模式,請在需要涵蓋的各個目錄深度進行測試。
在原生 Windows 環境中,受管理的 deny_read 涵蓋直接操作檔案的工具,但單靠這項設定無法防止 shell 子程序讀取檔案。請一併使用作業系統身分與檔案存取控制清單。
在禁止讀取的位置建立無害的測試檔案。在每個允許的設定檔下,確認直接讀取或透過 shell 讀取這些檔案都會遭拒,且已核准的原始碼檔案可正常讀取。請參閱受管理的禁止讀取要求。
減少含有憑證的 shell 變數
在 /etc/codex/config.toml 或 ~/.codex/config.toml 中限制可繼承的環境變數:
[shell_environment_policy]
inherit = "core"
ignore_default_excludes = false
[shell_environment_policy.filters]
"AWS_*" = "exclude"
"AZURE_*" = "exclude"
"GITHUB_*" = "exclude"
"*_TOKEN" = "exclude"
"*_SECRET" = "exclude"
"*_PASSWORD" = "exclude"這項設定會減少繼承的變數,但使用者可以調整設定,且它無法防止存取憑證檔案、憑證輔助程式、shell 啟動時載入的內容或其他身分。
視情況需要,管理員也可以在 requirements.toml 中加入下列限制,並先行試用以評估對開發人員工作流程的影響:
allow_login_shell = false
[features]
shell_snapshot = false使用模擬的測試變數與獨立的最小權限執行身分進行測試。請勿使用真正的憑證。請參閱 shell 環境政策。
只允許本機指令連線至已核准的網路目的地
如果本機沙盒內的指令需要存取網路,請將以下設定檔與受管理代理伺服器的設定一併合併至 requirements.toml,並將網域替換為已核准的端點:
default_permissions = "corp_network"
[allowed_permission_profiles]
corp_network = true
[permissions.corp_network]
extends = ":workspace"
[permissions.corp_network.network]
enabled = true
[experimental_network]
enabled = true
managed_allowed_domains_only = true
[experimental_network.domains]
"git.corp.example" = "allow"
"registry.corp.example" = "allow"啟用網路的設定檔讓沙盒內的指令可以連線,受管理的代理伺服器則限制連線目的地。請一併部署兩者。如果啟用網路的設定檔未搭配指定的受管理代理伺服器,就不會套用相同的目的地限制。若無須存取網際網路,請保持停用網路存取。
請勿將標準的 domains 資料表與舊版 allowed_domains 或 denied_domains 設定混用。請遷移並測試現有政策。
重新啟動用戶端,確認已核准的端點可以連線,而未核准的端點會遭到封鎖。
這些設定仍屬實驗性質。請驗證作業系統與用戶端是否支援。如果已核准的主機解析為私有位址,請另行設定私有網路存取權。如果指令獲准提升權限並完全脫離沙盒,就可能略過指令的代理伺服器。
這項針對本機指令的網路控制措施本身不涵蓋網頁搜尋、應用程式、MCP 伺服器、瀏覽器活動或雲端環境,這些項目需要個別政策。已核准的代管服務網域也可能包含公開程式碼庫或公開程式碼片段,因此單靠目的地允許清單無法保護內容。請參閱網路存取要求。
另行設定雲端環境的網路存取
在目前版本的 Codex 雲端介面中開啟環境設定。關閉允許存取所有公用網際網路資源與啟用套件管理工具網域。如果需要存取公用網際網路,在其他允許的網域下新增已核准的確切主機名稱。移除允許連線至未核准公用目的地的 HTTP 機密資料。若要封鎖 VPN 以外的公用網際網路存取,請將該清單留白,並移除允許連線至公用目的地的 HTTP 機密資料。儲存設定、發布或重新發布環境,然後測試新任務。
請另行審查服務的身分驗證方式與功能。
舊版 Codex 雲端在每個環境中另有智慧體網際網路存取設定,可控制允許的網域與 HTTP 方法。設定指令碼的網路存取行為則有所不同。
請測試實際使用的環境版本。請參閱連線至服務與舊版網際網路設定。
限制 MCP 伺服器,並在 Git 推送前提示核准
在 requirements.toml 中只允許已核准的本機 MCP 伺服器身分。例如:
[mcp_servers.internal]
identity = { url = "https://mcp.corp.example/mcp" }在使用者設定或受管理預設設定的 config.toml 中另行設定實際的伺服器,使用相符的名稱與 URL,並設定伺服器所需的身分驗證方式:
[mcp_servers.internal]
url = "https://mcp.corp.example/mcp"這項要求僅允許使用相符的伺服器,不會建立該伺服器。請審查伺服器本身的存取權與工具。
確認已核准的伺服器可以連線,且名稱或 URL 不同的伺服器不被允許。
新增受管理的指令規則,要求執行具代表性的發布指令前先經過審查:
[rules]
prefix_rules = [
{ pattern = [{ token = "git" }, { token = "push" }], decision = "prompt", justification = "Review the destination before publishing." },
]如果必須由人員審查,請一併將 allowed_approval_policies = ["on-request"] 與 allowed_approvals_reviewers = ["user"] 設為最上層要求。
拒絕一次測試推送,並確認推送未執行。
前置比對無法涵蓋所有包裝程式、API 用戶端、應用程式或其他發布途徑。
透過原始碼控管與 DLP 措施限制公開發布
如果原始碼控管平台支援,請限制建立公開程式碼庫,並限制可變更程式碼庫公開範圍的人員。審查具特殊權限的使用者是否有權略過限制。請另行檢查個人帳戶、程式碼片段、外部組織與權杖存取權,因為組織設定無法管控所有目的地。
在相關程式碼庫中要求變更須經審查,並審查分支保護設定與可略過限制的權限。
在組織的資料外洩防護(DLP)控制台中,針對敏感原始碼內容,以及 DLP 產品實際涵蓋的上傳或程式碼庫管道設定試行政策。將處理動作設為封鎖,並使用不具執行效果的模擬標記進行測試。
如果原始碼控管平台支援伺服器端控制措施,請為接收推送的程式碼庫設定已審查的掛鉤,並強制執行。
使用已授權的測試目的地,確認在任何內容發布前就會封鎖操作。
驗證
-
建立無害的測試檔案,並確認讀取禁止存取的檔案時會失敗。
-
如果已啟用網路存取,確認可以連線至已核准的目的地,而未核准的目的地會遭到封鎖。如果未啟用網路存取,則確認網路要求會遭到封鎖。
-
使用無害的標記,以及用完即可捨棄的測試帳戶或目的地,確認具代表性的公開發布嘗試都會在發布前遭到封鎖。
適用範圍與限制
允許的網域仍可能代管公開內容。請另行設定網頁搜尋、應用程式、MCP 伺服器、瀏覽器活動與 Codex 雲端。本機沙盒規則無法控制這些活動。
採用的個別設定指南: 限制權限設定檔與完整存取權、只允許已核准的 MCP 伺服器、限制網路連線目的地、保護機密資料與無關的程式碼庫、要求敏感指令須經核准。
你希望 Codex 在程式碼庫中工作,或使用者變更本機設定時,原本對 Codex 的限制仍然有效。
-
將支援的權限、核准、MCP、網路與指令限制,以管理員強制執行的要求派送。
-
將掛鉤指令碼安裝在管理員管理的目錄中。如果應忽略使用者、專案與外掛程式的掛鉤,請設定為只使用受管理的掛鉤。
-
使用作業系統與裝置管理的控制措施,保護政策檔案與設定派送途徑。執行 Codex 的身分不應具備更改這些防護措施所需的權限。
-
審查管理範圍內每個用戶端與環境實際生效的設定。
強制限制可使用的設定檔、核准方式、伺服器身分與指令
請將已審查的設定合併至管理員管理的 requirements.toml,避免依賴使用者或程式碼庫中可編輯的設定。例如:
allowed_approval_policies = ["on-request"]
allowed_approvals_reviewers = ["user"]
default_permissions = ":workspace"
[allowed_permission_profiles]
":read-only" = true
":workspace" = true
[mcp_servers.internal]
identity = { url = "https://mcp.corp.example/mcp" }
[rules]
prefix_rules = [
{ pattern = [{ token = "git" }, { token = "push" }], decision = "prompt", justification = "Review Git pushes." },
]此範例允許使用兩個設定檔,要求需核准的操作由人員審查,允許相符的 MCP 身分,並針對以指定詞元開頭的指令提示核准。
請另行設定 MCP 伺服器本身,並加入組織其他敏感指令的比對模式。視需要加入全域檔案限制與網路限制。要求設定可限制支援的設定項目,但無法取代 Codex 之外的身分、服務與目的地控制措施。
受管理的設定檔允許清單需要 Codex 0.138.0 或更新版本。
在試行用戶端上,嘗試選取不允許的設定檔、變更受限的使用者或專案設定,以及使用未列入允許清單的 MCP 身分。確認每項嘗試都遭拒,或在重新啟動後仍受限制。拒絕測試指令的核准要求,並確認指令未執行。
新增受管理的檔案系統與網路限制
若要禁止所有允許的設定檔讀取本機敏感檔案,請在 requirements.toml 中加入下列資料表,並將範例替換為組織使用的路徑:
[permissions.filesystem]
deny_read = ["~/.ssh", "~/.aws/credentials", "~/.kube/config"]如果本機沙盒內的指令需要存取網路,請一併定義允許使用且已啟用網路的設定檔,以及受管理的目的地:
default_permissions = "corp_network"
[allowed_permission_profiles]
corp_network = true
[permissions.corp_network]
extends = ":workspace"
[permissions.corp_network.network]
enabled = true
[experimental_network]
enabled = true
managed_allowed_domains_only = true
[experimental_network.domains]
"git.corp.example" = "allow"選用這項設定檔政策以取代先前的 :workspace 預設值,或依需求將兩個設定檔名稱合併至政策中。請勿貼入重複的設定鍵或資料表。如果指令無須存取網路,請保持停用網路存取。
使用無害的檔案確認指定的確切路徑無法讀取,並驗證已核准與未核准目的地的連線結果。
在原生 Windows 環境中,請一併使用檔案存取控制清單,因為單靠受管理的 deny_read 無法涵蓋 shell 子程序的讀取操作。
本機指令的網路設定無法管控其他用戶端、應用程式、連接器或雲端執行活動。
安裝並強制使用管理員管理的掛鉤
請管理員將已審查的掛鉤程式安裝至由 root 管理的目錄,例如將程式放在 /etc/codex/hooks/pre_tool_use_policy.py,並防止 Codex 使用者修改該檔案或其所在目錄。在 requirements.toml 中啟用掛鉤,並忽略使用者、專案、工作階段與外掛程式的掛鉤:
allow_managed_hooks_only = true
[features]
hooks = true
[hooks]
managed_dir = "/etc/codex/hooks"
[[hooks.PreToolUse]]
matcher = "^Bash$"
[[hooks.PreToolUse.hooks]]
type = "command"
command = "/usr/bin/python3 /etc/codex/hooks/pre_tool_use_policy.py"
timeout = 30
statusMessage = "Checking managed Bash command"這項要求只會註冊掛鉤,不會安裝掛鉤。若要在本機 macOS 上進行整合測試,請將以下內容儲存為 pre_tool_use_policy.py,並請管理員使用下列指令安裝。
這個掛鉤只會封鎖含有模擬標記的指令。正式依賴它之前,請替換為符合組織需求且經過審查的政策。確認目標裝置上存在 /usr/bin/python3,並視需要調整直譯器路徑:
1
2
3
4
5
6
7
8import json
import sys
event = json.load(sys.stdin)
command = event.get("tool_input", {}).get("command", "")
if "CODEX_HOOK_TEST_DENY" in command:
print("Synthetic test command blocked by managed hook.", file=sys.stderr)
sys.exit(2)sudo install -d -o root -g wheel -m 755 /etc/codex/hooks
sudo install -o root -g wheel -m 644 ./pre_tool_use_policy.py /etc/codex/hooks/pre_tool_use_policy.py重新啟動本機用戶端,然後:
-
確認無害的 Bash 指令可以執行。
-
確認含有
CODEX_HOOK_TEST_DENY的指令會遭到封鎖。 -
確認 Codex 使用者無法變更政策及其相依項目。
allow_managed_hooks_only 會略過使用者、專案、工作階段與外掛程式中所有不受管理的掛鉤,因此可能影響其他工作流程。
Bash 比對器無法涵蓋每種工具,也無法涵蓋稍後提供給既有程序的所有輸入。如果發生錯誤、逾時,或掛鉤傳回的回應格式不正確,工具呼叫仍可能繼續執行。
由雲端協調執行的「工作」模式支援不同的掛鉤處理常式。請保留獨立的作業系統與服務防護措施。請參閱受管理的掛鉤與掛鉤行為。
保護政策及其派送途徑
在 macOS 上,管理員可將已審查並合併的要求設定檔部署至由 root 擁有的上層目錄,並防止 Codex 使用者寫入該檔案:
sudo install -d -o root -g wheel -m 755 /etc/codex
sudo install -o root -g wheel -m 644 ./requirements.reviewed.toml /etc/codex/requirements.toml
ls -ld /etc/codex
ls -l /etc/codex/requirements.toml在 Linux 上,請使用適當的管理員群組。在 Windows 上,請使用管理員管理的存取控制清單保護 ProgramData 目錄與檔案。限制可變更 MDM 或雲端政策的人員,審查變更,並保留可供還原的副本。
使用不具管理員權限的試行帳戶,確認該帳戶無法修改政策、上層目錄或受管理的掛鉤程式。嘗試套用限制較寬鬆的使用者或專案設定,重新啟動 Codex,並確認強制限制仍然生效。
請測試管理範圍內的每個用戶端與環境,不要假設所有用戶端都會載入相同的政策。
驗證
使用不具管理員權限的測試身分:
-
嘗試編輯受管理的政策。預期結果:無法變更受管理的檔案。
-
嘗試透過使用者或專案設定放寬限制。預期結果:較寬鬆的設定遭拒,或仍受強制要求限制。
-
重新啟動用戶端,並確認限制仍然生效。
適用範圍與限制
具備足夠主機管理員權限的使用者或智慧體,可能有能力變更周邊的防護措施。僅靠使用者可編輯的設定,無法取代管理員管理的要求。