Перейти к содержанию
← Back to Docs

Псевдонимы

Pseudonymize.io заменяет обнаруженные объекты детерминированными строками псевдонимов, называемыми псевдонимами.

Что это значит

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

Пример:

[email protected] → EMAIL_01
[email protected]   → EMAIL_02

Почему это существует

Общее редактирование (например, замена всех имен на [PERSON]) разрушает все связи внутри полезных данных. Псевдонимизация сохраняет сопоставление идентификаторов, поэтому последующие системы (например, LLM или аналитические системы) могут группировать действия одного и того же объекта, не зная, кто этот объект.

Точное поведение

  • Последовательное сопоставление. В пределах одной области запроса первое обнаруженное электронное письмо становится EMAIL_01, второе отдельное электронное письмо становится EMAIL_02 и т. д.
  • Зависит от типа: Псевдонимы всегда имеют префикс, указывающий тип объекта (например, PERSON_, ORG_, EMAIL_).
  • Стабильность. Псевдонимы строго стабильны в пределах одного запроса API (область действия по умолчанию). См. Области действия и Детерминизм для получения информации о стабильности перекрестных запросов.
  • Коллизии: благодаря детерминированному HMacing (если он включен), коллизии между отдельными исходными идентификаторами математически маловероятны.
  • Утечка порядка: Последовательные псевдонимы (_01, _02) изменяют порядок появления в конкретном документе. Обычно это приемлемо для контекста LLM, но может быть отключено с помощью политики, если требуется строгая непрозрачность.

Параметры API

Вы можете настроить формат псевдонима в полезных данных вашей политики:

{
  "policy": {
    "alias_format": "sequential" // or "hash"
  }
}