Перейти к содержимому
EDT-Bridge
Русский
Esc
↑↓navigate↵open⌘Jpreview
На этой странице

Персональные данные

Фильтр EDT_BRIDGE_PII: какие ответы он маскирует, как находит персональные данные, режимы redact и pseudonym, свои правила и поля отфильтрованного ответа.

Тестовая база часто оказывается копией рабочей, а все, что инструмент из нее возвращает, уходит модели. Если EDT_BRIDGE_PII равна redact или pseudonym, ответы с данными базы фильтруются до отправки. По умолчанию фильтр выключен.

Как включить

Фильтр работает на двух сторонах, и каждая читает настройки своего процесса:

  • обвязка edt-bridge-mcp фильтрует edt_test_form, edt_unit_tests и их команды test-form и unit-tests;
  • плагин внутри EDT фильтрует свои инструменты.

Переменные задаются в описании сервера у MCP-клиента; обвязка читает их при запуске:

claude mcp add edt-bridge -e EDT_BRIDGE_PII=pseudonym -e EDT_BRIDGE_PII_SALT=<секрет> -- edt-bridge-mcp --workspace "D:\\path\\to\\edt-workspace"

EDT в режиме headless, которую запускает сама обвязка, наследует ее окружение, так что одной записи хватает на обе стороны. EDT, запущенная вручную, с интерфейсом или без, читает переменные своего процесса или свойства запуска -Dedt.bridge.pii, -Dedt.bridge.pii.salt и -Dedt.bridge.pii.rules после -vmargs; свойство запуска имеет приоритет над переменной. scripts/run-headless.ps1 и scripts/run-headless.sh передают все три переменные в EDT сами. Все три перечислены на странице Настройка.

Что фильтруется

Сторона Инструменты Что фильтруется
плагин edt_debug_inspect, edt_evaluate значения переменных и выражений в остановленном кадре
плагин edt_infobase_sessions, edt_infobase_maintenance, edt_designer_agent пользователи и компьютеры сеансов, а также персональные данные в остальном ответе
обвязка edt_test_form, test-form ответ, result.json, junit.xml и allure-results/; сохраняются только снимки веб-клиента с маской
обвязка edt_unit_tests, unit-tests ответ, result.json, junit.xml, allure-results/ и yaxunit.log; файлы, которые не являются текстом, удаляются

Ответы остальных инструментов не меняются. Тексты модулей, схемы компоновки данных и макеты не фильтруются никогда: модель записывает их обратно, поэтому их sourceHash не меняется.

Проверка по-прежнему сравнивает настоящие значения. Ее статус и итог каждого утверждения берутся из того, что видел клиент; маскируется только ответ. Поэтому в режиме redact два разных значения в expected и actual могут выглядеть одинаково; pseudonym их различает.

Как фильтр находит персональные данные

По виду значения, в любом месте строки:

Вид Что подходит
email адрес электронной почты
card от 13 до 19 цифр, с пробелами или дефисами, прошедшие проверку по алгоритму Луна
snils СНИЛС с верным контрольным числом
passport серия и номер паспорта, 45 01 123456 или 4501 № 123456
inn ИНН из 10 или 12 цифр с верными контрольными цифрами; число в составе дроби или похожее на дату и час, 2026111319, не трогается
phone российский номер телефона, начинающийся с +7 или 8

По имени поля. Имя человека по значению не распознать, поэтому заменяется любое значение поля, названного как персональные данные. Имя берется из соседних field, name или expression либо из колонки таблицы. Сравнивается только последняя часть имени через точку, целиком и без учета регистра: Контрагент.Телефон и ТелефонРабочий – телефоны, а ИмяФайла – не имя.

Вид Имена полей
person ФИО..., Фамилия..., Имя, Отчество..., FullName..., LastName..., FirstName..., MiddleName..., Surname...
birthdate ДатаРождения..., BirthDate..., DateOfBirth...
passport Паспорт..., Passport...
phone Телефон..., Phone...
address Адрес..., Address...
email ЭлектроннаяПочта..., ЭлПочта..., Email..., E-mail...

Пользователь и компьютер сеанса или события (user, userName, computer, host) заменяются целиком.

Имя в свободном тексте, например в сообщении Записан Иванов Иван, не находится: у него нет ни узнаваемого вида, ни имени поля.

Два режима

redact пишет вид значения: [inn]. pseudonym пишет вид и псевдоним: [inn#icbbphoh]. Псевдоним – это HMAC-SHA256 значения с солью. Одно и то же значение получает один псевдоним, как бы оно ни было записано: цифры с пробелами и без, телефон через 8 или +7, текст в любом регистре. Восстановить значение по псевдониму нельзя: таблицы соответствия нет.

Без EDT_BRIDGE_PII_SALT каждый процесс при запуске создает случайную соль. Тогда псевдонимы совпадают в пределах одного запуска обвязки или EDT, но у плагина и обвязки они разные и меняются от сеанса к сеансу. Для сравнения между сеансами соль задается явно; хранить ее в репозитории не следует.

Свои правила

EDT_BRIDGE_PII_RULES указывает на JSON-файл с правилами, которые добавляются к встроенным:

{
  "values": [
    {"kind": "contract", "pattern": "ДГ-[0-9]{6}"}
  ],
  "names": [
    {"kind": "person", "pattern": "Сотрудник.*"},
    {"kind": "account", "pattern": "ЛицевойСчет"}
  ]
}

Шаблон из values ищется в тексте каждого значения. Шаблон из names сравнивается с последней частью имени поля, целиком и без учета регистра. Плагин читает файл в Java, а обвязка в Python, поэтому в шаблонах используется только общий для них синтаксис: классы символов, повторения, группы, опережающие и ретроспективные проверки. Если файл не читается или шаблон не компилируется, вызов отклоняется, а не возвращает ответ без фильтра.

Поля отфильтрованного ответа

Поле Значение
piiFilter режим и число замененных значений: {"mode": "pseudonym", "masked": 3}
screenshotWithheld true вместо screenshot, когда у обвязки нет снимка с маской
filesWithheld сколько файлов запуска YAXUnit удалено, потому что фильтр не умеет их прочитать, например приложенная тестом картинка

Если фильтр завершился ошибкой, обвязка возвращает статус pii_filter_failed: ответ скрывается, а каталог вывода запуска очищается. notRemoved перечисляет файлы, которые удалить не удалось. Сообщение об ошибке содержит только класс сбоя, потому что в тексте исключения может оказаться значение, на котором фильтр остановился.

Если плагин не может прочитать свои настройки, инструмент возвращает ошибку, которая заканчивается словами “the answer of … is withheld”.

Последнее обновление 17 ноября 2026 г.

Эта страница была полезной?