附录 C：Codex 安全最佳实践

Codex 是强大的编码助手，但强大的能力也意味着更多的安全责任。本附录从权限、沙箱、隐私和生产安全四个维度，帮你安全地用好 Codex。

---

一、API Key 安全管理

❌ 不要这样做

# 硬编码在代码里（大忌！）
api_key = "sk-xxxx..."

# 提交到 GitHub（一旦泄露，别人就能用你的额度）
git add config.py  # config.py 里包含 API Key

✅ 正确做法

# 使用环境变量（推荐）
export OPENAI_API_KEY="sk-xxxx"

# 使用 .env 文件（添加至 .gitignore）
echo ".env" >> .gitignore

# 使用密钥管理服务（团队场景）
# 如 1Password CLI、Vault、AWS Secrets Manager

⚠️ 泄密应急：发现 API Key 泄露后，立即登录 OpenAI 控制台 撤销该密钥并生成新密钥。

二、沙箱机制

为什么要用沙箱？

Codex 生成的代码可能包含：

• 意料之外的文件操作（删除/修改文件）
• 网络请求（向陌生地址发送数据）
• 系统命令执行（安装软件、修改配置）

推荐的沙箱策略

场景	推荐方案
快速测试	codex --dry-run 先预览输出，不实际执行
本地开发	使用 Docker 容器隔离
代码审查	生成代码后先 review 再执行
生产环境	在 CI/CD 管线的独立环境运行

使用 Docker 沙箱

# 创建一个隔离的测试环境
docker run -it --rm \
  -v $(pwd):/workspace \
  -e OPENAI_API_KEY=$OPENAI_API_KEY \
  node:20-alpine /bin/sh

# 在容器内安装和使用 Codex
cd /workspace
npm install -g @openai/codex
codex "生成一个安全的文件处理脚本"

三、数据隐私保护

了解数据流向

当你使用 Codex 时：

你的 prompt → OpenAI API → Codex 响应
     ↑                         ↓
  本地终端                  返回结果

⚠️ 重要：你的 prompt 和代码片段会被发送到 OpenAI 服务器处理。不要输入敏感信息。

数据脱敏清单

在向 Codex 发送 prompt 前，检查是否包含以下内容：

□ 数据库密码、API Key、Token
□ 用户个人信息（姓名、手机号、身份证）
□ 公司商业机密、产品定价策略
□ 内部系统地址、服务器 IP
□ 加密密钥、证书私钥
□ 未公开的代码库完整路径

脱敏方法

# ❌ 错误示例
codex "修复这个连接 db.ourcompany.com:3306 的 MySQL 代码，密码是 admin123"

# ✅ 正确示例
codex "修复这段连接 MySQL 的 Python 代码（连接字符串已用占位符替换）"
# 然后在代码中把敏感信息替换为占位符

企业场景建议

• 查阅公司 AI 使用政策，遵守合规要求
• 询问法务/安全团队是否可以使用外部 AI 工具处理代码
• 考虑自建模型或使用 OpenAI 的 Azure 部署（数据不出境）
• 定期审计 AI 工具使用日志

四、生产环境安全建议

代码审查

即使 Codex 生成的代码看起来完美，也要坚持审查流程：

flowchart LR
    A[Codex 生成代码] --> B[人工审查]
    B --> C{通过?}
    C -->|是| D[单元测试]
    C -->|否| E[回退修改]
    D --> F[自动化测试]
    F --> G[合并到主分支]

常见安全隐患

风险类型	Codex 可能生成的问题	预防措施
注入攻击	拼接 SQL / 未转义的用户输入	要求 Codex 带参数化查询
硬编码凭据	API Key 写死在代码里	审查时重点检查
路径遍历	使用用户输入构造文件路径	限定文件操作的范围
命令注入	os.system(f"rm {user_input}")	使用安全的 API 替代 shell 调用
不安全的依赖	引用了有漏洞的第三方库	添加 Snyk/Dependabot 检查
过于宽松的权限	777 文件权限、开放 CORS	在 prompt 中明确安全约束

给 Codex 的安全提示词

在 prompt 末尾添加安全要求，可以提高输出质量：

注意：生成的代码必须遵循以下安全规范：
- 使用参数化查询防止 SQL 注入
- 不要硬编码敏感信息
- 遵循最小权限原则
- 验证和清理所有用户输入
- 不要执行系统命令

五、企业级安全 Checklist

□ API Key 使用环境变量管理，不提交到版本控制
□ 定期轮换（Rotate）API Key（建议每 90 天）
□ 在测试/沙箱环境中运行不熟悉的生成代码
□ 禁止在 prompt 中输入敏感/隐私数据
□ 建立代码审查流程（生成 → 审查 → 测试 → 部署）
□ 使用最小权限的 API Key（限制到特定模型和用量上限）
□ 启用 OpenAI 使用日志和告警
□ 为团队编写 AI 使用安全指南

安全的核心原则：Codex 只是工具，最终责任在开发者。永远不要盲目信任 AI 生成的代码，安全红线必须由人工把控。

---