Retour aux mises à jour
New releaseJul 27, 2026

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.

Partager
Z-Jail

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

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-JailFirecrackergVisorbwrapnsjail
Dépendances externeszérolibc, seccompGo runtimelibclibc, protobuf
Taille du binaire~81 KiB20+ MiB40+ MiB~70 KiB~1 MiB
Isolation VMnonoui (microVM)non (sandbox)nonnon
Liste blanche seccompouinonouioptionnelleoui
Hachage de contenuouinonnonnonnon
Audit JSONouinonouinonpartiel
Complexité de buildun makecomplexecomplexetrivialemodé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 :

  1. setrlimit — limiter le CPU, l'espace d'adressage, le nombre de fichiers, les processus avant toute autre chose
  2. fd scrub — fermer tous les descripteurs de fichiers hérités sauf le pipe de rapport
  3. PR_SET_DUMPABLE=0 — vidages mémoire désactivés, /proc/self/mem verrouillé
  4. pivot_root — détacher du système de fichiers hôte ; ancienne racine démontée paresseusement
  5. PR_SET_NO_NEW_PRIVS — pas de setuid, pas d'escalade via capset après ce point
  6. drop_caps — remettre à zéro toutes les capacités, verrouiller les securebits
  7. seccomp-BPF — restreindre les appels système à une liste blanche uniquement
  8. signal parent — informer le parent que le bac à sable est prêt
  9. 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 :

Catégories