3.3 KiB
3.3 KiB
ADR 0002 : Confinement Windows via Job Objects et limite assumée sur le système de fichiers
Statut
Accepté (V0 — limite documentée et assumée)
Contexte
Sous Windows, confiner l'exécution d'un processus arbitraire (spécifiquement lancé dans un terminal virtuel ConPTY) impose de concilier la gestion des ressources, l'arrêt des arborescences de processus et la sécurité des accès disques.
Sous Windows, les mécanismes d'isolation incluent :
- Windows Job Objects : Primitif noyau pour borner la mémoire (
ProcessMemoryLimit,JobMemoryLimit), le nombre de processus (ActiveProcessLimit), et détruire tous les descendants lors de la clôture (JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE). - Jetons restreints (
CreateRestrictedToken) : Permet de supprimer des privilèges et d'ajouter des SIDs de restriction pour limiter les ACLs de fichiers. - AppContainer Isolation : Mécanisme de sandbox moderne UWP/Chromium, mais très lourd à mettre en place avec ConPTY et nécessitant des configurations d'ACLs explicites sur chaque ressource.
Décision
Pour la passe v0 de GastinelLMwork :
- Implémentation de
Windows Job Object:- Chaque commande est associée dès sa création à un Job Object Windows anonyme.
- Les limites de mémoire (
policy.max_memory_bytes) et de processus (policy.max_processes) sont imposées au niveau du noyau viaSetInformationJobObject. JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSEest systématiquement activé.- En cas de timeout ou de commande de destruction (
kill),TerminateJobObjectest invoqué, garantissant que tout l'arbre de processus (processus parentcmd.exe,powershell.exe, et sous-processus éventuels) est anéanti sans processus zombie.
- Limite connue et assumée : absence d'isolation du système de fichiers en v0 :
- Un Windows Job Object ne restreint pas l'accès au système de fichiers NTFS.
- Par conséquent, sur Windows dans cette passe v0, une commande de type
type C:\Users\...\.ssh\id_ed25519ou la lecture/écriture de fichiers hors des chemins spécifiés n'est pas bloquée par le noyau. - Décision contractuelle : L'implémentation de
CreateRestrictedTokenest reportée à la passe v1.
- Mesures d'atténuation en v0 :
- La politique
writable_paths/readonly_pathsest acceptée par l'API pour préserver la portabilité du code appelant. - Dès qu'au moins un chemin de fichier est spécifié dans la politique sous Windows, un avertissement clair et non équivoque est émis dans les journaux d'audit et la console (
tracing::warn!) :« Windows sandbox warning: writable_paths and readonly_paths filesystem isolation is NOT enforced on Windows in this version (Job Object isolation only). »
- L'architecture de la bibliothèque (
platform/windows.rs) est isolée pour permettre le branchement deCreateRestrictedTokendans la passe suivante sans refactoriser l'API publique ni le moteur de PTY.
- La politique
Conséquences
- Avantages : Zéro fuite de processus sous Windows en cas de timeout ou d'arrêt ; respect strict des quotas mémoire et nombre de processus.
- Risques de sécurité (assumé en v0) : Les scripts exécutés sous Windows ont accès à l'ensemble des fichiers accessibles par l'utilisateur courant. Ne pas exécuter de commandes non fiables sous Windows sans confirmation explicite de l'humain.