Modes sandbox Codex et politiques d’approbation pour VPS

Modes sandbox Codex et politiques d’approbation pour VPS — Comprendre les modes sandbox Codex et les politiques d’approbation des tâches VPS sans surveillance : fichiers, réseau, tests sûrs et validation humaine.
16 nov. 20266 min de lecture
Share with

Une tâche Codex nocturne ne devrait pas nécessiter une personne pour surveiller chaque commande. Elle ne devrait pas non plus hériter du droit de déployer en production simplement parce que personne ne la surveille. Nous séparons ces décisions : les accès de l’agent, les actions nécessitant une demande et l’autorité de publication du résultat.

Ce guide concerne les permissions du processus Codex sur votre propre VPS, et non le produit distinct Codex Security d’analyse du code. Nous prenons pour référence la documentation officielle sur les approbations des agents. Vérifiez votre version de la CLI et les exigences administrées avant d’appliquer une configuration.

Les modes sandbox Codex et les politiques d’approbation sont des contrôles distincts

Le bac à sable définit la frontière technique des commandes générées par le modèle. La politique d’approbation détermine quand Codex demande à franchir cette frontière ou à effectuer une action nécessitant une autorisation. Aucun ne remplace les permissions du système ni la revue du diff final.

ParamètreCe qu’il contrôleCe qu’il ne garantit pas
read-onlyEmpêche les écritures selon la politique de sandbox activeMasquer tous les fichiers lisibles par le compte système
workspace-writeAutorise les modifications dans l’espace de travail actif, sous réserve des chemins protégésUn réseau illimité, les modifications des métadonnées Git ou du code sûr
on-requestPermet à Codex de demander des permissions supplémentairesUne confirmation pour chaque commande
neverSupprime les demandes d’approbation interactivesLa suppression du sandbox ou la réussite des opérations bloquées

La distinction utile : sans questions ne signifie pas sans restrictions. Une tâche de rapport limitée peut fonctionner sans interaction, sans disposer d’un accès complet à l’hôte. À l’inverse, une session interactive n’est pas automatiquement sûre : approuver une élévation peut autoriser une exécution hors du sandbox initial.

Les versions récentes protègent des chemins comme .git, même dans un espace de travail accessible en écriture. Ne supposez pas qu’un agent peut créer un commit simplement parce qu’il peut modifier les sources. Vérifiez les paramètres effectifs avec /status dans une session interactive Codex et consultez la documentation correspondant à votre version. Un worktree Git sépare les modifications ; ce n’est pas une frontière de sécurité.

Lancez votre premier agent en 3 minutes environ

Installez la CLI Office Claws, connectez votre compte Contabo et votre abonnement Codex : votre agent obtient son propre VPS et un bureau dans l'office.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

4,99 $/mois + votre propre VPS Contabo · les clés restent dans votre trousseau

Choisir la frontière avant de supprimer la surveillance

Nous commençons un nouveau dépôt par une session supervisée en lecture seule :

codex --sandbox read-only --ask-for-approval on-request

Examinez les instructions du dépôt, la configuration locale du projet, les compétences installées et les outils connectés avant de leur faire confiance. Un dépôt peut contenir des instructions malveillantes. Pour une session de modification, choisissez délibérément workspace-write avec on-request, examinez les accès demandés et restez disponible pour les décisions importantes.

Pour un rapport sans surveillance, un sandbox en lecture seule avec une politique d’approbation non interactive constitue un point de départ plus limité. Confirmez les options prises en charge par votre codex exec installé avant de le planifier. Si une action nécessaire est bloquée, consignez l’échec et renvoyez-le pour examen. Ne relancez pas automatiquement avec davantage de droits et ne désactivez pas le sandbox pour donner l’impression qu’un minuteur fonctionne.

Un rapport en lecture seule peut tout de même exposer des informations sensibles dans sa sortie. Utilisez un compte système dédié sans privilèges, uniquement les dépôts nécessaires et aucun identifiant de déploiement en production. Retirez les secrets inutiles des fichiers accessibles et des variables d’environnement héritées. Ne transférez pas votre agent SSH personnel et ne montez pas le socket Docker de l’hôte : ces accès peuvent étendre les pouvoirs du processus au-delà du répertoire de travail.

