Политики

Категории, действия, списки, собственные правила и тестирование.

Адрес шлюза вашего региона: определяем…

Категории и действия

Для каждой категории политика задаёт действие: пропустить, предупредить, обобщить (диапазон, не восстанавливается), псевдонимизировать (с восстановлением) или заблокировать. Допустимые действия зависят от категории: например, пароли и токены можно только заблокировать или предупредить.

Шаблоны

Начните с шаблона: «Базовая», «Финансы и банки», «Юристы», «Здравоохранение», «HR и рекрутинг», «Строгая (M&A, аудит)». Шаблон — отправная точка, а не гарантия соответствия закону.

Белые и чёрные списки, словари и шаблоны

Белый список пропускает разрешённые значения (например, публичное название продукта). Чёрный список и словари находят ваши термины — с учётом словоформ. Собственные регулярные выражения (RE2) позволяют описать любые идентификаторы.

Кому применяется

Политика может действовать на всю организацию, группы, участников или отдельные API-ключи, а также только в заданный период — например, на время сделки. При совпадении нескольких политик побеждает более строгое действие.

Надёжность

on_detector_error определяет, что делать при недоступности распознавания имён: block (отклонить) или patterns_only (продолжить только с шаблонами). unknown_fields: reject отклоняет запросы с полями, которые шлюз не классифицирует.

Пример правил

Правила хранятся в JSON и проверяются схемой. Перед сохранением проверьте политику на тестовом тексте в редакторе — тест показывает результат этой политики отдельно от остальных.

{
  "schema_version": 1,
  "categories": {
    "PERSON": {"action": "pseudonymize"},
    "MONEY": {"action": "generalize"},
    "CARD": {"action": "block"},
    "MEDICAL": {"action": "block"}
  },
  "allowlist": [{"type": "exact", "value": "Айтечество"}],
  "dictionaries": [
    {"id": "projects", "label": "ПРОЕКТ", "terms": ["Северный поток", "Альфа-2"], "action": "pseudonymize", "morphology": true}
  ],
  "attachments": {"images": "block", "documents": "block", "audio": "block"},
  "on_detector_error": "block"
}