
pii-shield v2.2.3
लॉग सैनिटाइज़ेशन के लिए ज़ीरो-कोड K8s साइडकार। एंट्रोपी विश्लेषण के माध्यम से रहस्यों का पता लगाता है, JSON अखंडता को संरक्षित करता है, और PII को निर्धारित रूप से संपादित करता है। 🛡️
PII-Shield 🛡️
Kubernetes के लिए ज़ीरो-कोड लॉग सैनिटाइज़ेशन साइडकार। लॉग्स के पॉड से बाहर निकलने से पहले उनसे PII को रिडैक्ट करके डेटा लीक (GDPR/SOC2) को रोकता है।
PII-Shield इन-प्रोसेस चलता है — CLI, साइडकार, या WASM। कोई होस्टेड API नहीं है और कोई सर्वर नहीं है जिस पर आपका डेटा भेजा जाता है।
एक ही नाम, अलग-अलग प्रोजेक्ट। यह Microsoft डेवलपर-कम्युनिटी ब्लॉग (मई 2026, vikasgautam18/pii-shield) वाला PII Shield प्राइवेसी प्रॉक्सी नहीं है, न ही piishield.ai या piishield.com के प्रॉम्प्ट-रिडैक्शन उत्पाद हैं, और न ही Intellirim द्वारा PyPI पर उपलब्ध
pii-shieldपैकेज है। हमारे पैकेज PyPI परpii-shield-wasiऔर npm पर@aragossa/pii-shield-wasiहैं; गद्य में हम इस प्रोजेक्ट को PII-Shield साइडकार कहते हैं।
"PII को अपने AI मॉडल्स को ज़हरीला न बनाने दें।" PII-Shield सुनिश्चित करता है कि संवेदनशील डेटा कभी भी आपके ट्रेनिंग डेटासेट तक न पहुँचे, जिससे आपको GDPR-बाध्य मॉडल रीट्रेनिंग से बचाया जा सके।
[!WARNING] v2.0.0 में अपग्रेड कर रहे हैं? हमने एंड-यूज़र डिस्ट्रिब्यूशन को Helm-आधारित इंस्टॉल और Distroless Native Sidecars पर स्थानांतरित कर दिया है। Kustomize अब प्रोडक्शन उपयोगकर्ताओं के लिए समर्थित रिलीज़ इंस्टॉलेशन पथ नहीं है, हालाँकि ऑपरेटर रिपॉज़िटरी स्थानीय विकास और मैनिफ़ेस्ट जनरेशन के लिए अभी भी Kustomize स्कैफ़ोल्डिंग रखती है। PII-Shield साइडकार के अंदर
/bin/shएक्सेस अब समर्थित नहीं है। Migration Guide पढ़ें।
दो डिप्लॉयमेंट मॉडल
PII-Shield आपके स्टैक में एकीकृत होने के दो अलग-अलग तरीके प्रदान करता है:
- Kubernetes Operator (ज़ीरो-कोड): हमारा प्रमुख डिप्लॉयमेंट मॉडल। एक पूरी तरह से स्वचालित K8s Operator जो आपके पॉड्स में एक अत्यधिक सुरक्षित Distroless Sidecar इंजेक्ट करता है ताकि उड़ान में लॉग्स को इंटरसेप्ट और सैनिटाइज़ किया जा सके।
- इन-प्रोसेस WASM (कोर इंटीग्रेशन के लिए): अत्यधिक प्रदर्शन के लिए, कोर इंजन को सीधे WASM के माध्यम से एम्बेड किया जा सकता है, जो नेटवर्क हॉप्स के बिना
<1msलेटेंसी प्रदान करता है।
प्रोजेक्ट स्थिति और रोडमैप
PII-Shield एक सक्रिय रूप से विकसित ओपन-सोर्स सुरक्षा टूल है जो प्रोडक्शन-हार्डनिंग चरण में है। v2.x रिलीज़ लाइन उपयोग योग्य CLI, कंटेनर, Helm/operator, और WASM SDK आर्टिफ़ैक्ट्स प्रदान करती है। कोर रिडैक्शन पथ नियंत्रित डिप्लॉयमेंट के लिए तैयार हैं, जबकि कुछ Kubernetes डिप्लॉयमेंट मोड और सप्लाई-चेन गारंटी अभी भी स्थिर की जा रही हैं।
| घटक | स्थिति |
|---|---|
| कोर स्कैनर | रिलीज़ / नियंत्रित डिप्लॉयमेंट |
| CLI साइडकार | रिलीज़ / नियंत्रित डिप्लॉयमेंट |
| Kubernetes ऑपरेटर | स्थिरीकरण चरण |
| WASM SDKs | रिलीज़ बीटा |
| Proxy-Wasm गेटवे इंटीग्रेशन | नियोजित R&D |
| रूल सर्वर (केंद्रीय नियम, पैनल) | पहला संस्करण, सेल्फ-होस्टेड इमेज |
| eBPF ऑडिट एजेंट (stdout/stderr का अवलोकन करता है, कभी रिडैक्ट नहीं करता) | प्रयोगात्मक, देखें docs/ebpf-audit.md |
वर्तमान प्रोडक्शन-हार्डनिंग सीमाओं के लिए KNOWN_LIMITATIONS.md देखें।
PII-Shield क्यों?
डेवलपर्स अक्सर संवेदनशील डेटा को मास्क करना भूल जाते हैं। Fluentd/Logstash में पारंपरिक regex फ़िल्टर धीमे होते हैं, उन्हें बनाए रखना कठिन होता है, और लॉग एग्रीगेटर्स पर महँगी CPU खपत करते हैं।
PII-Shield आपके ऐप कंटेनर के ठीक बगल में स्थित है:
- प्रोडक्शन-हार्डनिंग कोर इंजन: Kubernetes साइडकार के लिए अनुकूलित, हॉट पाथ पर कम मेमोरी आवंटन और नियतात्मक regex मिलान के साथ।
- संदर्भ-जागरूक एंट्रॉपी विश्लेषण: संदर्भ कीवर्ड का विश्लेषण करके बिना कुंजियों के भी उच्च-एंट्रॉपी रहस्यों का पता लगाया (जैसे
Error: ... 44saCk9...)। - कस्टम Regex नियम: संरचित डेटा (UUIDs, IDs) के लिए नियतात्मक रिडैक्शन जो ज्ञात पैटर्न के लिए एंट्रॉपी जाँच को ओवरराइड करता है।
- अंतर्निहित सीक्रेट सिग्नेचर: इश्यूअर-प्रीफ़िक्स्ड क्रेडेंशियल — AWS और Google API कुंजियाँ, GitHub, Slack और Stripe टोकन, JWTs,
Bearerक्रेडेंशियल और PEM निजी-कुंजी ब्लॉक — अपने प्रारूप के आधार पर रिडैक्ट किए जाते हैं, इसलिए एक वैध कुंजी तब भी पकड़ी जाती है जब उसका बॉडी कम-एंट्रॉपी हो या थ्रेशोल्ड बढ़ा दिया गया हो। - आकार के आधार पर टेलीफ़ोन नंबर:
+वाले अंतर्राष्ट्रीय नंबर, उत्तरी अमेरिकी(555) 234-5678प्रारूप और फ़ोन-नामित कुंजी (phone,mobile,wa_id, ...) के अंतर्गत अंक छिपाए जाते हैं, भले ही अकेले अंक कभी रहस्य के रूप में स्कोर नहीं करते। - कुंजी के आधार पर पहचान संख्याएँ: किसी पहचान दस्तावेज़ को नामित करने वाली कुंजी (
idNumber,national_id,ssn,passport_number,tax_id, ...) के अंतर्गत अंक छिपाए जाते हैं;user_idयाorder_idजैसी रिकॉर्ड आईडी नहीं। - रिग्रेशन और फ़ज़ कवरेज: बाइनरी कचरा, JSON नेस्टिंग और बहुभाषी लॉग सहित तनाव परीक्षणों के विरुद्ध परीक्षण किया गया।
- नियतात्मक हैशिंग: रहस्यों को अद्वितीय हैश से बदलता है (जैसे,
[HIDDEN:a1b2c]), जिससे QA कच्चा डेटा देखे बिना त्रुटियों को सहसंबंधित कर सके। - ड्रॉप-इन: किसी कोड परिवर्तन की आवश्यकता नहीं। किसी भी भाषा (Node, Python, Java, Go) के साथ काम करता है।
- व्हाइटलिस्ट समर्थन: झूठे सकारात्मक परिणामों को रोकने के लिए
PII_SAFE_REGEX_LISTका उपयोग करके सुरक्षित पैटर्न (जैसे, git हैश, सिस्टम IDs) को स्पष्ट रूप से अनुमति दें।
दर्जनों क्लस्टरों में PII-Shield का प्रबंधन?
एक रूल सर्वर नियम सेट को एक ही स्थान पर रखता है: एक सुरक्षा टीम ब्राउज़र में एक सेट संपादित करती है, वास्तविक स्कैनर पर देखती है कि एक ड्राफ़्ट पेस्ट की गई लॉग पंक्तियों पर क्या प्रभाव डालता है, एक संस्करण प्रकाशित करती है, और प्रत्येक क्लस्टर जिसका PiiPolicy उस सेट को नामित करता है, उसे रीड-ओनली टोकन के साथ खींच लेता है, बिना पॉड रीस्टार्ट के। क्लस्टर के बारे में कुछ भी उसे तब तक नहीं भेजा जाता जब तक क्लस्टर स्टैट्स चैनल चालू न करे, जो केवल काउंटर भेजता है। यह आपकी अपनी परिधि के लिए इमेज ghcr.io/pii-shield/pii-shield-rules के रूप में शिप होता है, देखें docs/rules-server.md। प्रकाशनों पर केवल प्रकाशकों के पास मौजूद कुंजियों से हस्ताक्षर किए जा सकते हैं, प्रत्येक परिवर्तन एक गतिविधि लॉग में जाता है, और एक ऑप्ट-इन स्टैट्स चैनल प्रति क्लस्टर दिखाता है कि कौन सा नियम संस्करण चल रहा है और कितने मान छिपाए गए, केवल काउंटर के रूप में। यह SQLite पर, या कई इंस्टेंस के लिए Postgres पर चलता है; deploy/rules-server इसे HTTPS और निरंतर बैकअप के साथ एक मशीन पर चलाता है।
एकीकरण
PII-Shield का इन-प्रोसेस WASM बिल्ड GuardSpine Code के अंदर शिप होता है, जो एक ओपन-सोर्स AI कोड-गवर्नेंस GitHub Action है, जो बाइनरी को वेंडर करता है और इसे अपने NOTICE में श्रेय देता है।
प्रदर्शन संबंधी विचार
2026-10-25 को CLI द्वारा stdin पढ़ने और फ़ाइल लिखने, एक Apple M1 कोर (GOMAXPROCS=1), Go 1.27.3, 200 000-पंक्ति कॉर्पोरा, 5 रन का माध्यिका, 2.2.8 रिलीज़ के बाद main के साथ मापा गया: