
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. 🛡️
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-shieldsur PyPI d'Intellirim. Nos paquets sontpii-shield-wasisur PyPI et@aragossa/pii-shield-wasisur npm ; dans le texte, nous appelons ce projet le sidecar PII-Shield.
« 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 :
- 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.
- 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
<1mssans 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.
| Composant | Statut |
|---|---|
| Scanner cœur | Publié / déploiements contrôlés |
| Sidecar CLI | Publié / déploiements contrôlés |
| Opérateur Kubernetes | Phase de stabilisation |
| SDK WASM | Bêta publiée |
| Intégration de passerelle Proxy-Wasm | R&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
Beareret 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-5678et 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 queuser_idouorder_idne 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_LISTpour é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.