Sibuna पुस्तक 1.0.0-beta.3 दस्तावेज़
भाषा: हिन्दी
English简体中文한국어日本語EspañolDeutschहिन्दीالعربية
इस पृष्ठ पर

भाग 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 प्रीफ़िक्स देखता है, और फ़ाइल के बाइट अपारदर्शी रहते हैं।