العودة إلى التحديثات
New releaseSep 10, 2026

pii-shield v2.2.3

سايدكار K8s بدون كود لتنظيف السجلات. يكتشف الأسرار عبر تحليل الانتروبيا، ويحافظ على سلامة JSON، ويخفي المعلومات الشخصية القابلة للتحديد (PII) بشكل حتمي. 🛡️

مشاركة

PII-Shield 🛡️

حاوية جانبية (sidecar) لتعقيم السجلات دون كتابة أي شيفرة لـ Kubernetes. تمنع تسريب البيانات (GDPR/SOC2) عبر حجب المعلومات الشخصية (PII) من السجلات قبل مغادرتها للـ pod.

يعمل PII-Shield داخل العملية نفسها — عبر CLI أو الحاوية الجانبية أو WASM. لا توجد واجهة API مستضافة ولا خادم تُرسَل إليه بياناتك.

الاسم نفسه، مشاريع مختلفة. هذا ليس وكيل الخصوصية PII Shield من مدونة مجتمع مطوري Microsoft (مايو 2026، vikasgautam18/pii-shield)، وليس منتجات حجب الأوامر piishield.ai أو piishield.com، وليس حزمة pii-shield على PyPI من Intellirim. حزمنا هي pii-shield-wasi على PyPI و@aragossa/pii-shield-wasi على npm؛ وفي النصوص نسمّي هذا المشروع الحاوية الجانبية PII-Shield.

Release License Docker Pulls Artifact Hub
OpenSSF Best Practices Go Report Card Test Coverage Sponsor

"لا تدع المعلومات الشخصية (PII) تسمّم نماذج الذكاء الاصطناعي الخاصة بك." يضمن PII-Shield ألّا تصل البيانات الحساسة أبدًا إلى مجموعة بيانات التدريب الخاصة بك، مما ينجيك من إعادة تدريب النموذج المفروضة بموجب GDPR.

[!WARNING] هل ترقّي إلى v2.0.0؟ نقلنا توزيع المستخدم النهائي إلى عمليات التثبيت القائمة على Helm والحاويات الجانبية الأصلية Distroless. لم يعد Kustomize مسار تثبيت إصدار مدعومًا لمستخدمي الإنتاج، رغم أن مستودع المشغّل (operator) لا يزال يحتفظ بهيكل Kustomize للتطوير المحلي وتوليد البيانات التعريفية (manifests). لم يعد الوصول إلى /bin/sh داخل الحاوية الجانبية PII-Shield مدعومًا. اقرأ دليل الترحيل.

نموذجا النشر

يقدّم PII-Shield طريقتين متميزتين للتكامل مع بنيتك التقنية:

  1. مشغّل Kubernetes (دون كتابة شيفرة): نموذج النشر الرائد لدينا. مشغّل K8s مؤتمت بالكامل يحقن حاوية جانبية Distroless عالية الأمان في الـ pods الخاصة بك لاعتراض السجلات وتعقيمها أثناء مرورها.
  2. WASM داخل العملية (للتكاملات الأساسية): لتحقيق أداء فائق، يمكن تضمين المحرك الأساسي مباشرة عبر WASM، مما يوفر زمن استجابة <1ms دون قفزات شبكية.

حالة المشروع وخارطة الطريق

PII-Shield أداة أمنية مفتوحة المصدر قيد التطوير النشط في مرحلة تثبيت الإنتاج. توفّر سلسلة إصدارات v2.x مخرجات CLI وحاويات وHelm/operator وWASM SDK قابلة للاستخدام. مسارات الحجب الأساسية جاهزة لعمليات النشر المضبوطة، بينما لا تزال بعض أوضاع نشر Kubernetes وضمانات سلسلة التوريد قيد التثبيت.

المكوّنالحالة
الماسح الأساسيصادر / عمليات نشر مضبوطة
الحاوية الجانبية CLIصادرة / عمليات نشر مضبوطة
مشغّل Kubernetesمرحلة التثبيت
حزم WASM SDKإصدار تجريبي صادر
تكامل بوابة Proxy-Wasmبحث وتطوير مخطط له
خادم القواعد (قواعد مركزية، لوحة تحكم)الإصدار الأول، صورة مستضافة ذاتيًا
وكيل تدقيق eBPF (يراقب stdout/stderr، لا يحجب أبدًا)تجريبي، انظر docs/ebpf-audit.md

انظر KNOWN_LIMITATIONS.md للاطلاع على حدود تثبيت الإنتاج الحالية.

لماذا PII-Shield؟

غالبًا ما ينسى المطورون حجب البيانات الحساسة. مرشّحات regex التقليدية في Fluentd/Logstash بطيئة وصعبة الصيانة وتستهلك معالجًا مكلفًا على مجمّعات السجلات.

