Fichiers
lmwork/doc/adr/0002-windows-job-object-and-filesystem-limits.md
2026-10-11 01:56:28 +02:00

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 :

  1. 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).
  2. Jetons restreints (CreateRestrictedToken) : Permet de supprimer des privilèges et d'ajouter des SIDs de restriction pour limiter les ACLs de fichiers.
  3. 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 :

  1. 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 via SetInformationJobObject.
    • JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE est systématiquement activé.
    • En cas de timeout ou de commande de destruction (kill), TerminateJobObject est invoqué, garantissant que tout l'arbre de processus (processus parent cmd.exe, powershell.exe, et sous-processus éventuels) est anéanti sans processus zombie.
  2. 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_ed25519 ou 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 CreateRestrictedToken est reportée à la passe v1.
  3. Mesures d'atténuation en v0 :
    • La politique writable_paths / readonly_paths est 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 de CreateRestrictedToken dans la passe suivante sans refactoriser l'API publique ni le moteur de PTY.

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.