Zurück zu den Updates
New releaseSep 10, 2026

pii-shield v2.2.3

Zero-code K8s Sidecar zur Protokollbereinigung. Erkennt Geheimnisse mittels Entropieanalyse, bewahrt die JSON-Integrität und schwärzt personenbezogene Daten deterministisch. 🛡️

Teilen

PII-Shield 🛡️

Zero-Code-Log-Sanitization-Sidecar für Kubernetes. Verhindert Datenlecks (DSGVO/SOC2), indem PII aus Logs redigiert wird, bevor sie den Pod verlassen.

PII-Shield läuft in-process — CLI, Sidecar oder WASM. Es gibt keine gehostete API und keinen Server, an den Ihre Daten gesendet werden.

Gleicher Name, andere Projekte. Dies ist nicht der PII Shield Privacy Proxy aus dem Microsoft Developer-Community-Blog (Mai 2026, vikasgautam18/pii-shield), nicht die Prompt-Redaction-Produkte piishield.ai oder piishield.com und nicht das pii-shield-Paket von Intellirim auf PyPI. Unsere Pakete sind pii-shield-wasi auf PyPI und @aragossa/pii-shield-wasi auf npm; im Fließtext nennen wir dieses Projekt das PII-Shield-Sidecar.

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

"Lassen Sie nicht zu, dass PII Ihre KI-Modelle vergiftet." PII-Shield stellt sicher, dass sensible Daten niemals Ihren Trainingsdatensatz erreichen, und erspart Ihnen ein durch die DSGVO erzwungenes Neutraining des Modells.

[!WARNING] Upgrade auf v2.0.0? Wir haben die Endnutzer-Distribution auf Helm-basierte Installationen und Distroless Native Sidecars umgestellt. Kustomize ist für Produktionsnutzer kein unterstützter Release-Installationspfad mehr, obwohl das Operator-Repository weiterhin Kustomize-Gerüste für die lokale Entwicklung und Manifest-Generierung bereithält. Der Zugriff auf /bin/sh innerhalb des PII-Shield-Sidecars wird nicht mehr unterstützt. Lesen Sie den Migrationsleitfaden.

Zwei Bereitstellungsmodelle

PII-Shield bietet zwei verschiedene Möglichkeiten der Integration in Ihren Stack:

  1. Kubernetes Operator (Zero-Code): Unser Flaggschiff-Bereitstellungsmodell. Ein vollständig automatisierter K8s-Operator, der ein hochsicheres Distroless-Sidecar in Ihre Pods injiziert, um Logs im laufenden Betrieb abzufangen und zu bereinigen.
  2. In-Process WASM (für Kernintegrationen): Für maximale Performance kann die Kern-Engine direkt über WASM eingebettet werden und bietet eine Latenz von <1ms ohne Netzwerkhops.

Projektstatus & Roadmap

PII-Shield ist ein aktiv entwickeltes Open-Source-Sicherheitstool in einer Produktionshärtungsphase. Die v2.x-Release-Linie liefert nutzbare CLI-, Container-, Helm/Operator- und WASM-SDK-Artefakte. Die Kern-Redaktionspfade sind für kontrollierte Bereitstellungen bereit, während einige Kubernetes-Bereitstellungsmodi und Supply-Chain-Garantien noch stabilisiert werden.

KomponenteStatus
Core-ScannerVeröffentlicht / kontrollierte Bereitstellungen
CLI-SidecarVeröffentlicht / kontrollierte Bereitstellungen
Kubernetes-OperatorStabilisierungsphase
WASM-SDKsVeröffentlichte Beta
Proxy-Wasm-Gateway-IntegrationGeplante F&E
Rule-Server (zentrale Regeln, Panel)Erste Version, selbst gehostetes Image
eBPF-Audit-Agent (beobachtet stdout/stderr, redigiert nie)Experimentell, siehe docs/ebpf-audit.md

Siehe KNOWN_LIMITATIONS.md für die aktuellen Grenzen der Produktionshärtung.

Warum PII-Shield?

Entwickler vergessen oft, sensible Daten zu maskieren. Traditionelle Regex-Filter in Fluentd/Logstash sind langsam, schwer zu warten und verbrauchen teure CPU auf Log-Aggregatoren.

