Codex Sandbox et sécurité de la CLI

Codex CLI dispose de mécanismes de bac à sable et de politiques de sécurité intégrés pour protéger la sécurité du système et des données tout en vous aidant à coder. Cette section détaille ces mécanismes de sécurité et la façon de les configurer.


Mécanisme de bac à sable

Codex exécute des commandes et opère sur des fichiers dans un environnement de bac à sable isolé. Cette conception garantit :

  • Les modifications apportées à vos fichiers de projet sont contrôlables
  • Les commandes potentiellement dangereuses nécessitent votre confirmation
  • Les données sensibles ne seront pas divulguées accidentellement

Le bac à sable constitue la première ligne de défense de la politique de sécurité de Codex, garantissant que les opérations de l'IA ne peuvent pas aller au-delà du périmètre que vous attendez.


Stratégie d'exécution

Codex utilise une politique d'exécution pour contrôler le comportement des différents types d'opérations :

Types de politiques

PolitiqueComportementScénarios applicables
askDemander une confirmation avant chaque exécutionDéveloppement quotidien (par défaut)
approveApprouver automatiquement l'exécutionEnvironnement entièrement fiable
denyRejeter toutes les opérations susceptibles d'avoir des effets secondairesMode lecture seule

Opérations nécessitant une confirmation

Les types d'opérations suivants déclenchent des demandes de confirmation :

  • Exécution de commandes Shell (en particulierrm、killetc.)
  • Modification ou suppression de fichiers
  • Création d'un nouveau fichier
  • Accès à des répertoires sensibles (par ex.~/.ssh/、/etc/)
  • Requêtes réseau (dans des cas spécifiques)

Configurer la politique d'exécution

Définir la politique d'exécution dans la configuration

[exec]
default_policy = "ask"

Pour des raisons de sécurité, il n'est pas recommandé de définir la politique par défaut surapprove, sauf si vous comprenez parfaitement les risques potentiels.


Boîte de dialogue de confirmation

Lorsque Codex doit effectuer des opérations sensibles, une boîte de dialogue de confirmation s'affiche :

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

  Codex 计划执行以下操作:

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

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

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

Description des options

OptionsDescription
YExécuter une seule fois
NAnnuler l'opération
AAjouter des règles, puis approuver automatiquement

Soyez prudent lorsque vous choisissez « Toujours autoriser » et assurez-vous que l'opération est bien sûre.


Contrôle d'accès aux fichiers

Répertoires protégés

Certains répertoires système sont protégés par défaut, et Codex demandera une confirmation supplémentaire lorsqu'il y accède :

RépertoireDescription
~/.ssh/Clés et configuration SSH
~/.aws/Identifiants AWS
/etc/Configuration système
~/.git-credentialsStockage des identifiants Git

Règles de protection personnalisées

Vous pouvez ajouter des règles de protection personnalisées dans la configuration :

Règles d'accès aux fichiers de configuration

[sandbox]
# Répertoires autorisés
allowed_paths = [
    "~/projects/*",
    "/workspace/*"
]

# Répertoires protégés (nécessitent une confirmation supplémentaire)
protected_paths = [
    "~/.ssh/*",
    "~/secrets/*"
]

Contrôle d'accès réseau

Codex peut restreindre la portée d'accès des requêtes réseau :

Configurer l'accès réseau

[network]
# Domaines autorisés
allowed_domains = [
    "github.com",
    "api.openai.com"
]

# Indique s'il faut autoriser l'accès au réseau local
allow_localhost = false

# S'il faut autoriser le réseau privé
allow_private_network = false
Restreindre l'accès réseau empêche Codex de se connecter accidentellement à des services non fiables.

Restrictions sur le répertoire de travail

Vous pouvez restreindre Codex à n'opérer que dans des répertoires spécifiques :

Restreindre le répertoire de travail

[sandbox]
# Codex ne peut fonctionner que dans ces répertoires
working_directories = [
    "~/projects/*",
    "/workspace/*"
]

# Comportement en dehors du répertoire : warn (avertissement) ou deny (refus)
out_of_bounds = "deny"

Liste blanche/noire des commandes

Mode liste blanche (recommandé)

N'autoriser que l'exécution des commandes explicitement listées :

Liste blanche de commandes

[commands]
# Mode liste blanche
whitelist_enabled = true
allowed_commands = [
    "git",
    "npm",
    "node",
    "python",
    "cargo"
]

Mode liste noire

Interdire l'exécution de commandes spécifiques :

Liste noire des commandes

[commands]
# Mode liste noire
blacklist_enabled = true
blocked_commands = [
    "rm -rf /",
    "dd",
    "mkfs"
]
Le mode liste blanche est plus sûr et est recommandé pour une utilisation dans les environnements de production ou lors de la manipulation de projets sensibles.

Gestion des données sensibles

Blocage automatique

Codex détecte et bloque automatiquement les informations sensibles :

  • Clés d'API et mots de passe
  • Jetons et informations d'authentification
  • Informations personnelles identifiables (PII)

Protection des variables d'environnement

Certaines variables d'environnement sont automatiquement masquées :

AWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
OPENAI_API_KEY
DATABASE_URL

Spécifier manuellement les données sensibles

Vous pouvez marquer manuellement dans la configuration le contenu à protéger :

Motifs de données sensibles personnalisés

[sensitive]
# Motifs d'expressions régulières à bloquer
patterns = [
    "password\\s*=\\s*[^\\s]+",
    "api_key\\s*=\\s*[^\\s]+",
    "secret\\s*=\\s*[^\\s]+"
]

Journaux d'audit

Codex peut enregistrer des journaux d'audit de toutes les opérations :

Activer la journalisation d'audit

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

Contenu du journal

Les journaux d'audit enregistrent les informations suivantes :

  • Horodatage
  • Type d'opération
  • Fichiers ou commandes impliqués
  • Résultat de l'opération (Succès/Échec)
  • Statut de confirmation de l'utilisateur

Afficher le journal d'audit

# Afficher les journaux d'audit récents
tail -f ~/.codex/log/audit.log
Les journaux d'audit sont très importants pour l'audit de sécurité et le dépannage, en particulier dans les environnements d'équipe.

Bonnes pratiques de sécurité

Environnement de développement

  • Utiliser la politique d'exécution par défaut (ask)
  • Activer la journalisation d'audit
  • Configurer la liste blanche des commandes

Environnement de production

  • Restreindre le répertoire de travail
  • Utiliser le mode liste blanche
  • Désactiver les accès réseau non nécessaires
  • Activer la journalisation d'audit complète

Projets sensibles

  • Utiliser les règles de protection les plus strictes
  • Examiner attentivement chaque demande de confirmation
  • Vérifier régulièrement les journaux d'audit

FAQ

Q: Où la politique d'exécution est-elle configurée ?

La politique d'exécution se fait principalement via~/.codex/config.tomlConfigurez via le fichier de configuration. Certains paramètres peuvent également être configurés via des variables d'environnement.

Q: Que se passe-t-il si j'ai accidentellement cliqué sur "Toujours autoriser" ?

Supprimez les règles concernées dans le fichier de configuration, ou supprimez entièrement le fichier de configuration et redémarrez Codex, et les règles seront réinitialisées.

Q: Codex peut-il accéder à mon jeton GitHub ?

Codex demande les autorisations GitHub nécessaires pour effectuer des opérations. Vous pouvez révoquer ces autorisations à tout moment dans les paramètres GitHub.

Q : Comment désactiver complètement les modifications de fichiers ?

Définissez la politique d'exécution surdeny, ce qui empêchera Codex d'exécuter toute opération susceptible de modifier le système de fichiers.

autres extensions