Un sandbox Linux léger et multicouche combinant les namespaces, pivot_root, seccomp-bpf, la suppression de capacités (capability dropping) et un moteur de verdict basé sur les preuves (Truthimatics Public Version) pour une exécution de code sécurisée et vérifiable.
Bac à sable multicouche pour l'exécution de code natif sous Linux.
Sept couches d'isolation ordonnées — aucune dépendance externe, binaire PIE d'environ 81 Kio.
┌──────────────────────────────────────────────────────┐
│ Z-Jail │
├──────────────────────────────────────────────────────┤
│ rlimits (CPU, AS, NOFILE, NPROC caps) │
│ Namespaces (mount, pid, net, ipc, uts) │
│ pivot_root (chroot on steroids) │
│ NO_NEW_PRIVS (no privilege escalation) │
│ Capabilities (drop all, lock securebits) │
│ seccomp-BPF (whitelist-v1: 24 syscalls) │
│ Audit (JSON logging + BLAKE2b hashing) │
└──────────────────────────────────────────────────────┘
git clone https://github.com/Division-36/Z-Jail.git
cd Z-Jail
make
sudo ./z_jail --root=/path/to/rootfs --seccomp-enforce -- /bin/ls
Le répertoire --root doit contenir un système de fichiers minimal avec le binaire cible et ses dépendances (pour les binaires statiques, le binaire seul suffit).
Les solutions de sandbox existantes font des compromis :
| Z-Jail | Firecracker | gVisor | bwrap | nsjail | |
|---|---|---|---|---|---|
| Dépendances externes | zéro | libc, seccomp | Go runtime | libc | libc, protobuf |
| Taille du binaire | ~81 KiB | 20+ MiB | 40+ MiB | ~70 KiB | ~1 MiB |
| Isolation VM | non | oui (microVM) | non (sandbox) | non | non |
| Liste blanche seccomp | oui | non | oui | optionnelle | oui |
| Hachage de contenu | oui | non | non | non | non |
| Audit JSON | oui | non | oui | non | partiel |
| Complexité de build | un make | complexe | complexe | triviale | modérée |
Z-Jail comble le créneau entre bwrap (minimal, sans seccomp par défaut) et nsjail (riche en fonctionnalités, dépendances lourdes). Il est conçu pour les pipelines CI, les challenges de jail CTF et l'évaluation légère de code où vous avez besoin d'une défense en profondeur sans recourir à un runtime de conteneur.
flowchart LR
CLI[CLI args] --> P[parse_args]
P --> C{clone namespaces}
C -->|child| CR[child_run]
C -->|parent| W[waitpid]
CR --> RL[setrlimit]
RL --> FD[close fds >= 3]
FD --> DUMP[PR_SET_DUMPABLE=0]
DUMP --> PV[pivot_root]
PV --> NNP[PR_SET_NO_NEW_PRIVS]
NNP --> CAP[drop capabilities]
CAP --> SC[seccomp-BPF]
SC --> SIG[signal parent]
SIG --> EX[execve target]
W --> A[audit JSON]
A --> EXIT[exit]
Chaque couche est ordonnée de sorte qu'une couche ultérieure ne puisse pas être annulée par une couche antérieure :
capset après ce pointsequenceDiagram
participant P as Parent
participant C as Child
P->>C: clone (NEWNS|NEWPID|NEWNET|NEWIPC|NEWUTS)
Note over C: setrlimit(CPU, AS, NOFILE, NPROC)
Note over C: close(all fds > 2)
Note over C: PR_SET_DUMPABLE=0
Note over C: pivot_root → chdir("/") → umount -l
Note over C: PR_SET_NO_NEW_PRIVS
Note over C: capset(all zero) + securebits
Note over C: seccomp(SECCOMP_MODE_FILTER, whitelist)
C->>P: write(pipe, ready=1)
Note over C: execve(target)
P->>P: waitpid
P->>P: write audit JSON
Z-Jail applique sept mécanismes d'isolation ordonnés dans le processus enfant avant execve,
chacun étant choisi de sorte qu'une étape ultérieure ne puisse être annulée en réexécutant une étape antérieure.
Le parent crée l'enfant avec clone() en demandant cinq espaces de noms
(mount, PID, réseau, IPC, UTS), puis l'enfant exécute le pipeline suivant :
setrlimit plafonne le temps CPU, l'espace d'adressage, les fichiers ouverts et le nombre de processus
avant l'exécution de tout code influencé par l'invité, limitant les fork bombs et l'épuisement de la mémoire.
Tous les descripteurs hérités, à l'exception du pipe de rapport vers le parent, sont fermés,
empêchant la fuite de handles à travers execve.
PR_SET_DUMPABLE=0 désactive les core dumps et restreint l'accès à /proc/self/mem.
pivot_rootLa racine de l'espace de noms de montage est remplacée par le répertoire racine fourni :
le répertoire est monté en bind sur lui-même, pivot_root échange l'arbre de montage,
le processus fait un chdir vers la nouvelle racine, et l'ancienne racine est détachée de manière paresseuse
puis supprimée. C'est strictement plus fort que chroot(2) car l'ancienne
racine est démontée plutôt que simplement masquée.
NO_NEW_PRIVSPR_SET_NO_NEW_PRIVS empêche tout gain de privilèges ultérieur via des binaires setuid,
des capacités de fichiers ou des transitions LSM. Irréversible.
Les identifiants utilisateur et groupe sont modifiés tant que CAP_SETUID est encore détenu, après quoi
capset remet à zéro tous les ensembles de capacités et les securebits sont verrouillés, de sorte que
les capacités ne peuvent plus être réactivées.
Un filtre de liste blanche est installé ; les appels non présents dans la liste blanche sont terminés. Liste d'autorisation de 24 appels système :