
Z-Jail v1.1.0
एक हल्का, बहु-परत वाला Linux सैंडबॉक्स जो namespaces, pivot_root, seccomp-bpf, capability dropping, और एक साक्ष्य-आधारित निर्णय इंजन (Truthimatics Public Version) को जोड़ता है — सुरक्षित, ऑडिट योग्य कोड निष्पादन के लिए।
Z-Jail
लिनक्स पर नेटिव कोड निष्पादन के लिए बहु-स्तरीय सैंडबॉक्स।
सात क्रमबद्ध आइसोलेशन परतें — कोई बाहरी निर्भरता नहीं, ~81 KiB PIE बाइनरी।
┌──────────────────────────────────────────────────────┐
│ 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) │
└──────────────────────────────────────────────────────┘
विषय-सूची
- त्वरित शुरुआत
- Z-Jail क्यों
- आर्किटेक्चर
- लेयर
- उपयोग
- बिल्ड और इंस्टॉल
- परीक्षण
- प्रदर्शन
- खतरा मॉडल
- दस्तावेज़ीकरण
- रोडमैप
- लाइसेंस
त्वरित शुरुआत
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
--root निर्देशिका में लक्ष्य बाइनरी और उसकी निर्भरताओं वाला एक न्यूनतम फ़ाइलसिस्टम होना चाहिए (स्टैटिक बाइनरी के लिए, केवल बाइनरी ही पर्याप्त है)।
Z-Jail क्यों
मौजूदा सैंडबॉक्सिंग समाधान समझौते करते हैं:
| Z-Jail | Firecracker | gVisor | bwrap | nsjail | |
|---|---|---|---|---|---|
| बाहरी निर्भरताएँ | शून्य | libc, seccomp | Go runtime | libc | libc, protobuf |
| बाइनरी आकार | ~81 KiB | 20+ MiB | 40+ MiB | ~70 KiB | ~1 MiB |
| VM आइसोलेशन | नहीं | हाँ (microVM) | नहीं (सैंडबॉक्स) | नहीं | नहीं |
| seccomp व्हाइटलिस्ट | हाँ | नहीं | हाँ | वैकल्पिक | हाँ |
| कंटेंट हैशिंग | हाँ | नहीं | नहीं | नहीं | नहीं |
| ऑडिट JSON | हाँ | नहीं | हाँ | नहीं | आंशिक |
| बिल्ड जटिलता | एक make | जटिल | जटिल | तुच्छ | मध्यम |
Z-Jail bwrap (न्यूनतम, डिफ़ॉल्ट रूप से seccomp रहित) और nsjail (सुविधा-संपन्न, भारी निर्भरताएँ) के बीच के स्थान को भरता है। इसे CI पाइपलाइनों, CTF जेल चुनौतियों, और हल्के कोड मूल्यांकन के लिए डिज़ाइन किया गया है जहाँ आपको कंटेनर रनटाइम शामिल किए बिना गहराई में रक्षा की आवश्यकता होती है।
आर्किटेक्चर
डेटा प्रवाह
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]
लेयर क्रमण
प्रत्येक लेयर को इस प्रकार क्रमबद्ध किया गया है कि बाद की लेयर को पहले की लेयर द्वारा पूर्ववत नहीं किया जा सके:
- setrlimit — किसी भी अन्य चीज़ से पहले CPU, एड्रेस स्पेस, फ़ाइल संख्या, प्रोसेस को सीमित करें
- fd scrub — रिपोर्ट पाइप को छोड़कर सभी विरासत में मिले fd बंद करें
- PR_SET_DUMPABLE=0 — कोर डंप अक्षम, /proc/self/mem लॉक डाउन
- pivot_root — होस्ट फ़ाइलसिस्टम से अलग करें; पुरानी रूट को आलसी रूप से अनमाउंट किया गया
- PR_SET_NO_NEW_PRIVS — इस बिंदु के बाद कोई setuid नहीं, कोई
capsetएस्केलेशन नहीं - drop_caps — सभी क्षमताओं को शून्य करें, securebits लॉक करें
- seccomp-BPF — सिसकॉल्स को केवल व्हाइटलिस्ट तक सीमित करें
- signal parent — पैरेंट को बताएं कि सैंडबॉक्स तैयार है
- execve — प्रोसेस को लक्ष्य बाइनरी से बदलें
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
परतें
Z-Jail execve से पहले चाइल्ड में सात क्रमबद्ध पृथक्करण तंत्र लागू करता है,
प्रत्येक इस तरह चुना गया है कि बाद के चरण को पहले वाले को पुनः निष्पादित करके पूर्ववत नहीं किया जा सके।
पैरेंट चाइल्ड को clone() के साथ बनाता है जिसमें पाँच नेमस्पेस का अनुरोध किया जाता है
(mount, PID, network, IPC, UTS), फिर चाइल्ड निम्नलिखित पाइपलाइन चलाता है:
1. संसाधन सीमाएँ
setrlimit किसी भी अतिथि-प्रभावित कोड के चलने से पहले CPU समय, पता स्थान, खुली फ़ाइलों, और प्रक्रिया गणना पर सीमा लगाता है, जिससे fork बम और मेमोरी की कमी सीमित होती है।
2. फ़ाइल-डिस्क्रिप्टर सफ़ाई
पैरेंट रिपोर्ट पाइप को छोड़कर सभी विरासत में मिले डिस्क्रिप्टर बंद कर दिए जाते हैं,
जिससे लीक हुए हैंडल execve को पार करने से रोके जाते हैं।
3. डंपेबिलिटी बंद
PR_SET_DUMPABLE=0 कोर डंप को अक्षम करता है और /proc/self/mem पहुँच को प्रतिबंधित करता है।
4. pivot_root
माउंट नेमस्पेस रूट को दिए गए रूट निर्देशिका से बदल दिया जाता है:
निर्देशिका को स्वयं पर बाइंड-माउंट किया जाता है, pivot_root माउंट ट्री की अदला-बदली करता है,
प्रक्रिया नए रूट पर chdir करती है, और पुराना रूट आलसी रूप से अलग किया जाता है
और हटा दिया जाता है। यह chroot(2) से कड़ाई से अधिक मजबूत है क्योंकि पिछला
रूट केवल छिपाया नहीं बल्कि अनमाउंट किया जाता है।
5. NO_NEW_PRIVS
PR_SET_NO_NEW_PRIVS setuid बाइनरी, फ़ाइल क्षमताओं, या LSM ट्रांज़िशन के माध्यम से किसी भी बाद के विशेषाधिकार लाभ को रोकता है। अपरिवर्तनीय।
6. क्षमता हटाना
उपयोगकर्ता और समूह ID तब बदले जाते हैं जब CAP_SETUID अभी भी धारित है, जिसके बाद
capset सभी क्षमता सेट को शून्य कर देता है और securebits लॉक हो जाते हैं, इसलिए
क्षमताओं को पुनः सक्षम नहीं किया जा सकता।
7. seccomp-BPF (whitelist-v1)
एक whitelist फ़िल्टर स्थापित किया जाता है; गैर-whitelisted कॉल समाप्त कर दिए जाते हैं। 24 सिसकॉल की अनुमति-सूची:
| सिसकॉल | संख्या | टिप्पणियाँ |
|---|---|---|
read | 0 | stdin |
write | 1 | stdout/stderr + रिपोर्ट पाइप |
openat | 257 | फ़ाइल पहुँच (open नहीं) |
close | 3 | — |
lseek | 8 | — |
brk | 12 | हीप प्रबंधन |
mmap | 9 | arg-प्रतिबंधित: flags == 0x22 बिल्कुल (MAP_PRIVATE|MAP_ANONYMOUS) और prot & PROT_EXEC == 0 |
munmap | 11 | — |
execve | 59 | स्टार्टअप पर एकल exec |
exit_group | 231 | स्वच्छ प्रक्रिया निकास |
rt_sigaction | 13 | सिग्नल हैंडलर |
rt_sigprocmask | 14 | सिग्नल मास्किंग |
getrandom | 318 | रैंडम संख्या स्रोत |
clock_gettime | 228 | समय-निर्धारण |
fstat | 5 | फ़ाइल मेटाडेटा |
arch_prctl | 158 | TLS सेटअप |
mprotect | 10 | arg-प्रतिबंधित: prot & PROT_EXEC == 0 (W^X संरक्षित करता है) |
prlimit64 | 302 | arg-प्रतिबंधित: new_limit == NULL पूर्ण 64-बिट (निम्न + उच्च शब्द दोनों शून्य; केवल-पढ़ने योग्य) |
readlinkat | 267 | — |
rseq | 334 | glibc पुनःआरंभ करने योग्य अनुक्रम |
set_robust_list | 273 | glibc थ्रेड इनिट |
set_tid_address | 218 | glibc इनिट |
access | 21 | — |
pread64 | 17 | — |