
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.
«Не позволяйте PII отравлять ваши AI-модели». PII-Shield гарантирует, что конфиденциальные данные никогда не попадут в ваш обучающий набор данных, избавляя вас от принудительного переобучения модели по требованию GDPR.
[!WARNING] Обновляетесь до v2.0.0? Мы перевели распространение для конечных пользователей на установку через Helm и Distroless Native Sidecars. Kustomize больше не является поддерживаемым путём установки релиза для production-пользователей, хотя репозиторий оператора по-прежнему сохраняет каркас Kustomize для локальной разработки и генерации манифестов. Доступ к
/bin/shвнутри sidecar PII-Shield больше не поддерживается. Прочитайте руководство по миграции.
Две модели развёртывания
PII-Shield предлагает два разных способа интеграции в ваш стек:
- Kubernetes Operator (без кода): наша флагманская модель развёртывания. Полностью автоматизированный K8s Operator, который внедряет высокозащищённый Distroless Sidecar в ваши поды для перехвата и санитизации логов на лету.
- 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.