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
| Politique | Comportement | Scénarios applicables |
|---|---|---|
ask | Demander une confirmation avant chaque exécution | Développement quotidien (par défaut) |
approve | Approuver automatiquement l'exécution | Environnement entièrement fiable |
deny | Rejeter toutes les opérations susceptibles d'avoir des effets secondaires | Mode 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 particulier
rm、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
default_policy = "ask"
Pour des raisons de sécurité, il n'est pas recommandé de définir la politique par défaut sur
approve, 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
| Options | Description |
|---|---|
Y | Exécuter une seule fois |
N | Annuler l'opération |
A | Ajouter 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épertoire | Description |
|---|---|
~/.ssh/ | Clés et configuration SSH |
~/.aws/ | Identifiants AWS |
/etc/ | Configuration système |
~/.git-credentials | Stockage 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
# 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
# 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
# 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
# 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
# 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
# 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
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
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.