Voir aussi : ADR-008 · Configuration · Limitations connues · Retour à l'index
ADR-014 — Les commandes shell sont confinées par le système d'exploitation, par défaut
Statut : Accepté · Date : 2026-10-18
· Portée : src/tools/Orkeon.Tools.Code (ShellCommandTool, Confinement/, Sessions/), AgentRunScope (Orkeon.Domain) et ses deux points d'entrée (AgentExecutionService, le runtime de scripting), les images, le paquet Debian
Contexte
shell_command vérifiait auprès du VFS les chemins que nomme sa ligne de commande, et rien
d'autre : un script qu'il lançait lisait et écrivait partout où l'utilisateur de l'hôte le pouvait,
montages en lecture seule compris, et atteignait le réseau. Un opérateur
pouvait choisir bubblewrap sous Linux (Confinement:Mode = Bubblewrap) ; personne n'y était tenu,
et macOS comme Windows n'avaient rien. Chaque commande était aussi son propre processus : une vue
confinée aurait été reconstruite à chaque appel, et l'annulation de l'appelant laissait la commande
tourner.
Décision
- Le confinement est actif par défaut.
Orkeon:Tools:Shell:Confinement:ModereçoitAuto, le nouveau défaut, qui choisit le moteur de la plateforme :- Linux : bubblewrap (
bwrap), chaque montage exposé aux agents lié à son chemin virtuel ; - macOS : Seatbelt (
sandbox-execet un profil généré), avec un dossier de travail propre à la session commeHOMEetTMPDIR; - Windows 10 et suivants : un AppContainer (un profil par session) dans un Job Object, les
montages étant accordés à son SID par ACL. Un programme n'est cherché que sur le
PATH, jamais dans le répertoire de travail ; un fichier de commandes (.bat,.cmd) est refusé, car cmd.exe analyserait de nouveau ses arguments (sans confinement, il passe par cmd.exe, échappé comme une commande interne) ; une commande interne de cmd.exe (echo,dir,type) tourne encmd.exe /d /v:off /s /c "<commande> <arguments>"dans le conteneur, chaque argument qui n'est pas un mot simple entre guillemets doubles et%refusé. Dans chaque moteur, le processus voit les montages de l'agent (en lecture seule sans Write), les répertoires système en lecture seule, rien d'autre de l'hôte, et pas de réseau saufAllowNetwork.
- Linux : bubblewrap (
- Coupé dans un conteneur. Un hôte dans un conteneur (
/.dockerenv,/run/.containerenv,DOTNET_RUNNING_IN_CONTAINER=true) est déjà confiné par lui, et un conteneur non privilégié refuse en général les espaces de noms utilisateur dont bubblewrap a besoin :Autoy vautNoneet le journalise une fois. Les images fixent aussiMode=Noneexplicitement. Un mode explicite n'est jamais remplacé. - Échec franc. Un moteur qui ne peut pas tourner (absent, refusé par le noyau, un mode d'une
autre plateforme) fait échouer l'appel avec la raison et la façon de couper le confinement
(
Mode = None). Une commande ne se rabat jamais sur une exécution hors confinement. - Une session shell par exécution d'agent. La première commande d'un agent ouvre sa session,
liée à l'
AgentRunScopede l'exécution ; les commandes suivantes de la même exécution la réutilisent, si bien que la vue confinée est construite une fois et rouverte seulement quand les montages changent. Sous Linux et macOS, la session est un shell persistant (/bin/sh -s, dans le moteur) qui lance chaque commande dans un sous-shell ; sous Windows, c'est l'AppContainer et le Job Object, chaque commande étant son propre processus créé dedans. La session et tous les processus qu'elle a lancés sont tués quand l'exécution se termine, échoue ou est annulée (la portée se ferme), et quand l'hôte meurt : par le noyau sous bubblewrap (--die-with-parentet un espace de noms PID) et sous Windows (le Job Object, confiné ou non) ; par un chien de garde sous Seatbelt (il tourne hors du bac à sable, qui ne peut pas signaler les processus de l'hôte) et hors confinement sous Linux et macOS, qui sonde l'hôte chaque seconde et tue l'arbre de processus de la session. Un dépassement de délai ou l'annulation de l'appelant tue la session ; la commande suivante en ouvre une nouvelle. Sous Linux et macOS, une commande qui dépasse son délai ne rend aucune sortie partielle. - La ligne de commande reste sous liste d'autorisation. La session est un vrai shell, mais l'outil analyse et vérifie toujours chaque commande contre sa liste d'autorisation et ses opérateurs interdits avant de l'écrire dans la session.
Alternatives étudiées
- WSL2 et bubblewrap sous Windows : un seul moteur partout, mais WSL2 devient obligatoire sur l'hôte, chaque chemin est traduit deux fois et les chaînes d'outils Windows natives restent dehors. Écarté.
- Un jeton restreint sous Windows : plus simple qu'un AppContainer, mais il ne coupe pas le réseau et un jeton restreint lit encore l'essentiel du disque. Écarté au profit de l'AppContainer, qui refuse par défaut.
- Windows Sandbox : une machine virtuelle complète par session, des secondes au démarrage et absente des éditions Famille. Écarté.
- Pas de confinement sous macOS :
sandbox-execest déprécié mais toujours livré et utilisé par les outils de la plateforme ; laisser macOS sans confinement ferait dépendre le défaut de la plateforme. Écarté. - Une liste d'autorisation sans vrai shell : ce que faisait l'outil. Chaque commande un nouveau processus, aucun état entre les commandes, et une vue confinée reconstruite à chaque fois. Écarté au profit d'un shell confiné par exécution, la liste d'autorisation gardée devant.
Conséquences
- Pas de réseau par défaut. Une commande qui télécharge (un gestionnaire de paquets,
git fetch) échoue tant queConfinement:AllowNetwork = truen'est pas posé. - Les chaînes d'outils hors des répertoires système (
/opt/node,~/.dotnet,nvm) sont invisibles tant que leur dossier n'est pas listé dansConfinement:ReadOnlyPaths. - Chemins : sous bubblewrap, le processus travaille sur des chemins virtuels ; sous Seatbelt et AppContainer, sur des chemins physiques, traduits à l'aller et au retour comme pour une commande hors confinement.
- ACL Windows : l'AppContainer n'atteint un montage que par une ACE ajoutée pour lui ; les ACE
sont notées dans un registre (
%LOCALAPPDATA%\Orkeon\shell-sessions\) et retirées à la fermeture de la session, et la première session du processus hôte suivant reprend ce qu'un hôte tombé a laissé. Le contrôle d'accès du conteneur ne retient que ce que les ACE d'autorisation accordent à son SID (une ACE de refus, ou une étiquette d'intégrité, ne l'arrête pas) : un sous-chemin masqué, ou en lecture seule dans un montage accessible en écriture, reçoit une DACL protégée le temps de la session (ce dont il héritait conservé, moins le SID de la session), notée dans le registre et réécrite à la fin. Windows propage chaque ACE héritable à chaque objet sous la racine du montage : une session coûte une écriture de descripteur de sécurité par fichier de ses montages, dans chaque sens. Si c'est trop lent sur de gros arbres, la sortie est un SID d'AppContainer stable par jeu de droits, accordé une fois. - Fichiers de commandes Windows :
npm.cmdet tout.bat/.cmdsont refusés dans une session AppContainer. AvecMode = None, ils passent par cmd.exe, chaque argument échappé comme pour une commande interne et%refusé ; ce que le script fait de%~1relève de sa propre analyse. - Le
dirde cmd dans un AppContainer :dir,vol,attribetwhere /rinterrogent la racine du lecteur, qu'une ACL Windows standard n'ouvre pas à un AppContainer : ils répondent « Access is denied. » dans une session confinée (for %f in (*)et les programmes qui listent un répertoire fonctionnent). - Le chien de garde est plus faible que le noyau : sous Seatbelt et hors confinement sous Linux et macOS, un processus sorti de l'arbre de la session (un double fork) survit à un crash de l'hôte.
- Changement cassant : un hôte qui comptait sur l'ancien défaut (
None) reçoit le confinement ; la sortie estMode = None(CHANGELOG.md, tableau de migration). Le paquet Debian dépend debubblewrap; sous Ubuntu 24.04 et suivantes, AppArmor restreint les espaces de noms utilisateur non privilégiés, et un profil AppArmor de/usr/bin/bwrapqui accordeusernslève la restriction pour bubblewrap seul ; sans lui, l'appel échoue avec la raison de bwrap.