如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

Codex 安全實務指南

設定、驗證並搭配使用企業安全控制措施,管理 Codex 可使用的帳戶、檔案與服務,以及可執行的操作

部署 Codex 前,你需要決定它可以存取哪些帳戶、檔案與服務,以及可以執行哪些操作。本指南協助企業管理員將這些決定落實為設定、驗證設定效果,並找出需要額外防護之處。

這些安全建議可協助你授予開發人員使用 Codex 所需的存取權,同時降低意外變更、敏感資料外洩,以及防護措施本身遭到更動的風險。你可以據此選擇符合工作流程與風險管理要求的控制措施,瞭解其限制,並在自己的環境中驗證實際效果。這些措施可搭配組織現有的身分、端點、網路與服務防護措施使用。

你可以從特定任務著手,例如只允許登入公司工作區,也可以從較廣泛的目標著手,例如在保護正式環境的同時讓開發人員使用 Codex。

依工作需求選擇起點:

  • 個別設定指南逐一說明各項控制措施,包括設定步驟、驗證項目、還原方式與適用限制。

  • 組合設定指南說明如何搭配使用多項控制措施,以及身分管理、原始碼控管、部署等系統中的防護措施,以達成常見的安全目標。

你可以依組織需求調整範例。使用各項設定範例時,請一併閱讀相關說明,確認設定位置、適用的用戶端或環境,以及能控制和無法控制的事項。

擴大部署前,先在測試端點試用設定。確認預期允許的工作流程能順利完成,且刻意限制的操作確實遭到封鎖。根據測試結果調整設定,並向即將使用 Codex 的人員說明限制範圍。

選擇起點

使用頁面大綱開啟下方的章節。

你的目標 建議從這裡開始
設定一項特定的控制措施 個別設定指南
讓開發人員使用 Codex,同時保護正式環境 讓開發人員使用 Codex,同時保護正式環境
降低內部程式碼遭公開發布的風險 降低內部程式碼遭公開發布的風險
防止 Codex 更改自身的防護措施 防止 Codex 更改自身的防護措施

組合設定指南列出各項目標所需的控制措施、外部防護措施與驗證項目。

開始前的準備

  1. 盤點管理範圍內的用戶端與執行環境:桌面應用程式、CLI、IDE 擴充功能、Codex 雲端、CI 執行器與遠端主機。

  2. 大規模部署前,先在測試端點試行設定。

  3. 記錄支援的最低 Codex 版本。權限設定檔允許清單需要 Codex 0.138.0 或更新版本。

  4. 為每組受管理設定保留可供還原的副本。

  5. 每次變更後,各測試一個允許的工作流程與一個刻意封鎖的工作流程。

受管理的要求是由管理員強制執行的限制,受管理的預設值則是啟動時使用的值。對於支援的身分驗證、沙盒、核准、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 或受管理的預設設定提供啟動時使用的值,無法強制執行要求。請參閱受管理設定與智慧體安全性。

個別設定指南

選擇所需的控制措施,展開指南即可查看設定、驗證項目、還原方式與適用限制。每驗證一個項目就勾選一次。如果瀏覽器儲存空間可用,進度會儲存在此瀏覽器中。

企業安全目標的組合設定指南

以下範例說明如何搭配使用各項控制措施,以達成常見的企業安全目標。請在管理範圍內的每個用戶端與環境中測試設定。

參考文件