Un espace de travail sans secrets + des réglages qui refusent la lecture. Commencez par combiner ces deux éléments.
Les réglages de lecture seule, d'approbation et d'entraînement jouent chacun un rôle différent. Vérifiez séparément s'ils peuvent réellement empêcher l'accès aux fichiers secrets.
Vérifiez séparément la lecture, l'exécution et l'envoi
Retirez de l'espace de travail les secrets inutiles. Pour les fichiers ciblés, envisagez le réglage deny qui refuse la lecture.
Vérifiez qui approuve. N'élargissez pas la limite avec Full access ni avec une autorisation d'exécution hors du bac à sable.
Vérifiez séparément la communication des commandes, l'envoi au modèle, ainsi que le navigateur et MCP.
Sommaire
- 1. Différences entre les réglages de lecture seule, d'approbation et d'entraînement
- 2. Commencer par séparer les secrets de l'espace de travail
- 3. Exemples de réglages qui refusent la lecture
- 4. Motifs .env et périmètre facile à négliger
- 5. Ce que bloque et ne bloque pas la désactivation du réseau des commandes
- 6. Différences entre variables d'environnement, OS et cloud
- 7. Étapes de vérification avec des fichiers factices
- FAQ
1. Différences entre les réglages de lecture seule, d'approbation et d'entraînement
« Ne pas pouvoir modifier un fichier » et « ne pas pouvoir lire un fichier » sont deux choses différentes.
Un mode qui limite les écritures. Ce n'est pas une fonction qui bloque la lecture du contenu des fichiers accessibles.
Indique où les modifications sont autorisées. Le périmètre de lecture ne se limite pas forcément au même endroit.
| Contrôle | Décide principalement | Ne garantit pas |
|---|---|---|
| Lecture seule | Si les fichiers peuvent être modifiés | Que les fichiers secrets accessibles ne soient pas lus |
| Politique d'approbation | Qui examine les opérations qui franchissent la limite | Que les lectures dans le périmètre autorisé soient confirmées par une personne à chaque fois |
| deny sur les fichiers | Refuser les lectures et écritures sur les chemins ciblés | Supprimer un contenu déjà collé ou un accès passant par d'autres outils |
| Limites du réseau des commandes | Destinations des communications des commandes dans le bac à sable | Bloquer toutes les communications du modèle, de l'authentification, du navigateur, de MCP, etc. |
| Réglages d'entraînement | Si les données traitées servent à améliorer les modèles | Arrêter le traitement ou l'envoi lui-même |
on-request permet quand même d'exécuter sans approbation supplémentaire les commandes dans le périmètre autorisé. Si vous voulez une confirmation humaine, vérifiez à la fois la politique d'approbation et qui examine.
Différence avec l'examen automatique par l'IA
approvals_reviewer = "auto_review" confie l'examen des cibles à l'IA. Ce n'est pas une confirmation humaine, et ce n'est pas non plus un réglage qui ajoute un examen à toutes les opérations déjà autorisées.
Source : OpenAI : limites des approbations et du bac à sable. Pour l'entraînement, voir Réglages d'entraînement de ChatGPT et Codex et informations confidentielles, traité séparément.
2. Commencer par séparer les secrets de l'espace de travail
Pour une correction d'interface, le code source et des données factices peuvent suffire. Il n'est pas nécessaire de placer dans le même environnement des clés API de production, des données clients ou des documents familiaux.
Déplacer les fichiers dans un autre dossier ne suffit pas. Si une large permission de lecture subsiste, les fichiers déplacés peuvent rester accessibles.
Copie de travail : seulement le nécessaire
Utilisez une petite entrée qui permet de reproduire le problème, au lieu des données de production.
Limitez les exemples de configuration aux noms des clés. Vérifiez aussi les journaux, les sauvegardes et l'historique.
Voyez s'il peut atteindre d'autres dossiers, le dossier personnel, un espace partagé ou des applications connectées.
Les réglages d'ignorance Git peuvent-ils bloquer la lecture ?
.gitignore indique les fichiers non suivis que Git ignore. Ce n'est pas un mécanisme qui supprime la permission de lecture du système d'exploitation. Même si un outil de recherche les ignore habituellement, cela ne garantit pas que la lecture par chemin direct soit refusée. Les règles d'ignorance ajoutées plus tard ne s'appliquent pas non plus aux fichiers déjà suivis par Git. Git officiel : ce que couvre gitignore.
Différence entre instruction de travail et refus technique
Écrire « ne lis pas les secrets » dans AGENTS.md est utile comme consigne de travail. Toutefois, cela ne crée pas en soi une restriction d'accès au niveau du système d'exploitation. La démarche de base consiste à superposer les consignes et le refus technique. Pour des exemples concrets d'anonymisation des entrées, voir aussi Précautions à prendre lorsque vous saisissez des informations dans une IA.
3. Exemples de réglages qui refusent la lecture
Permission profiles est une fonctionnalité bêta. Vérifiez l'environnement pris en charge et les réglages actuellement sélectionnés pour la session avant de l'utiliser.
read : lecturePermission de lire la cible
write : modificationAutorise l'écriture sur la cible
deny : refusRefuse la lecture et l'écriture de la cible
Attention à la combinaison avec les anciens réglages du bac à sable
Si les anciens réglages subsistent, Permission profiles peut ne pas être utilisé.
Vérifier les réglages en conflit et les contrôles d'administration
Ne pas mélanger avec les anciens réglages : default_permissions et [permissions] ne sont pas conçus pour être utilisés avec les anciens sandbox_mode et [sandbox_workspace_write]. En général, si les réglages chargés contiennent sandbox_mode, ou si --sandbox est passé au démarrage, l'ancien système est utilisé. Le contrôle par allowed_permission_profiles de l'administrateur est une condition distincte.
Ce qui suit est un exemple de configuration qui combine l'exemple officiel de limitation du périmètre de travail, le refus des fichiers secrets et l'approbation humaine. Ne remplacez pas intégralement vos réglages existants. Vérifiez la version prise en charge, les contraintes de l'organisation et les chemins d'exécution nécessaires, puis testez dans un environnement factice.
Où écrire les réglages : utilisateur et projet
~/.codex/config.toml
.codex/config.toml
Leur portée et leurs conditions de chargement diffèrent. Les réglages de projet ne sont chargés que pour les projets de confiance.
default_permissions = "project-private"
approval_policy = "on-request"
approvals_reviewer = "user"
[permissions.project-private]
extends = ":workspace"
[permissions.project-private.filesystem]
":root" = "deny"
":minimal" = "read"
[permissions.project-private.filesystem.":workspace_roots"]
".env" = "deny"
".env.production" = "deny"
"secrets" = "deny"
[permissions.project-private.network]
enabled = false
Quels fichiers cet exemple de configuration couvre-t-il ?
S'applique à l'espace de travail actuel et à chaque espace de travail ajouté
.envCible refusée.env.productionCible refuséesecrets/ et son contenuCible refuséesous-dossier/.envÀ vérifier séparément dans cet exempleMême secret sous un autre nom, ou copies dans les journauxÀ vérifier séparément dans cet exempleLa lecture est refusée avec :root. Toutefois, :minimal, nécessaire à l'exécution, et les répertoires temporaires autorisés par la base héritée sont des exceptions.
Hérite de :workspace pour autoriser la modification, et refuse les chemins précis ci-dessus. Ce n'est pas un exemple qui détecte les secrets intégrés dans les sorties.
Précisions sur le nom du réglage, les périmètres multiples et les fichiers temporaires
project-private est le nom donné dans cet exemple. :workspace_roots s'applique à l'espace de travail actuel et aux espaces ajoutés, et désigne les chemins cibles directement sous chacun d'eux. secrets vise le fichier ou la sous-arborescence du même nom.
Ce n'est pas une configuration qui rend illisible tout ce qui se trouve hors de l'espace de travail. Il faut aussi une pratique consistant à ne pas copier de secrets dans des zones temporaires.
Source : OpenAI : réglages, refus et périmètre des Permission profiles.
4. Motifs .env et périmètre facile à négliger
La désignation exacte d'un chemin convient aux secrets situés à un endroit fixe. Si vous utilisez des motifs, notez que *.env et .env.* sont différents. Ne supposez pas que, parce que l'exemple officiel **/*.env existe, .env.production peut être refusé dans les mêmes conditions.
| Exemple de motif | Cible visée | À vérifier séparément |
|---|---|---|
.env | Fichier du même nom directement à la racine de l'espace de travail | Sous-dossiers, et fichiers dont le nom comporte un suffixe |
.env.production | Fichier de configuration de production directement à la racine | Configuration de production sous un autre nom, ou copies |
secrets | Chemin du même nom directement à la racine, et son contenu | Copies dans d'autres emplacements, comme les journaux ou les sauvegardes |
**/*.env | Fichiers dont le nom se termine par .env sur plusieurs niveaux | Noms avec suffixe ; profondeur de recherche et modifications après le démarrage |
Vérifier la profondeur et les ajouts après le démarrage
Sous Linux, WSL et Windows natif, les motifs de refus contenant un ** sans limite peuvent nécessiter une expansion limitée au périmètre avant le démarrage. La documentation officielle décrit soit de définir glob_scan_max_depth à 1 ou plus, soit d'indiquer la profondeur explicitement, comme *.env, */*.env ou */*/*.env. Si vous utilisez des niveaux profonds, vous devez vérifier jusqu'à cette profondeur.
Les fichiers créés plus tard peuvent rester lisibles. Selon l'explication officielle, sous Linux, WSL et Windows (MXC ou elevated), les fichiers correspondant aux motifs de refus sont énumérés au démarrage de chaque processus. Les fichiers correspondants créés pendant que ce processus tourne ne sont pas soumis au refus et peuvent être lus si les autres permissions le permettent. Par exemple, un shell déjà lancé ou un serveur de développement peut lire un .env créé ensuite. Comme l'énumération est refaite au démarrage d'un nouveau processus, relancez les processus en cours après avoir créé un fichier secret.
Quand les permissions se chevauchent, laquelle prime ?
Une désignation de chemin plus précise peut remplacer une désignation plus large. Pour un même chemin, deny prime, mais il est aussi possible de créer une autorisation étroite à l'intérieur d'un refus large. Vérifiez aussi les couches de configuration supplémentaires et l'héritage depuis les profils parents.
Sources : OpenAI : refus de lecture par chemin exact ou motif glob, ordre de chargement des réglages. Le fichier .codex/config.toml du projet n'est chargé que pour les projets de confiance. Distinguez ce qui est écrit dans le fichier et ce qui est effectif dans la session en cours.
5. Ce que bloque et ne bloque pas la désactivation du réseau des commandes
Lorsque le réseau des commandes est désactivé, vous pouvez restreindre l'utilisation du réseau par les programmes exécutés dans le bac à sable ciblé. Toutefois, les requêtes de modèle et d'authentification du client Codex sont distinctes du contrôle réseau des commandes. Ne supposez pas qu'un chemin par lequel le code lu est transmis au contexte du modèle est bloqué simplement parce que le réseau des commandes est désactivé.
Périmètre atteint par la restriction réseau des commandes
Communications effectuées par les commandes, les scripts et leurs processus enfants.
Modèle et authentification, recherche web, applications connectées, MCP, navigateur et Computer Use, tâches cloud.
Pour autoriser le réseau tout en limitant les destinations, il faut activer le proxy réseau en plus des règles de domaines. Écrire des domaines autorisés dans un profil ne suffit pas à les activer.
| Réseau des commandes | Proxy | Résultat |
|---|---|---|
| Désactivé | Indifférent | La communication des commandes n'est pas autorisée |
| Activé | Désactivé | La communication directe est possible, et les règles de domaines du profil ne s'appliquent pas |
| Activé | Activé | Les règles de domaines sont appliquées par le proxy ; les destinations externes sont refusées sans autorisation |
Même une destination autorisée peut recevoir des secrets. Limiter les domaines n'équivaut pas à inspecter ce qui est envoyé. Lorsque vous approuvez une exécution hors du bac à sable, ne supposez pas que les réglages de refus actuels vous protègent encore ; vérifiez ce que l'approbation élargit. OpenAI : autorisations réseau et conditions du proxy.
6. Différences entre variables d'environnement, OS et cloud
Les secrets ne se trouvent pas seulement dans des fichiers. Si une clé API est présente dans le shell, la valeur peut être utilisée à partir des variables d'environnement transmises aux processus enfants, même si les fichiers sont refusés. L'héritage des variables d'environnement se gère séparément avec shell_environment_policy.
Exclusion automatique des variables d'environnement : true et false
true (par défaut)N'exclut pas automatiquement les variables dont le nom contient KEY, SECRET ou TOKEN
falseApplique cette exclusion automatique
ignore_default_excludes. Il s'agit d'un contrôle distinct du refus de fichiers. Comme l'exclusion se fait par nom de variable, ce n'est pas un mécanisme qui détecte tous les secrets.Les variables portant d'autres noms, ou les valeurs qu'un programme récupère ailleurs, ne peuvent pas être protégées. set s'applique après le traitement d'exclusion et peut rétablir des variables exclues. OpenAI : héritage des variables d'environnement et priorités.
Windows : vérifier aussi le mode du bac à sable
Les Permission profiles locaux sont décrits pour macOS, Linux, WSL et Windows natif, mais leur mise en œuvre n'est pas identique. Windows propose trois modes.
Microsoft Execution Containers. C'est le mode recommandé sur les appareils compatibles. Il ne nécessite ni configuration approuvée par un administrateur ni compte Windows dédié, et il est disponible sur les versions prises en charge de Windows 11 24H2 et 25H2.
Un ancien mode qui est prioritaire lorsque MXC n'est pas disponible. Il nécessite une configuration approuvée par un administrateur.
L'isolation des communications est faible, et il ne prend pas en charge les chemins où la lecture est refusée. Les réglages de protection des fichiers secrets de cet article ne fonctionnent pas avec ce mode.
Source : OpenAI : Windows sandbox. Une politique qui ne peut pas être prise en charge est refusée à l'exécution. Cela ne signifie pas que vous pouvez passer à Full access parce qu'une erreur est apparue. OpenAI : application selon chaque OS.
Cloud : ne pas réutiliser les réglages locaux tels quels
Codex Cloud vérifie séparément les réglages de son environnement cloud. Un profil local n'est pas appliqué automatiquement à l'ensemble du cloud, ni à dot (l'agent IA persistant de ChatGPT) côté cloud. Ne réutilisez pas tels quels les exemples de réglages locaux de cet article comme réglages cloud. Les différences de lieu d'exécution sont résumées dans Codex Remote, Cloud et conditions de connexion du PC.
7. Étapes de vérification avec des fichiers factices
« Nous lui avons demandé de ne pas lire », « nous avons enregistré le réglage » et « il a réellement été refusé » sont des preuves différentes. Vous n'avez pas besoin de faire tester de véritables secrets. Ce qui suit correspond aux étapes de vérification à effectuer par l'utilisateur ou l'administrateur.
- Notez la cible : Notez la version de Codex, l'OS, le lieu d'exécution et les permissions sélectionnées. Dans la CLI, vérifiez le périmètre de travail avec
/statuset l'état sélectionné avec/permissions. - Vérifiez les conflits de réglages : Contrôlez les réglages utilisateur, les réglages de projet de confiance, le profil sélectionné, les options de démarrage et les contraintes de l'administrateur. Pour le diagnostic, ne collez pas dans la conversation des fichiers de configuration complets ni des valeurs secrètes.
- Préparez des fichiers factices : Dans un espace de travail indépendant ne contenant aucun secret, créez des fichiers à autoriser et des fichiers à refuser. Utilisez le contenu comme marqueur factice.
- Vérifiez l'autorisation et le refus : Confirmez que la cible autorisée peut être lue par le même chemin d'exécution, et que la lecture de la cible refusée produit une erreur. Le fait que Codex n'ait pas lu volontairement n'est pas une preuve de refus technique.
- Testez les différences de placement : Vérifiez les fichiers factices directement à la racine, dans des sous-dossiers, avec un suffixe, et créés après le démarrage. N'accordez pas d'approbation qui outrepasse un refus. Si un fichier est lisible de façon inattendue, arrêtez d'utiliser cet environnement et recherchez la cause.
- Vérifiez aussi le chemin des sorties : Contrôlez si les tests ou les builds écrivent des secrets dans les journaux, et si les mêmes informations passent vers d'autres MCP, navigateurs ou applications connectées.
Les points vérifiables varient selon la version et l'affichage de la CLI ; regardez donc l'affichage réel, pas seulement le nom de la commande. La CLI officielle propose aussi une vérification par OS avec codex sandbox. Toutefois, avant de vous y fier, assurez-vous que les réglages testés avec la commande auxiliaire sont identiques à ceux effectifs dans la session de bureau ou d'IDE que vous utilisez habituellement. OpenAI : méthodes de test du bac à sable.
Un contenu déjà lu ne peut pas être annulé en ajoutant un refus après coup. Vérifiez séparément les conversations passées, les journaux, la conservation des fichiers et les réglages d'entraînement. Ne concluez pas qu'une information a fuité vers des tiers simplement parce qu'un fichier était lisible. Décidez séparément ce qui a été lu, où cela est allé, et si des identifiants doivent faire l'objet d'une action.
L'exclusion des fichiers secrets a été demandée par des utilisateurs dans une issue publique de Codex. Pour le comportement actuel, consultez la documentation officielle Permissions présentée ci-dessus.
Hypothèses de départ de cet article : rédigé le 8 octobre 2026 à partir des documents d'OpenAI sur Permissions, Sandbox, les approbations et la sécurité, ainsi que sur les réglages, principalement pour les commandes dans le bac à sable local. Le traitement des fichiers créés plus tard a été revérifié dans la documentation officielle le 19 octobre, et les modes Windows le 16 octobre. Les exemples de configuration n'ont pas été appliqués dans un environnement réel ; avant de les utiliser, testez le refus avec des fichiers factices selon les étapes ci-dessus.
Articles connexes : si vous voulez arrêter les modifications de sources, voir Comment utiliser Codex et Claude Code en lecture seule. Si vous voulez poursuivre le travail dans le périmètre autorisé, voir Mode Goal de Codex et réduction des attentes d'approbation.
FAQ
Si c'est en lecture seule, .env ne sera-t-il pas quand même envoyé ?
Cela peut arriver. La lecture seule ne limite que les modifications. Pour empêcher qu'un .env lisible entre dans le contexte du modèle, vérifiez séparément le refus de lecture de la cible et l'absence de secrets dans l'environnement de travail.
.gitignore et AGENTS.md suffisent-ils à eux seuls ?
Ils ne remplacent pas un refus technique de lecture. Les réglages d'ignorance Git, les consignes de travail et les permissions appliquées par l'OS sont des mécanismes distincts. Vérifiez avec des fichiers factices que deny fonctionne dans votre environnement d'exécution actuel.
Si je désactive le réseau, Codex fonctionne-t-il entièrement sur l'appareil ?
Non. La restriction réseau des commandes n'est pas un réglage qui arrête les communications avec le modèle et l'authentification. Les réglages du navigateur, de MCP, des applications connectées et du cloud sont aussi distincts.
Avec cet exemple de configuration, peut-on protéger entièrement les secrets sous Windows ?
Cet exemple de configuration ne suffit pas à lui seul. Vérifiez la prise en charge de la fonctionnalité bêta, le mode du bac à sable (unelevated ne prend pas en charge le refus de lecture), les couches de configuration réelles, les chemins et les outils que vous exécutez, puis testez le refus avec des fichiers factices avant utilisation.