2.6 KiB
2.6 KiB
ADR 0001 : Choix de Bubblewrap (bwrap) pour le confinement sous Linux
Statut
Accepté
Contexte
GastinelLMwork nécessite un bac à sable strict sous Linux pour exécuter des commandes issues d'un modèle d'IA local. Le principe fondateur du projet stipule :
« L'intelligence est dans le confinement, pas dans le classifieur. »
Les alternatives pour le confinement sous Linux incluaient :
- Docker / Podman / Conteneurs OCI : Lourds, nécessitent un démon système ou des privilèges root / socket, introduisent une complexité de démarrage et de dépendances inacceptable pour une bibliothèque embarquée dans un outil de développement léger.
- Seccomp brut ou Chroot :
chrootrequiert les privilèges root (CAP_SYS_CHROOT).seccomppur bloque les appels système mais ne gère pas les espaces de noms de chemins de fichiers ni le réseau. - Landlock : Récent dans le noyau Linux (5.13+), ne gère pas nativement l'isolation de l'espace de noms réseau ni PID.
- Bubblewrap (
bwrap) : Outil standard de sandboxing non privilégié (utilisé par Flatpak), s'appuyant sur les user namespaces du noyau Linux sans nécessiter de démon ni de droits administrateur.
Décision
Nous choisissons Bubblewrap (bwrap) comme moteur d'isolation principal sous Linux :
- Espaces de noms isolés :
--unshare-all(montage, PID, réseau, IPC, UTS, cgroup). - Isolation du système de fichiers stricte : Aucun chemin hôte n'est visible par défaut. Seuls les chemins listés dans
policy.readonly_paths(--ro-bind) etpolicy.writable_paths(--bind) sont montés. - Réseau désactivable :
--unshare-netgarantit l'absence totale de connectivité quandnetwork: false. - Nettoyage automatique :
--die-with-parentassure que la mort du superviseur ou debwraptue instantanément tous les sous-processus de l'arbre. - Interdiction du contournement : La bibliothèque vérifie obligatoirement la présence de l'exécutable
bwrap(which::which("bwrap")). Sibwrapest absent, l'exécution échoue immédiatement avec une erreur expliciteExecError::BwrapNotFound. Aucun repli silencieux vers une exécution sans confinement n'est toléré.
Conséquences
- Avantages : Confinement robuste et éprouvé par le monde des distributions Linux (Flatpak), zéro démon, démarrage ultra-rapide (millisecondes), sécurité garantie par le noyau.
- Limites : Les distributions très anciennes sans support des user namespaces non privilégiés (ou avec
kernel.unprivileged_userns_clone = 0) nécessitent l'installation du binairebwrapavec bit SUID ou l'activation des user namespaces.