Персональные данные
Фильтр 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”.