भाग XI: त्वरित संदर्भ कार्ड¶
इसे टर्मिनल के पास रखें: बिल्ड करना, चलाना, कॉन्फ़िगर करना, रूट करना, निगरानी और निदान। पूरी तालिकाएँ भाग X में हैं; इस कार्ड में वह है जो ऑपरेटर टाइप करता है।
बिल्ड¶
cargo build --release -p sibuna # डेमन + SQLite + कंसोल
cargo build --release -p sibuna --no-default-features # मेमोरी में, कोई बाहरी क्रेट नहीं
cargo build --release -p sibuna --features postgres-tls # साझा PostgreSQL क्लस्टर
rustup target add wasm32-unknown-unknown # या SIBUNA_POW_WASM / SIBUNA_CONSOLE_WASM दें
cargo test # यूनिट, चलते डेमन, स्टोरेज और कंसोल के परीक्षण
cargo clippy --all-targets && cargo fmt --check
cargo xtask check # 70-पंक्ति / 1,408-पंक्ति / 99-कॉलम की जाँच
cargo xtask browser # headless Chromium में जाँचें
cargo xtask bench product # wrk के तहत पूरे उत्पाद -> benchmarks/results/
guidedog build # यह पुस्तक (guidedog dsc: SID रिकॉर्ड)
चलाना¶
# Shield (डिफ़ॉल्ट): PoW + WAF, :3000 तक प्रॉक्सी
sibuna -p 8080 -u 3000 -s /etc/sibuna/secret
# Gate: केवल PoW
sibuna --gate -p 8080 -u 3000 -s /etc/sibuna/secret
# Nginx/Caddy के पीछे forward auth (X-Forwarded-For पर भरोसा करता है)
sibuna -m forward_auth --host 127.0.0.1 -p 8080 -s /etc/sibuna/secret
# Edge: <dir>/sibuna.db में स्थायी नीतियाँ, प्रतिष्ठा, फ़ॉरेंसिक
sibuna -D /var/lib/sibuna -s /etc/sibuna/secret
# विश्वसनीय इनग्रेस से JA4 (Cloudflare का हेडर; nginx मॉड्यूल: x-ja4; ATS: ja4)
sibuna --ja4-header cf-ja4 --trust-forwarded -p 8080 -u 3000 -s /etc/sibuna/secret
# क्लस्टर सदस्य: साझा PostgreSQL, अद्वितीय नोड id
sibuna --database-url-file /etc/sibuna/database-url --cluster-node 1 -s /etc/sibuna/secret
head -c 32 /dev/urandom | xxd -p -c 64 > /etc/sibuna/secret
कंसोल (वैकल्पिक प्रीव्यू)¶
# डेमन बंद रहते हुए प्रारंभ करें, फिर कंसोल शुरू करें
sibuna init-admin admin --data-dir ./data
sibuna --data-dir ./data --console 127.0.0.1:19446
http://127.0.0.1:19446/console/ खोलें और अस्थायी पासवर्ड बदलें। नोड को ग्लोब पर रखने के लिए --console-location 1.3521,103.8198 जोड़ें। दूरस्थ पहुँच के लिए एक HTTPS प्रॉक्सी, एक स्पष्ट ऑरिजिन और trusted-proxy CIDR चाहिए; भाग IX का पालन करें। SID 0007 की स्थिति Committed है। कंसोल headless Chromium में अपने ब्राउज़र वर्कफ़्लो पास करता है (SID 0010, मानदंड 5); उसका औपचारिक प्रदर्शन-पृथक्करण गेट अभी खुला है (भाग VIII)।
सबसे पहले जानने योग्य फ़्लैग¶
| फ़्लैग | डिफ़ॉल्ट | अर्थ |
|---|---|---|
-d, --difficulty |
16 | वर्क बिट्स (PoSW गहराई = बिट्स - 3) |
-a, --algorithm |
posw | posw या hashcash |
--posw-challenges |
16 | प्रति प्रमाण ओपनिंग |
--token-ttl |
86400 | सत्र के सेकंड |
--challenge-ttl |
300 | चैलेंज के सेकंड |
--token-scheme |
mac | mac या ed25519 |
--rate-limit / --rate-window |
100 / 10 | प्रति विंडो GCRA बर्स्ट |
--ban-seconds |
3600 | हनीपॉट प्रतिबंध |
-w, --workers |
CPU की संख्या | accept थ्रेड |
--max-connections |
1024 | फिर 503 |
--max-connections-per-ip |
64 | प्रति पीयर पता (IPv6: प्रति --ipv6-prefix), फिर 503 |
--trusted-hops |
1 | क्लाइंट = दाईं ओर से n-वीं X-Forwarded-For प्रविष्टि |
--ja4-header |
बंद | इनग्रेस के JA4 फ़िंगरप्रिंट वाला हेडर; केवल भरोसा होने पर पढ़ा जाता है |
--idle-timeout |
15 | रीपर के सेकंड |
-P, --policy-file |
कोई नहीं | JSON नीति |
--trust-forwarded |
बंद | forward auth में चालू |
--secure-cookie |
बंद | Secure जोड़ें |
/__sibuna/ के अंतर्गत एंडपॉइंट¶
| रूट | उत्तर |
|---|---|
challenge |
इंटरस्टिशियल HTML |
challenge.json?need=&path= |
{id, algorithm, difficulty, challenges, expires_at} |
verify (POST) |
{challenge_id, nonce | proof} -> 200 + Set-Cookie, अन्यथा 400 |
wasm/sibuna-pow.wasm |
15,181-बाइट सॉल्वर |
worker.js |
WASM और JS प्रूवर वाला वर्कर |
honeypot |
कॉल करने वाले पर प्रतिबंध, 403; सबरिसोर्स या cross-site fetch के लिए 404 |
health |
{"status":"ok",...} |
metrics |
Prometheus टेक्स्ट |
इन सबको डेमन तक रूट करें, कभी ऑरिजिन तक नहीं।
स्टेटस कोड¶
| कोड | कब |
|---|---|
| 200 | स्वीकृत (forward auth), इंटरस्टिशियल, आंतरिक रूट |
| 400 | विकृत अनुरोध या लक्ष्य, अस्वीकृत समाधान (निदान वाली बॉडी) |
| 401 | चैलेंज आवश्यक: गैर-HTML क्लाइंट या forward auth |
| 403 | नीति या WAF द्वारा अस्वीकृति, प्रतिबंध, हनीपॉट |
| 404 | अज्ञात /__sibuna/ रूट, अस्वीकृत हनीपॉट हिट |
| 413 | समाधान की बॉडी 64 KB बफ़र से बड़ी |
| 414 | रिपोर्ट किया गया चैलेंज URL 8 KiB से बड़ा |
| 417 | असमर्थित अनुरोध अपेक्षा (expectation) |
| 429 | GCRA सीमा, Retry-After सेकंड |
| 431 | हेड 16 KB से बड़ा |
| 501 | chunked के अलावा कोई अन्य transfer coding |
| 502 | ऑरिजिन तक पहुँच नहीं या उसका उत्तर विकृत |
| 503 | कनेक्शन सीमाएँ पूरी, या नोड ड्रेन हो रहा है |
हेडर¶
- अपस्ट्रीम (प्रॉक्सी):
X-Forwarded-For(सॉकेट पीयर, विश्वसनीय होने पर प्राप्त शृंखला के बाद),X-Forwarded-Proto,X-Real-IP(जिस क्लाइंट का निर्णय हुआ),X-Sibuna-Status: PASS,X-Sibuna-Rule: <rule>; hop-by-hop और वैकल्पिक फ़ॉरवर्डिंग फ़ील्ड हटा दिए जाते हैं, अंडरस्कोर वाली वर्तनियाँ भी। - Forward-auth उत्तर:
X-Sibuna-Status,X-Sibuna-Rule,X-Sibuna-Rule-Hash। - चैलेंज उत्तर:
X-Sibuna-Status: CHALLENGE। - कुकी:
__sibuna_token=<75 chars, 139 with ed25519>; Path=/; Max-Age=<ttl>; HttpOnly; SameSite=Lax[; Secure]
नीति फ़ाइल का ढाँचा¶
{ "default_action": "CHALLENGE", "waf": true,
"thresholds": {"challenge_at": 10, "deny_at": 40, "bits_step": 5},
"ip_rules": {"10.0.0.0/8": "ALLOW", "2001:db8::/32": "DENY"},
"rules": [
{"name": "api", "path": "/api/*", "headers": {"X-Api-Key": ".*"}, "action": "ALLOW"},
{"name": "checkout", "path": "/checkout/*", "action": "CHALLENGE",
"challenge": {"difficulty": 20, "algorithm": "posw"}},
{"name": "login", "path": "^/login$", "action": "CHALLENGE",
"limits": {"rate": 10, "window_seconds": 60, "ban_seconds": 600}},
{"name": "old-tls", "ja4": "t12*", "action": "CHALLENGE"},
{"name": "headless", "user_agent": "Headless", "action": "WEIGH", "weight": 30} ] }
JA4: पूरा फ़िंगरप्रिंट, या प्रीफ़िक्स और *; फ़िंगरप्रिंट नहीं, तो मेल नहीं। पैटर्न: * या .* कुछ भी; ^...$ सटीक; अंत में * प्रीफ़िक्स; शुरू में / सटीक पाथ; अन्यथा केस-असंवेदी सबस्ट्रिंग। पाथ का मिलान सामान्य रूप (normal form) में होता है। क्रम: WAF -> trie deny/allow -> नियम -> स्कोर -> बायपास -> trie challenge -> बॉट -> डिफ़ॉल्ट।
SQL में स्टोरेज (Edge)¶
INSERT INTO policies (id, name, priority, path_pattern, action, difficulty, algorithm,
header_matchers, cidr_matchers, weight, enabled, created_at, updated_at)
VALUES ('p1', 'protect', 10, '/checkout/*', 'challenge', 20, 'posw', '{}', '[]', 0, 1,
unixepoch(), unixepoch());
INSERT INTO ip_reputation (ip_or_cidr, reputation_score, banned_until, trigger_rule, hits, last_seen)
VALUES ('198.51.100.7', -100, unixepoch() + 86400, 'analyst', 1, unixepoch());
SELECT s.client_ip, s.violation_category, s.path, s.campaign_id
FROM incidents_fts f JOIN security_incidents s ON s.id = f.rowid
WHERE incidents_fts MATCH 'union' ORDER BY rank LIMIT 20;
SQLite (sqlite3 <dir>/sibuna.db); एक्शन छोटे अक्षरों में हैं। स्कोर \(\le -50\) -> deny प्रीफ़िक्स; \(\ge 50\) -> allow। क्लस्टर: हर नोड पर एक ही सीक्रेट, एक PostgreSQL डेटाबेस, --features postgres-tls, --database-url-file <file> --cluster-node N जिसमें N, 1 से 8,388,607 तक अद्वितीय हो; कोई सदस्य सूची, लीडर या क्लस्टर TLS नहीं (SID 0011)।
निदान¶
| शीर्षक | अर्थ |
|---|---|
MALFORMED CHALLENGE |
id संपादित या छोटा कर दिया गया; नया लें |
INVALID CHALLENGE TAG |
इस सीड या नोड ने जारी नहीं किया |
CHALLENGE EXPIRED |
TTL से पुराना या घड़ी का अंतर > 60 s |
CLIENT FINGERPRINT MISMATCH |
पता या User-Agent बदल गया |
DIFFICULTY NOT MET |
नॉनस में शून्य बिट कम हैं |
INVALID PROOF OF SEQUENTIAL WORK |
ओपनिंग रूट तक नहीं पहुँचतीं |
WRONG SOLUTION TYPE |
PoSW के लिए नॉनस या Hashcash के लिए प्रमाण |
DOUBLE SPEND PREVENTED |
चैलेंज पहले ही उपयोग हो चुका |
STORE FULL |
spent set भर गया; TTL घटाएँ या --spent-tags बढ़ाएँ |
NETWORK BINDING MISMATCH |
कुकी किसी दूसरे क्लाइंट में कॉपी की गई |
INVALID COMMAND LINE |
अज्ञात विकल्प, गलत मान, या हटाया गया Zaxonlite विकल्प |
जिन मेट्रिक पर अलर्ट लगाएँ: denied, rate_limited, overloaded, upstream_errors, incidents_dropped, incident_write_failures, bans_refused, forwarded_invalid (सभी sibuna_*_total)।
याद रखने योग्य संख्याएँ¶
चैलेंज id 70 अक्षर (36-बाइट पेलोड + 16-बाइट टैग); टोकन 75 अक्षर (40 + 16), Ed25519 के साथ 139; प्रमाण के बाइट \(32(1 + t(n+1))\); PoSW गहराई = बिट्स - 3, सीमा 4 से 24; अनुरोध बफ़र 64 KB; हेड सीमा 16 KB; निरीक्षित बॉडी 8 KB; spent set 1,048,576 टैग (--spent-tags); रेट सेल प्रति टेबल 262,144 (--rate-table-cells); प्रतिबंध 65,536 स्लॉट (--ban-table-slots); प्रति क्लाइंट पता 64 कनेक्शन; घटना रिंग 512; बैच 32; सबसे हाल की 16,384 एम्बेडिंग पर कैंपेन दूरी 0.35; keep-alive प्रति कनेक्शन 4,096 अनुरोध; ऑरिजिन पूल 256 सॉकेट; स्टोरेज जॉब कतार 32।
इनग्रेस रूटिंग¶
भाग IX, इनग्रेस के पीछे Forward Auth, में दी गई Nginx या Caddy विधि का उपयोग करें। /__sibuna/* को सीधे रूट करें; एप्लिकेशन अनुरोधों को मूल URI, मेथड और विश्वसनीय क्लाइंट पते के साथ अधिकृत करें। आने वाले Sibuna ऑडिट हेडर को प्राधिकरण के परिणाम से बदलें। Nginx को चैलेंज, 429 और अनुपलब्ध auth के लिए स्पष्ट हैंडलिंग चाहिए।
reverse_proxy स्वीकृत HTTP/1.1 बॉडी और WebSocket ले जाता है; forward_auth प्रवेश देता है और उन्हें इनग्रेस ले जाता है। छोड़ी गई auth बॉडी और ऑरिजिन रिस्पॉन्स का Sibuna निरीक्षण या गिनती नहीं कर सकता। TLS इनग्रेस पर टर्मिनेट होता है; नेटिव HTTP/2 स्थगित है। अपलोड Content-Length या chunked coding का उपयोग करते हैं; निरीक्षण अधिकतम 8 KiB प्रीफ़िक्स देखता है, और फ़ाइल के बाइट अपारदर्शी रहते हैं।