Retour aux mises Ă  jour
New releaseSep 10, 2026

pii-shield v2.2.3

Sidecar K8s sans code pour l'assainissement des logs. Détecte les secrets via l'analyse d'entropie, préserve l'intégrité JSON et masque les PII de manière déterministe. 🛡️

Partager

PII-Shield 🛡️

Sidecar de désinfection des journaux sans code pour Kubernetes. Prévient les fuites de données (RGPD/SOC2) en masquant les données personnelles (PII) dans les journaux avant qu'elles ne quittent le pod.

PII-Shield s'exécute en processus — CLI, sidecar ou WASM. Il n'y a pas d'API hébergée ni de serveur vers lequel vos données sont envoyées.

Même nom, projets différents. Ce n'est pas le proxy de confidentialité PII Shield du blog de la communauté des développeurs Microsoft (mai 2026, vikasgautam18/pii-shield), ni les produits de masquage de prompts piishield.ai ou piishield.com, ni le paquet pii-shield sur PyPI d'Intellirim. Nos paquets sont pii-shield-wasi sur PyPI et @aragossa/pii-shield-wasi sur npm ; dans le texte, nous appelons ce projet le sidecar PII-Shield.

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

« Ne laissez pas les données personnelles empoisonner vos modèles d'IA. » PII-Shield garantit que les données sensibles n'atteignent jamais votre jeu de données d'entraînement, vous épargnant un réentraînement de modèle imposé par le RGPD.

[!WARNING] Vous passez à la v2.0.0 ? Nous avons déplacé la distribution aux utilisateurs finaux vers des installations basées sur Helm et des sidecars natifs Distroless. Kustomize n'est plus un chemin d'installation de version pris en charge pour les utilisateurs en production, bien que le dépôt de l'opérateur conserve encore l'échafaudage Kustomize pour le développement local et la génération de manifestes. L'accès à /bin/sh à l'intérieur du sidecar PII-Shield n'est plus pris en charge. Lisez le Guide de migration.

Deux modèles de déploiement

PII-Shield propose deux façons distinctes de s'intégrer à votre stack :

  1. Opérateur Kubernetes (sans code) : notre modèle de déploiement phare. Un opérateur K8s entièrement automatisé qui injecte un sidecar Distroless hautement sécurisé dans vos pods pour intercepter et désinfecter les journaux à la volée.
  2. WASM en processus (pour les intégrations cœur) : pour des performances extrêmes, le moteur cœur peut être intégré directement via WASM, offrant une latence <1ms sans sauts réseau.

État du projet et feuille de route

PII-Shield est un outil de sécurité open source activement développé, en phase de durcissement pour la production. La ligne de version v2.x fournit des artefacts CLI, conteneur, Helm/opérateur et SDK WASM utilisables. Les chemins de masquage cœur sont prêts pour des déploiements contrôlés, tandis que certains modes de déploiement Kubernetes et garanties de chaîne d'approvisionnement sont encore en cours de stabilisation.

ComposantStatut
Scanner cœurPublié / déploiements contrôlés
Sidecar CLIPublié / déploiements contrôlés
Opérateur KubernetesPhase de stabilisation
SDK WASMBêta publiée
Intégration de passerelle Proxy-WasmR&D planifiée
Serveur de règles (règles centrales, panneau)Première version, image auto-hébergée
Agent d'audit eBPF (observe stdout/stderr, ne masque jamais)Expérimental, voir docs/ebpf-audit.md

Voir KNOWN_LIMITATIONS.md pour les limites actuelles de durcissement pour la production.

Pourquoi PII-Shield ?

Les développeurs oublient souvent de masquer les données sensibles. Les filtres regex traditionnels dans Fluentd/Logstash sont lents, difficiles à maintenir et consomment un CPU coûteux sur les agrégateurs de journaux.

PII-Shield se place juste à côté de votre conteneur d'application :

  • Moteur central durci pour la production : OptimisĂ© pour les sidecars Kubernetes avec de faibles allocations mĂ©moire sur les chemins critiques et une correspondance regex dĂ©terministe.
  • Analyse d'entropie contextuelle : DĂ©tecte les secrets Ă  forte entropie mĂŞme sans clĂ©s (par ex. Error: ... 44saCk9...) en analysant les mots-clĂ©s de contexte.
  • Règles regex personnalisĂ©es : RĂ©daction dĂ©terministe pour les donnĂ©es structurĂ©es (UUID, ID) qui prime sur les vĂ©rifications d'entropie pour les motifs connus.
  • Signatures de secrets intĂ©grĂ©es : Les identifiants prĂ©fixĂ©s par l'Ă©metteur — clĂ©s API AWS et Google, jetons GitHub, Slack et Stripe, JWT, identifiants Bearer et blocs de clĂ©s privĂ©es PEM — sont rĂ©digĂ©s selon leur format, de sorte qu'une clĂ© valide est interceptĂ©e mĂŞme lorsque son corps est de faible entropie ou que le seuil a Ă©tĂ© relevĂ©.
  • NumĂ©ros de tĂ©lĂ©phone par forme : Les numĂ©ros internationaux avec un +, les formes nord-amĂ©ricaines (555) 234-5678 et les chiffres sous une clĂ© nommĂ©e tĂ©lĂ©phone (phone, mobile, wa_id, ...) sont masquĂ©s mĂŞme si les chiffres seuls ne sont jamais considĂ©rĂ©s comme un secret.
  • NumĂ©ros d'identitĂ© par clĂ© : Les chiffres sous une clĂ© qui dĂ©signe un document d'identitĂ© (idNumber, national_id, ssn, passport_number, tax_id, ...) sont masquĂ©s ; un identifiant d'enregistrement tel que user_id ou order_id ne l'est pas.
  • Couverture rĂ©gression et fuzzing : TestĂ© contre des cas de stress incluant des donnĂ©es binaires alĂ©atoires, l'imbrication JSON et des journaux multilingues.
  • Hachage dĂ©terministe : Remplace les secrets par des hachages uniques (par ex. [HIDDEN:a1b2c]), permettant Ă  l'assurance qualitĂ© de corrĂ©ler les erreurs sans voir les donnĂ©es brutes.
  • PrĂŞt Ă  l'emploi : Aucune modification de code requise. Fonctionne avec n'importe quel langage (Node, Python, Java, Go).
  • Prise en charge de la liste blanche : Autorise explicitement les motifs sĂ»rs (par ex. hachages git, ID système) via PII_SAFE_REGEX_LIST pour Ă©viter les faux positifs.

Gérer PII-Shield sur des dizaines de clusters ?

Un serveur de règles centralise les jeux de règles : une équipe de sécurité modifie un jeu dans le navigateur, voit sur le scanner réel l'effet d'un brouillon sur des lignes de journal collées, publie une version, et chaque cluster dont la PiiPolicy nomme le jeu le récupère avec un jeton en lecture seule, sans redémarrage de pod. Rien concernant un cluster ne lui est envoyé, sauf si le cluster active le canal de statistiques, qui n'envoie que des compteurs. Il est livré sous l'image ghcr.io/pii-shield/pii-shield-rules pour votre propre périmètre, voir docs/rules-server.md. Les publications peuvent être signées avec des clés que seuls les éditeurs détiennent, chaque modification est consignée dans un journal d'activité, et un canal de statistiques optionnel indique par cluster quelle version de règle s'exécute et combien de valeurs ont été masquées, sous forme de compteurs uniquement. Il fonctionne sur SQLite, ou sur Postgres pour plusieurs instances ; deploy/rules-server le déploie sur une seule machine avec HTTPS et des sauvegardes continues.

Intégrations

Catégories