pii-shield v2.2.0
Бескодовый sidecar для K8s для очистки логов. Обнаруживает секреты с помощью анализа энтропии, сохраняет целостность JSON и детерминированно скрывает PII. 🛡️
PII-Shield 🛡️
Sidecar для очистки логов от PII без написания кода в Kubernetes. Предотвращает утечки данных (GDPR/SOC2), удаляя PII из логов до того, как они покинут под.
PII-Shield работает внутри процесса — CLI, sidecar или WASM. Нет ни хостингового API, ни сервера, куда отправляются ваши данные.
Одинаковое название, разные проекты. Это не прокси-сервер конфиденциальности PII Shield из блога сообщества разработчиков Microsoft (май 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 больше не является поддерживаемым способом установки релиза для продакшн-пользователей, хотя репозиторий оператора по-прежнему содержит каркас Kustomize для локальной разработки и генерации манифестов. Доступ к
/bin/shвнутри sidecar PII-Shield больше не поддерживается. Прочитайте руководство по миграции.
Две модели развёртывания
PII-Shield предлагает два различных способа интеграции в ваш стек:
- Kubernetes Operator (без кода): Наша флагманская модель развёртывания. Полностью автоматизированный K8s Operator, который внедряет высокозащищённый Distroless Sidecar в ваши поды для перехвата и очистки логов на лету.
- Внутрипроцессный WASM (для интеграций в ядро): Для экстремальной производительности ядро движка может быть встроено напрямую через WASM, обеспечивая задержку
<1msбез сетевых переходов.
Статус проекта и дорожная карта
PII-Shield — активно развиваемый инструмент безопасности с открытым исходным кодом, находящийся в фазе подготовки к продакшену. Линейка релизов v2.x поставляет готовые к использованию артефакты CLI, контейнера, Helm/оператора и WASM SDK. Основные пути редактирования готовы к контролируемым развёртываниям, тогда как некоторые режимы развёртывания в Kubernetes и гарантии цепочки поставок всё ещё стабилизируются.
| Компонент | Статус |
|---|---|
| Ядро сканера | Выпущено / контролируемые развёртывания |
| CLI sidecar | Выпущено / контролируемые развёртывания |
| Kubernetes operator | Фаза стабилизации |
| WASM SDK | Выпущена бета-версия |
| Интеграция с Proxy-Wasm шлюзом | Запланированные R&D |
| UI панели управления | Запланированные R&D |
| Перехват через eBPF | Экспериментальные R&D |
См. KNOWN_LIMITATIONS.md для текущих границ подготовки к продакшену.
Почему PII-Shield?
Разработчики часто забывают маскировать конфиденциальные данные. Традиционные regex-фильтры в Fluentd/Logstash медленны, сложны в поддержке и потребляют дорогостоящий CPU на агрегаторах логов.
PII-Shield располагается прямо рядом с контейнером вашего приложения:
- Ядро движка, готовое к продакшену: Оптимизировано для sidecar-контейнеров Kubernetes с низким выделением памяти на горячих путях и детерминированным сопоставлением regex.
- Контекстно-зависимый энтропийный анализ: Обнаруживает высокоэнтропийные секреты даже без ключей (например,
Error: ... 44saCk9...) путём анализа контекстных ключевых слов. - Пользовательские regex-правила: Детерминированное редактирование структурированных данных (UUID, ID), которое переопределяет энтропийные проверки для известных шаблонов.
- Встроенные сигнатуры секретов: Учётные данные с префиксом эмитента — ключи AWS и Google API, токены 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, — нет. - Регрессионное и фаззинг-покрытие: Протестировано на стресс-случаях, включая бинарный мусор, вложенность JSON и многоязычные логи.
- Детерминированное хеширование: Заменяет секреты уникальными хешами (например,
[HIDDEN:a1b2c]), позволяя QA сопоставлять ошибки, не видя исходных данных. - Drop-in: Изменения кода не требуются. Работает с любым языком (Node, Python, Java, Go).
- Поддержка белого списка: Явно разрешайте безопасные шаблоны (например, git-хеши, системные ID) с помощью
PII_SAFE_REGEX_LISTдля предотвращения ложных срабатываний.
Управляете PII-Shield в десятках кластеров?
Мы создаём хостинговую панель управления с централизованным управлением правилами, оповещениями в Slack и аналитикой редактирования.
Интеграции
Внутрипроцессная сборка PII-Shield на WASM поставляется внутри GuardSpine Code, GitHub Action с открытым исходным кодом для управления AI-кодом, который включает бинарник и указывает его в своём NOTICE.
Соображения по производительности
Хотя PII-Shield высоко оптимизирован, глубокая проверка сложных логов требует внимательного отношения к конфигурации.
- Текстовые логи: Чрезвычайно быстро (>100k строк/с).
- JSON-логи: Парсинг с нулевым выделением памяти (без накладных расходов
encoding/json). Сканер вручную разбирает структуры JSON, чтобы обеспечить высокую пропускную способность (~7MB/s) без скачков памяти. - Рекомендация: Использование безопасно для высокой пропускной способности. Мы применяем защитные механизмы рекурсии для предотвращения переполнения стека на глубоко вложенном JSON.
Установка
Helm Chart (Kubernetes Operator)
Официальный и рекомендуемый способ развёртывания PII-Shield в Kubernetes — через наш полностью автоматизированный Operator:
helm repo add pii-shield https://pii-shield.github.io/pii-shield/
helm repo update
helm install pii-shield-operator pii-shield/pii-shield-operator -n operator-system --create-namespace
Это развёртывает PII-Shield Operator, который автоматически внедряет высокозащищённые distroless sidecar-контейнеры в ваши поды без необходимости изменений кода или Dockerfile.