Volver a actualizaciones
Nuevo releaseSep 10, 2026

pii-shield v2.2.3

Sidecar de K8s sin código para sanitización de logs. Detecta secretos mediante Análisis de Entropía, preserva la integridad JSON y redacta PII de forma determinista. 🛡️

Compartir

PII-Shield 🛡️

Sidecar de saneamiento de logs sin código para Kubernetes. Previene fugas de datos (GDPR/SOC2) redactando la PII de los logs antes de que salgan del pod.

PII-Shield se ejecuta en proceso — CLI, sidecar o WASM. No hay API alojada ni servidor al que se envíen tus datos.

Mismo nombre, proyectos diferentes. Este no es el proxy de privacidad PII Shield del blog de la comunidad de desarrolladores de Microsoft (mayo de 2026, vikasgautam18/pii-shield), ni los productos de redacción de prompts piishield.ai o piishield.com, ni el paquete pii-shield de Intellirim en PyPI. Nuestros paquetes son pii-shield-wasi en PyPI y @aragossa/pii-shield-wasi en npm; en prosa llamamos a este proyecto el sidecar PII-Shield.

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

"No dejes que la PII envenene tus modelos de IA." PII-Shield garantiza que los datos sensibles nunca lleguen a tu conjunto de datos de entrenamiento, evitando el reentrenamiento de modelos forzado por el GDPR.

[!WARNING] ¿Actualizando a v2.0.0? Hemos trasladado la distribución para usuarios finales a instalaciones basadas en Helm y sidecars nativos Distroless. Kustomize ya no es una ruta de instalación de release soportada para usuarios de producción, aunque el repositorio del operador aún conserva el andamiaje de Kustomize para desarrollo local y generación de manifiestos. El acceso a /bin/sh dentro del sidecar PII-Shield ya no está soportado. Lee la Guía de Migración.

Dos modelos de despliegue

PII-Shield ofrece dos formas distintas de integrarse en tu stack:

  1. Kubernetes Operator (sin código): Nuestro modelo de despliegue insignia. Un K8s Operator totalmente automatizado que inyecta un sidecar Distroless altamente seguro en tus pods para interceptar y sanear los logs sobre la marcha.
  2. WASM en proceso (para integraciones del núcleo): Para un rendimiento extremo, el motor del núcleo puede incrustarse directamente mediante WASM, ofreciendo una latencia <1ms sin saltos de red.

Estado del proyecto y hoja de ruta

PII-Shield es una herramienta de seguridad de código abierto en desarrollo activo, en fase de endurecimiento para producción. La línea de releases v2.x incluye artefactos utilizables de CLI, contenedor, Helm/operator y SDK de WASM. Las rutas de redacción del núcleo están listas para despliegues controlados, mientras que algunos modos de despliegue en Kubernetes y garantías de cadena de suministro aún se están estabilizando.

ComponenteEstado
Escáner del núcleoPublicado / despliegues controlados
Sidecar CLIPublicado / despliegues controlados
Kubernetes operatorFase de estabilización
SDK de WASMBeta publicada
Integración de gateway Proxy-WasmI+D planificada
Servidor de reglas (reglas centrales, panel)Primera versión, imagen autoalojada
Agente de auditoría eBPF (observa stdout/stderr, nunca redacta)Experimental, ver docs/ebpf-audit.md

Consulta KNOWN_LIMITATIONS.md para conocer los límites actuales de endurecimiento para producción.

¿Por qué PII-Shield?

Los desarrolladores a menudo olvidan enmascarar los datos sensibles. Los filtros regex tradicionales en Fluentd/Logstash son lentos, difíciles de mantener y consumen CPU costosa en los agregadores de logs.

PII-Shield se sitúa justo al lado del contenedor de tu aplicación:

  • Motor central endurecido para producción: Optimizado para sidecars de Kubernetes con bajas asignaciones de memoria en rutas críticas y coincidencia de regex determinista.
  • Análisis de entropía con contexto: Detecta secretos de alta entropía incluso sin claves (p. ej. Error: ... 44saCk9...) analizando palabras clave del contexto.
  • Reglas regex personalizadas: Redacción determinista para datos estructurados (UUIDs, IDs) que prevalece sobre las comprobaciones de entropía para patrones conocidos.
  • Firmas de secretos integradas: Las credenciales con prefijo de emisor —claves de API de AWS y Google, tokens de GitHub, Slack y Stripe, JWTs, credenciales Bearer y bloques de clave privada PEM— se redactan según su formato, de modo que una clave válida se detecta incluso cuando su cuerpo es de baja entropía o se ha elevado el umbral.
  • Números de teléfono por forma: Los números internacionales con +, los formatos norteamericanos (555) 234-5678 y los dígitos bajo una clave con nombre de teléfono (phone, mobile, wa_id, ...) se ocultan aunque los dígitos por sí solos nunca puntúen como secreto.
  • Números de identidad por clave: Los dígitos bajo una clave que nombra un documento de identidad (idNumber, national_id, ssn, passport_number, tax_id, ...) se ocultan; un id de registro como user_id u order_id no.
  • Cobertura de regresión y fuzzing: Probado contra casos de estrés que incluyen basura binaria, anidamiento JSON y logs multilingües.
  • Hashing determinista: Reemplaza los secretos con hashes únicos (p. ej., [HIDDEN:a1b2c]), lo que permite a QA correlacionar errores sin ver los datos sin procesar.
  • Integración directa: No requiere cambios en el código. Funciona con cualquier lenguaje (Node, Python, Java, Go).
  • Soporte de listas blancas: Permite explícitamente patrones seguros (p. ej., hashes de git, IDs de sistema) usando PII_SAFE_REGEX_LIST para evitar falsos positivos.

¿Gestionar PII-Shield en docenas de clústeres?

Un servidor de reglas mantiene los conjuntos de reglas en un solo lugar: un equipo de seguridad edita un conjunto en el navegador, ve en el escáner real qué efecto tiene un borrador sobre las líneas de log pegadas, publica una versión, y cada clúster cuyo PiiPolicy nombra el conjunto lo descarga con un token de solo lectura, sin reiniciar el pod. Nada sobre un clúster se le envía a menos que el clúster active el canal de estadísticas, que envía únicamente contadores. Se distribuye como la imagen ghcr.io/pii-shield/pii-shield-rules para tu propio perímetro; consulta docs/rules-server.md. Las publicaciones pueden firmarse con claves que solo poseen los publicadores, cada cambio va a un registro de actividad, y un canal de estadísticas opcional muestra por clúster qué versión de reglas se ejecuta y cuántos valores se ocultaron, solo como contadores. Se ejecuta sobre SQLite, o sobre Postgres para varias instancias; deploy/rules-server lo ejecuta en una sola máquina con HTTPS y copias de seguridad continuas.

Integraciones

La compilación WASM en proceso de PII-Shield se distribuye dentro de GuardSpine Code, una GitHub Action de gobernanza de código con IA de código abierto, que incorpora el binario y lo acredita en su NOTICE.

Categorías