يعمل PII-Shield مباشرةً بجوار حاوية تطبيقك:

  • محرك أساسي مُعزَّز للإنتاج: مُحسَّن لحاويات Kubernetes الجانبية (sidecars) مع تخصيصات ذاكرة منخفضة على المسارات الساخنة ومطابقة regex حتمية.
  • تحليل إنتروبيا واعٍ بالسياق: يكتشف الأسرار عالية الإنتروبيا حتى دون مفاتيح (مثل Error: ... 44saCk9...) عبر تحليل الكلمات المفتاحية السياقية.
  • قواعد regex مخصصة: تنقيح حتمي للبيانات المهيكلة (UUIDs، المعرّفات) يتجاوز فحوصات الإنتروبيا للأنماط المعروفة.
  • توقيعات أسرار مدمجة: بيانات الاعتماد ذات البادئة المُصدِرة — مفاتيح 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 فلا.
  • تغطية الانحدار والاختبار العشوائي (Fuzz): مُختبَر ضد حالات إجهاد تشمل البيانات الثنائية العشوائية، وتداخل JSON، والسجلات متعددة اللغات.
  • تجزئة حتمية: يستبدل الأسرار بتجزئات فريدة (مثل [HIDDEN:a1b2c])، مما يتيح لفريق ضمان الجودة ربط الأخطاء دون رؤية البيانات الخام.
  • جاهز للاستخدام مباشرةً: لا يتطلب أي تغييرات في الكود. يعمل مع أي لغة (Node، Python، Java، Go).
  • دعم القائمة البيضاء: يسمح صراحةً بالأنماط الآمنة (مثل تجزئات git، ومعرّفات النظام) باستخدام PII_SAFE_REGEX_LIST لمنع الإيجابيات الكاذبة.

إدارة PII-Shield عبر عشرات العناقيد؟

يحتفظ خادم القواعد بمجموعات القواعد في مكان واحد: يحرّر فريق الأمان مجموعةً في المتصفح، ويرى على الماسح الفعلي ما يفعله مسوّدة على أسطر سجل ملصقة، وينشر إصدارًا، وكل عنقود يسمّي فيه PiiPolicy المجموعة يسحبها برمز للقراءة فقط، دون إعادة تشغيل pod. لا يُرسَل أي شيء عن العنقود إليه ما لم يُفعّل العنقود قناة الإحصاءات، التي ترسل عدّادات فقط. يُشحَن كصورة ghcr.io/pii-shield/pii-shield-rules لمحيطك الخاص، انظر docs/rules-server.md. يمكن توقيع المنشورات بمفاتيح لا يحملها إلا الناشرون، وكل تغيير يُسجَّل في سجل نشاط، وقناة إحصاءات اختيارية تُظهر لكل عنقود أي إصدار قاعدة يعمل وكم قيمة أُخفيت، كعدّادات فقط. يعمل على SQLite، أو على Postgres لعدة نسخ؛ deploy/rules-server يشغّله على جهاز واحد مع HTTPS ونسخ احتياطي مستمر.

التكاملات

يُشحَن بناء WASM داخل العملية الخاص بـ PII-Shield داخل GuardSpine Code، وهو إجراء GitHub مفتوح المصدر لحوكمة كود الذكاء الاصطناعي، يضمّن الملف الثنائي ويذكر مصدره في ملف NOTICE الخاص به.

اعتبارات الأداء

قِيست في 2026-10-25 باستخدام CLI يقرأ من stdin ويكتب إلى ملف، على نواة Apple M1 واحدة (GOMAXPROCS=1)، وGo 1.27.3، ومجموعات بيانات من 200 000 سطر، ووسيط 5 تشغيلات، وmain بعد إصدار 2.2.8:

  • سجلات نصية (أسطر تطبيقية وبأسلوب syslog، بمتوسط 122 بايت): نحو 92 000 سطر/ث، و10.7 MiB/s.
  • سجلات JSON (أسطر مهيكلة بكائنات متداخلة، بمتوسط 161 بايت): نحو 90 000 سطر/ث، و13.8 MiB/s. تمر أسطر JSON عبر المُرمِّز الواعي بالاقتباسات، وليس encoding/json، ويُجري المسار الساخن نحو سبعة تخصيصات لكل سطر.
  • سجلات وصول nginx (بمتوسط 312 بايت، مع User-Agent في كل سطر): نحو 53 000 سطر/ث، و15.7 MiB/s. هذا الشكل هو الأبطأ الذي يراه الماسح، فاحسب الحجم بناءً عليه عندما تبدو سجلاتك هكذا.

المُنقّي (sanitizer) يعمل بخيط واحد، لذا فإن حدّ المعالج يمثّل سقفًا للإنتاجية (جدول تحديد الأحجام موجود في docs/sidecar-failure-modes.md). عادةً ما يكون نواة الخادم أبطأ من M1؛ قِس سجلاتك الخاصة باستخدام ./benchmark/run_benchmarks.sh (انظر Performance Benchmarks أدناه). تخضع بيانات JSON المتداخلة بعمق لحدّ من التكرار، لذا لا يمكن لسطر خبيث أن يستنزف المكدّس (stack).

Installation

الفئات