Codex CLI サンドボックスとセキュリティ

Codex CLI にはサンドボックス機構とセキュリティポリシーが組み込まれており、プログラミングを支援しながらシステムとデータのセキュリティを保護します。このセクションでは、これらのセキュリティ機構とその設定方法について詳しく説明します。


サンドボックス機構

Codex は隔離されたサンドボックス環境でコマンドを実行し、ファイルを操作します。この設計により以下が保証されます:

  • プロジェクトファイルへの変更が制御可能であること
  • 潜在的に危険なコマンドには確認が必要であること
  • 機密データが誤って漏洩しないこと

サンドボックスは Codex のセキュリティポリシーの第一の防御線であり、AI の操作がユーザーの想定範囲を超えないことを保証します。


実行ポリシー

Codex は実行ポリシー(Execution Policy)を使用して、さまざまな種類の操作の動作を制御します:

ポリシーの種類

ポリシー動作適用シナリオ
ask実行のたびに確認を求める日常開発(デフォルト)
approve実行を自動承認完全に信頼できる環境
deny副作用を引き起こす可能性のあるすべての操作を拒否読み取り専用モード

確認が必要な操作

次の種類の操作は確認リクエストをトリガーします:

  • Shell コマンドの実行(特にrm、killなど)
  • ファイルの変更または削除
  • 新しいファイルの作成
  • 機密ディレクトリへのアクセス(例:~/.ssh/、/etc/)
  • ネットワークリクエスト(特定の状況下)

実行ポリシーの構成

設定ファイルで実行ポリシーを設定する

[exec]
default_policy = "ask"

セキュリティ上の理由から、デフォルトポリシーを設定することは推奨されませんapproveただし、潜在的なリスクを完全に理解している場合を除きます。


確認ダイアログ

Codex が機密操作を実行する必要がある場合、確認ダイアログが表示されます:

══════════════════════════════════════════════════════
  确认执行
══════════════════════════════════════════════════════

  Codex 计划执行以下操作:

  命令: rm -rf node_modules/
  目录: /path/to/project

  这将永久删除目录及其所有内容

  [Y] 确认执行  [N] 取消  [A] 始终允许此类操作
══════════════════════════════════════════════════════

オプションの説明

オプション説明
Y今回のみ実行
N操作をキャンセル
Aルールを追加し、今後は自動承認

「常に許可」を選択するときは注意してください。その操作が実際に安全であることを確認してください。


ファイルアクセス制御

保護されたディレクトリ

一部のシステムディレクトリはデフォルトで保護されており、Codex がこれらのディレクトリにアクセスするときは追加の確認が行われます:

ディレクトリ説明
~/.ssh/SSH 鍵と設定
~/.aws/AWS 認証情報
/etc/システム設定
~/.git-credentialsGit 認証情報ストレージ

カスタム保護ルール

設定ファイルにカスタム保護ルールを追加できます:

ファイルアクセスルールの設定

[sandbox]
# アクセスを許可するディレクトリ
allowed_paths = [
    "~/projects/*",
    "/workspace/*"
]

# 保護されたディレクトリ(追加の確認が必要)
protected_paths = [
    "~/.ssh/*",
    "~/secrets/*"
]

ネットワークアクセス制御

Codex はネットワークリクエストのアクセス範囲を制限できます:

ネットワークアクセスの設定

[network]
# 許可するドメイン
allowed_domains = [
    "github.com",
    "api.openai.com"
]

# ローカルネットワークアクセスを許可するかどうか
allow_localhost = false

# プライベートネットワークを許可するかどうか
allow_private_network = false
ネットワークアクセスを制限すると、Codex が信頼できないサービスに誤って接続するのを防ぐことができます。

作業ディレクトリの制限

Codex を特定のディレクトリ内でのみ操作するように制限できます:

作業ディレクトリの制限

[sandbox]
# Codex はこれらのディレクトリ内でのみ操作できます
working_directories = [
    "~/projects/*",
    "/workspace/*"
]

# ディレクトリ外での動作:warn(警告)または deny(拒否)
out_of_bounds = "deny"

コマンドのホワイトリスト/ブラックリスト

ホワイトリストモード(推奨)

明示的にリストされたコマンドのみ実行を許可します:

コマンドのホワイトリスト

[commands]
# ホワイトリストモード
whitelist_enabled = true
allowed_commands = [
    "git",
    "npm",
    "node",
    "python",
    "cargo"
]

ブラックリストモード

特定のコマンドの実行を禁止します:

コマンドのブラックリスト

[commands]
# ブラックリストモード
blacklist_enabled = true
blocked_commands = [
    "rm -rf /",
    "dd",
    "mkfs"
]
ホワイトリストモードの方が安全です。本番環境や機密性の高いプロジェクトを扱う際に使用することをお勧めします。

機密データの処理

自動マスキング

Codex は機密情報を自動的に検出してマスキングします:

  • API キーとパスワード
  • トークンと認証情報
  • 個人識別情報(PII)

環境変数の保護

一部の環境変数は自動的に非表示になります:

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
OPENAI_API_KEY
DATABASE_URL

機密データを手動で指定する

設定ファイルで保護が必要な内容を手動でマークできます:

カスタム機密データパターン

[sensitive]
# マスキングが必要な正規表現パターン
patterns = [
    "password\\s*=\\s*[^\\s]+",
    "api_key\\s*=\\s*[^\\s]+",
    "secret\\s*=\\s*[^\\s]+"
]

監査ログ

Codex はすべての操作の監査ログを記録できます:

監査ログの有効化

[audit]
enabled = true
log_file = "~/.codex/log/audit.log"

ログの内容

監査ログには次の情報が記録されます:

  • タイムスタンプ
  • 操作の種類
  • 関連するファイルまたはコマンド
  • 操作の結果(成功/失敗)
  • ユーザーの確認状態

監査ログの表示

# 最近の監査ログを表示
tail -f ~/.codex/log/audit.log
監査ログは、セキュリティ監査や問題のトラブルシューティングにとって非常に重要です。特にチーム環境では重要です。

セキュリティのベストプラクティス

開発環境

  • デフォルトの実行ポリシー(ask)を使用する
  • 監査ログを有効にする
  • コマンドのホワイトリストを設定する

本番環境

  • 作業ディレクトリを制限する
  • ホワイトリストモードを使用する
  • 不要なネットワークアクセスを無効にする
  • 完全な監査ログを有効にする

機密性の高いプロジェクト

  • 最も厳格な保護ルールを使用する
  • すべての確認リクエストを慎重に審査する
  • 監査ログを定期的に確認する

よくある質問

Q: 実行ポリシーはどこで設定しますか?

実行ポリシーは主に~/.codex/config.toml設定ファイルで設定します。一部の設定は環境変数でも設定できます。

Q: 「常に許可」を誤ってクリックした場合はどうすればよいですか?

設定ファイル内の該当ルールを削除するか、設定ファイル全体を削除して Codex を再起動すると、ルールはリセットされます。

Q: Codex は私の GitHub トークンにアクセスできますか?

Codex は操作を実行するために GitHub への必要な権限を要求します。これらの権限はいつでも GitHub の設定で取り消すことができます。

Q: ファイルの変更を完全に無効にするにはどうすればよいですか?

実行ポリシーをdenyに設定すると、Codex がファイルシステムを変更する可能性のある操作を実行できなくなります。

その他の拡張