
Z-Jail v1.1.0
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.
Z-Jail
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) │
└──────────────────────────────────────────────────────┘
Table des matières
- Démarrage rapide
- Pourquoi Z-Jail
- Architecture
- Couches
- Utilisation
- Compilation et installation
- Tests
- Performance
- Modèle de menace
- Documentation
- Feuille de route
- Licence
Démarrage rapide
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).
Pourquoi Z-Jail
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.
Architecture
Flux de données
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]
Ordre des couches
Chaque couche est ordonnée de sorte qu'une couche ultérieure ne puisse pas être annulée par une couche antérieure :
- setrlimit — limiter le CPU, l'espace d'adressage, le nombre de fichiers, les processus avant toute autre chose
- fd scrub — fermer tous les descripteurs de fichiers hérités sauf le pipe de rapport
- PR_SET_DUMPABLE=0 — vidages mémoire désactivés, /proc/self/mem verrouillé
- pivot_root — détacher du système de fichiers hôte ; ancienne racine démontée paresseusement
- PR_SET_NO_NEW_PRIVS — pas de setuid, pas d'escalade via
capsetaprès ce point - drop_caps — remettre à zéro toutes les capacités, verrouiller les securebits
- seccomp-BPF — restreindre les appels système à une liste blanche uniquement
- signal parent — informer le parent que le bac à sable est prêt
- execve — remplacer le processus par le binaire cible
sequenceDiagram
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
Couches
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 :
1. Limites de ressources
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.
2. Nettoyage des descripteurs de fichiers
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.
3. Désactivation de la dumpabilité
PR_SET_DUMPABLE=0 désactive les core dumps et restreint l'accès à /proc/self/mem.
4. pivot_root
La 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.
5. NO_NEW_PRIVS
PR_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.
6. Abandon des capacités
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.
7. seccomp-BPF (whitelist-v1)
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 :