Séparer le sandbox du projet, le compte de l’hôte et l’autorisation de publication

Le réseau exige une décision distincte. Dans la configuration documentée workspace-write, le réseau des commandes est désactivé par défaut. L’activer ne revient pas à limiter les destinations. Un proxy réseau de commandes configuré et actif possède ses propres règles ; écrire une liste d’autorisation n’active pas son application. Le trafic du modèle et de l’authentification, la recherche web, MCP et les connecteurs relèvent de contrôles séparés. Un shell sans réseau ne prouve pas que tous les outils de l’agent sont hors ligne.

Tester les permissions sur un projet jetable

Avant qu’une tâche récurrente touche du vrai code, créez un dépôt temporaire de test avec le même compte, le même mode de lancement et la même configuration que l’exécuteur prévu. Nous testons les actions autorisées et interdites :

TestPreuve à conserver
Lire un fichier de test inoffensifContenu correct et répertoire de travail effectif
Tenter de le modifier en lecture seuleÉcriture refusée et fichier inchangé
Le modifier en mode workspace-writeDiff attendu, sans modification étrangère
Tenter d’écrire hors de l’espace autoriséRefus sans approbation d’une élévation
Tenter une requête inoffensive vers un service que vous contrôlez lorsque le réseau des commandes doit être désactivéRefus attribuable à la politique, pas seulement à une panne DNS

N’utilisez jamais un vrai secret pour tester un accès refusé. Un test établit uniquement la frontière effectivement exercée. Il ne prouve pas une résistance à toutes les attaques et ne valide pas les permissions d’outils MCP indépendants. Si le mécanisme de sandbox Linux ne démarre pas sur votre VPS, corrigez la compatibilité ou arrêtez la tâche ; ne le remplacez pas discrètement par une exécution sans restrictions.

Conservez la version de la CLI, la politique choisie, l’identité de la tâche, le code de sortie et les résultats, sans collecter les fichiers d’authentification. Répétez les tests après toute modification de la CLI, du noyau, du service de démarrage ou de la configuration du projet. Distinguez les actions refusées des demandes d’approbation en attente dans votre supervision, au lieu de relancer indéfiniment.

Séparer l’exécution de la publication

Un exécuteur peut produire un diff ou un rapport sans posséder l’identifiant permettant de fusionner ou de déployer. Nous examinons le résultat, lançons des tests indépendants et utilisons une étape de publication autorisée séparément. Une sortie réussie de l’agent prouve la fin de l’exécution, pas l’autorisation de livrer.

Office Claws fournit la couche opérationnelle pour les agents Codex sur votre propre Contabo VPS, avec une connexion privée Tailscale et une gestion par application de bureau ou CLI. Les politiques ci-dessus relèvent de Codex et de l’hôte ; cela ne signifie pas qu’Office Claws impose automatiquement chaque permission ou validation de publication. Un réseau privé réduit l’exposition, mais n’isole pas un processus déjà lancé sur la machine.

Commencez avec un exécuteur Codex sur VPS, apportez un forfait ChatGPT éligible et gardez ses limites d’utilisation en tête : un serveur disponible en permanence n’offre pas une capacité de modèle illimitée. Une fois les permissions vérifiées, utilisez la sortie structurée pour transmettre un rapport fiable. Notre recommandation : accès limité d’abord, exécution durable ensuite et décision séparée pour publier.

Auteur

Office Claws Team

Nous construisons le futur de la gestion des agents IA chez Office Claws. Partage d'analyses sur l'infrastructure, la sécurité et l'expérience développeur.

Lancez votre premier agent en 3 minutes environ

Installez la CLI Office Claws, connectez votre compte Contabo et votre abonnement Codex : votre agent obtient son propre VPS et un bureau dans l'office.

curl -fsSL https://officeclaws.com/downloads/install.sh | sh

4,99 $/mois + votre propre VPS Contabo · les clés restent dans votre trousseau