Назад к обновлениям
New releaseSep 10, 2026

pii-shield v2.2.3

Бескодовый sidecar для K8s для очистки логов. Обнаруживает секреты с помощью анализа энтропии, сохраняет целостность JSON и детерминированно скрывает PII. 🛡️

Поделиться

PII-Shield 🛡️

Sidecar для санитизации логов в Kubernetes без написания кода. Предотвращает утечки данных (GDPR/SOC2), редактируя PII в логах до того, как они покинут под.

PII-Shield работает в процессе — CLI, sidecar или WASM. Нет ни хостингового API, ни сервера, на который отправляются ваши данные.

Одно название — разные проекты. Это не прокси конфиденциальности PII Shield из блога Microsoft developer-community (май 2026, vikasgautam18/pii-shield), не продукты редактирования промптов piishield.ai или piishield.com и не пакет pii-shield на PyPI от Intellirim. Наши пакеты — pii-shield-wasi на PyPI и @aragossa/pii-shield-wasi на npm; в тексте мы называем этот проект sidecar PII-Shield.

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

«Не позволяйте PII отравлять ваши AI-модели». PII-Shield гарантирует, что конфиденциальные данные никогда не попадут в ваш обучающий набор данных, избавляя вас от принудительного переобучения модели по требованию GDPR.

[!WARNING] Обновляетесь до v2.0.0? Мы перевели распространение для конечных пользователей на установку через Helm и Distroless Native Sidecars. Kustomize больше не является поддерживаемым путём установки релиза для production-пользователей, хотя репозиторий оператора по-прежнему сохраняет каркас Kustomize для локальной разработки и генерации манифестов. Доступ к /bin/sh внутри sidecar PII-Shield больше не поддерживается. Прочитайте руководство по миграции.

Две модели развёртывания

PII-Shield предлагает два разных способа интеграции в ваш стек:

  1. Kubernetes Operator (без кода): наша флагманская модель развёртывания. Полностью автоматизированный K8s Operator, который внедряет высокозащищённый Distroless Sidecar в ваши поды для перехвата и санитизации логов на лету.
  2. In-Process WASM (для интеграций в ядро): для максимальной производительности ядро движка может быть встроено напрямую через WASM, обеспечивая задержку <1ms без сетевых переходов.

Статус проекта и дорожная карта

PII-Shield — активно развиваемый open-source инструмент безопасности, находящийся в фазе production-hardening. Линейка релизов v2.x поставляет готовые артефакты CLI, контейнера, Helm/operator и WASM SDK. Основные пути редактирования готовы к контролируемым развёртываниям, тогда как некоторые режимы развёртывания в Kubernetes и гарантии цепочки поставок всё ещё стабилизируются.

КомпонентСтатус
Ядро сканераВыпущено / контролируемые развёртывания
CLI sidecarВыпущено / контролируемые развёртывания
Kubernetes operatorФаза стабилизации
WASM SDKВыпущено, бета
Интеграция шлюза Proxy-WasmПланируемые R&D
Сервер правил (центральные правила, панель)Первая версия, self-hosted образ
Агент аудита eBPF (наблюдает за stdout/stderr, никогда не редактирует)Экспериментальный, см. docs/ebpf-audit.md

Текущие границы production-hardening см. в KNOWN_LIMITATIONS.md.

Почему PII-Shield?

Разработчики часто забывают маскировать конфиденциальные данные. Традиционные regex-фильтры в Fluentd/Logstash медленны, сложны в поддержке и потребляют дорогостоящий CPU на агрегаторах логов.

PII-Shield располагается непосредственно рядом с контейнером вашего приложения:

  • Core Engine, усиленный для production: оптимизирован для sidecar-контейнеров Kubernetes: низкий объём выделений памяти на горячих путях и детерминированное сопоставление регулярных выражений.
  • Контекстно-зависимый энтропийный анализ: обнаруживает секреты с высокой энтропией даже без ключей (например, Error: ... 44saCk9...) за счёт анализа контекстных ключевых слов.
  • Пользовательские правила regex: детерминированное сокрытие структурированных данных (UUID, идентификаторы), которое переопределяет энтропийные проверки для известных шаблонов.
  • Встроенные сигнатуры секретов: учётные данные с префиксом эмитента — ключи API AWS и Google, токены GitHub, Slack и Stripe, JWT, учётные данные Bearer и блоки приватных ключей PEM — скрываются по своему формату, поэтому действительный ключ перехватывается, даже если его тело имеет низкую энтропию или порог был повышен.
  • Телефонные номера по форме: международные номера с +, североамериканские формы вида (555) 234-5678 и цифры под ключом с именем телефона (phone, mobile, wa_id, ...) скрываются, хотя одни только цифры никогда не оцениваются как секрет.
  • Идентификационные номера по ключу: цифры под ключом, обозначающим документ, удостоверяющий личность (idNumber, national_id, ssn, passport_number, tax_id, ...), скрываются; идентификатор записи, такой как user_id или order_id, — нет.
  • Покрытие регрессионными и fuzz-тестами: протестировано на стресс-сценариях, включая бинарный мусор, вложенность JSON и многоязычные логи.
  • Детерминированное хеширование: заменяет секреты уникальными хешами (например, [HIDDEN:a1b2c]), позволяя QA сопоставлять ошибки, не видя исходных данных.
  • Drop-in: изменения кода не требуются. Работает с любым языком (Node, Python, Java, Go).
  • Поддержка белого списка: явно разрешайте безопасные шаблоны (например, git-хеши, системные идентификаторы) с помощью PII_SAFE_REGEX_LIST, чтобы предотвратить ложные срабатывания.

Управление PII-Shield в десятках кластеров?

Сервер правил хранит наборы правил в одном месте: команда безопасности редактирует набор в браузере, видит на реальном сканере, как черновик обрабатывает вставленные строки логов, публикует версию, и каждый кластер, чей PiiPolicy указывает на этот набор, забирает его с токеном только для чтения, без перезапуска pod'а. Ничего о кластере на сервер не отправляется, если только кластер не включит канал статистики, который передаёт только счётчики. Он поставляется в виде образа ghcr.io/pii-shield/pii-shield-rules для вашего собственного периметра, см. docs/rules-server.md. Публикации могут быть подписаны ключами, которые есть только у издателей, каждое изменение попадает в журнал активности, а опциональный канал статистики показывает по каждому кластеру, какая версия правил работает и сколько значений было скрыто, — только в виде счётчиков. Работает на SQLite или на Postgres для нескольких экземпляров; deploy/rules-server запускает его на одной машине с HTTPS и непрерывным резервным копированием.

Интеграции

Внутрипроцессная WASM-сборка PII-Shield поставляется внутри GuardSpine Code — открытого GitHub Action для управления AI-кодом, который включает этот бинарник и указывает его в своём NOTICE.

Соображения по производительности

Категории