PII-Shield sitzt direkt neben deinem App-Container:

  • Produktionsgehärtete Core Engine: Optimiert für Kubernetes-Sidecars mit geringen Speicherallokationen auf Hot Paths und deterministischem Regex-Matching.
  • Kontextbewusste Entropieanalyse: Hoch-entropische Secrets werden auch ohne Schlüssel erkannt (z. B. Error: ... 44saCk9...), indem Kontext-Schlüsselwörter analysiert werden.
  • Benutzerdefinierte Regex-Regeln: Deterministische Redaktion für strukturierte Daten (UUIDs, IDs), die Entropieprüfungen für bekannte Muster überschreibt.
  • Integrierte Secret-Signaturen: Mit Aussteller-Präfix versehene Credentials — AWS- und Google-API-Schlüssel, GitHub-, Slack- und Stripe-Tokens, JWTs, Bearer-Credentials und PEM-Private-Key-Blöcke — werden anhand ihres Formats redigiert, sodass ein gültiger Schlüssel auch dann erkannt wird, wenn sein Body niedrig-entropisch ist oder der Schwellenwert erhöht wurde.
  • Telefonnummern anhand ihrer Form: Internationale Nummern mit einem +, nordamerikanische Formen wie (555) 234-5678 und Ziffern unter einem telefonbenannten Schlüssel (phone, mobile, wa_id, ...) werden verborgen, obwohl Ziffern allein niemals als Secret gewertet werden.
  • Identitätsnummern anhand des Schlüssels: Ziffern unter einem Schlüssel, der ein Identitätsdokument benennt (idNumber, national_id, ssn, passport_number, tax_id, ...), werden verborgen; eine Datensatz-ID wie user_id oder order_id hingegen nicht.
  • Regressions- und Fuzz-Abdeckung: Getestet gegen Stressfälle einschließlich binärem Müll, JSON-Verschachtelung und mehrsprachigen Logs.
  • Deterministisches Hashing: Ersetzt Secrets durch eindeutige Hashes (z. B. [HIDDEN:a1b2c]), sodass QA Fehler korrelieren kann, ohne die Rohdaten zu sehen.
  • Drop-in: Keine Codeänderungen erforderlich. Funktioniert mit jeder Sprache (Node, Python, Java, Go).
  • Whitelist-Unterstützung: Sichere Muster (z. B. Git-Hashes, System-IDs) können explizit über PII_SAFE_REGEX_LIST erlaubt werden, um False Positives zu vermeiden.

PII-Shield über Dutzende von Clustern hinweg verwalten?

Ein Regel-Server hält die Regelsätze an einem Ort: Ein Sicherheitsteam bearbeitet einen Satz im Browser, sieht am echten Scanner, was ein Entwurf mit eingefügten Logzeilen macht, veröffentlicht eine Version, und jeder Cluster, dessen PiiPolicy den Satz benennt, zieht ihn mit einem schreibgeschützten Token, ohne einen Pod-Neustart. Nichts über einen Cluster wird an ihn gesendet, es sei denn, der Cluster aktiviert den Statistik-Kanal, der ausschließlich Zähler sendet. Er wird als Image ghcr.io/pii-shield/pii-shield-rules für deinen eigenen Perimeter ausgeliefert, siehe docs/rules-server.md. Veröffentlichungen können mit Schlüsseln signiert werden, die nur die Herausgeber besitzen, jede Änderung wird in einem Aktivitätsprotokoll festgehalten, und ein optionaler Statistik-Kanal zeigt pro Cluster, welche Regelversion läuft und wie viele Werte verborgen wurden — ausschließlich als Zähler. Er läuft auf SQLite oder auf Postgres für mehrere Instanzen; deploy/rules-server betreibt ihn auf einer Maschine mit HTTPS und kontinuierlichen Backups.

Integrationen

Der In-Process-WASM-Build von PII-Shield wird in GuardSpine Code ausgeliefert, einer quelloffenen GitHub Action für KI-Code-Governance, die das Binary einbindet und in ihrer NOTICE nennt.

Leistungsüberlegungen

Kategorien