Torna agli aggiornamenti
New releaseSep 10, 2026

pii-shield v2.2.3

Sidecar K8s zero-codice per la sanitizzazione dei log. Rileva i segreti tramite Entropy Analysis, preserva l'integrità del JSON e oscura i PII in modo deterministico. 🛡️

Condividi

PII-Shield 🛡️

Sidecar per la sanitizzazione dei log senza codice per Kubernetes. Previene le fughe di dati (GDPR/SOC2) oscurando i dati personali (PII) dai log prima che lascino il pod.

PII-Shield viene eseguito in-process — CLI, sidecar o WASM. Non esiste alcuna API ospitata né alcun server a cui vengono inviati i tuoi dati.

Stesso nome, progetti diversi. Questo non è il proxy per la privacy PII Shield del blog della community degli sviluppatori Microsoft (maggio 2026, vikasgautam18/pii-shield), non è i prodotti di redazione dei prompt piishield.ai o piishield.com, e non è il pacchetto pii-shield su PyPI di Intellirim. I nostri pacchetti sono pii-shield-wasi su PyPI e @aragossa/pii-shield-wasi su npm; nel testo chiamiamo questo progetto il sidecar PII-Shield.

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

"Non lasciare che i dati personali avvelenino i tuoi modelli di IA." PII-Shield garantisce che i dati sensibili non raggiungano mai il tuo dataset di addestramento, risparmiandoti il riaddestramento forzato dei modelli imposto dal GDPR.

[!WARNING] Stai aggiornando alla v2.0.0? Abbiamo spostato la distribuzione per gli utenti finali verso installazioni basate su Helm e Distroless Native Sidecars. Kustomize non è più un percorso di installazione supportato per il rilascio in produzione, sebbene il repository dell'operator mantenga ancora lo scaffolding Kustomize per lo sviluppo locale e la generazione dei manifest. L'accesso a /bin/sh all'interno del sidecar PII-Shield non è più supportato. Leggi la Guida alla migrazione.

Due modelli di deployment

PII-Shield offre due modi distinti per integrarsi nel tuo stack:

  1. Kubernetes Operator (senza codice): il nostro modello di deployment di punta. Un Kubernetes Operator completamente automatizzato che inietta un sidecar Distroless altamente sicuro nei tuoi pod per intercettare e sanitizzare i log al volo.
  2. WASM in-process (per integrazioni core): per prestazioni estreme, il motore core può essere incorporato direttamente tramite WASM, offrendo una latenza <1ms senza salti di rete.

Stato del progetto e roadmap

PII-Shield è uno strumento di sicurezza open-source in fase di sviluppo attivo, attualmente in una fase di consolidamento per la produzione. La linea di rilascio v2.x fornisce artefatti utilizzabili per CLI, container, Helm/operator e SDK WASM. I percorsi di redazione core sono pronti per deployment controllati, mentre alcune modalità di deployment su Kubernetes e le garanzie sulla supply chain sono ancora in fase di stabilizzazione.

ComponenteStato
Scanner coreRilasciato / deployment controllati
Sidecar CLIRilasciato / deployment controllati
Kubernetes operatorFase di stabilizzazione
SDK WASMBeta rilasciata
Integrazione gateway Proxy-WasmR&S pianificata
Rule server (regole centrali, pannello)Prima versione, immagine self-hosted
Agente di audit eBPF (osserva stdout/stderr, non redige mai)Sperimentale, vedi docs/ebpf-audit.md

Consulta KNOWN_LIMITATIONS.md per i limiti attuali del consolidamento per la produzione.

Perché PII-Shield?

Gli sviluppatori spesso dimenticano di mascherare i dati sensibili. I filtri regex tradizionali in Fluentd/Logstash sono lenti, difficili da mantenere e consumano CPU costosa sugli aggregatori di log.

PII-Shield si trova proprio accanto al container della tua applicazione:

  • Core Engine irrobustito per la produzione: ottimizzato per i sidecar Kubernetes, con allocazioni di memoria ridotte nei percorsi critici e matching regex deterministico.
  • Analisi dell'entropia consapevole del contesto: rileva segreti ad alta entropia anche senza chiavi (ad es. Error: ... 44saCk9...) analizzando le parole chiave del contesto.
  • Regole regex personalizzate: redazione deterministica per dati strutturati (UUID, ID) che ha la precedenza sui controlli di entropia per i pattern noti.
  • Firme dei segreti integrate: le credenziali con prefisso dell'emittente — chiavi API AWS e Google, token GitHub, Slack e Stripe, JWT, credenziali Bearer e blocchi di chiavi private PEM — vengono redatte in base al loro formato, così una chiave valida viene intercettata anche quando il suo corpo è a bassa entropia o la soglia è stata alzata.
  • Numeri di telefono per forma: i numeri internazionali con +, i formati nordamericani (555) 234-5678 e le cifre sotto una chiave dal nome telefonico (phone, mobile, wa_id, ...) vengono nascosti anche se le sole cifre non vengono mai considerate un segreto.
  • Numeri identificativi per chiave: le cifre sotto una chiave che indica un documento d'identità (idNumber, national_id, ssn, passport_number, tax_id, ...) vengono nascoste; un id di record come user_id o order_id no.
  • Copertura regressione e fuzz: testato su casi di stress tra cui dati binari casuali, annidamento JSON e log multilingua.
  • Hashing deterministico: sostituisce i segreti con hash univoci (ad es. [HIDDEN:a1b2c]), consentendo al QA di correlare gli errori senza vedere i dati grezzi.
  • Drop-in: nessuna modifica al codice necessaria. Funziona con qualsiasi linguaggio (Node, Python, Java, Go).
  • Supporto whitelist: consente esplicitamente pattern sicuri (ad es. hash git, ID di sistema) tramite PII_SAFE_REGEX_LIST per prevenire falsi positivi.

Gestire PII-Shield su decine di cluster?

Un rule server mantiene i set di regole in un unico posto: un team di sicurezza modifica un set nel browser, vede sullo scanner reale cosa fa una bozza alle righe di log incollate, pubblica una versione, e ogni cluster il cui PiiPolicy nomina quel set lo scarica con un token di sola lettura, senza riavviare i pod. Nulla relativo a un cluster viene inviato al server a meno che il cluster non attivi il canale delle statistiche, che invia solo contatori. Viene distribuito come immagine ghcr.io/pii-shield/pii-shield-rules per il tuo perimetro, vedi docs/rules-server.md. Le pubblicazioni possono essere firmate con chiavi detenute solo dai publisher, ogni modifica finisce in un registro delle attività, e un canale statistiche opt-in mostra per ciascun cluster quale versione delle regole è in esecuzione e quanti valori sono stati nascosti, solo come contatori. Funziona su SQLite, oppure su Postgres per più istanze; deploy/rules-server lo esegue su una singola macchina con HTTPS e backup continui.

Integrazioni

La build WASM in-process di PII-Shield è inclusa in GuardSpine Code, una GitHub Action open-source per la governance del codice basata su AI, che include il binario e lo accredita nel suo NOTICE.

Categorie