Защита данных с CodeVeil

Это руководство показывает, как защищать конфиденциальные данные с помощью CodeVeil: маскирование PII, использование обфускации с сохранением формата, чтобы ваши тестовые данные оставались реалистичными, запуск крупных пакетных задач до 10 000 записей и получение уведомлений через вебхуки по их завершении.

Маскирование конфиденциальных полей

CodeVeil маскирует PII, финансовые данные и медицинские записи, сохраняя формат и ссылочную целостность — один и тот же клиент отображается в одно и то же маскированное значение везде, где он встречается. Отправьте записи на эндпоинт маскирования и укажите, какие поля защитить:

curl -X POST https://api.keepflow.ai/v1/codeveil/mask \
  -H "Authorization: Bearer kf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      { "name": "Jane Doe", "email": "[email protected]", "iban": "DE89370400440532013000" }
    ],
    "fields": {
      "name": "name",
      "email": "email",
      "iban": "iban"
    }
  }'

Обфускация с сохранением формата

Главное в полезных тестовых данных — они должны выглядеть и вести себя как настоящие. Обфусцированный вывод CodeVeil сохраняет ту же структуру, типы и связи, что и оригинал: e-mail остаётся похожим на настоящий, IBAN сохраняет код страны и форму контрольной суммы, номер телефона сохраняет свой шаблон.

{
  "name": "Marta Lindqvist",
  "email": "[email protected]",
  "iban": "DE21500105174829471138"
}

Поскольку формат сохранён, вы можете загрузить маскированный набор данных прямо в staging- или тестовое окружение, и все проверки, объединения и связи по внешним ключам продолжат работать.

Пакетная обработка

Для больших наборов данных отправляйте до 10 000 записей в одном запросе на пакетный эндпоинт. Задача выполняется асинхронно, поэтому вам не нужно держать соединение открытым:

curl -X POST https://api.keepflow.ai/v1/codeveil/batch \
  -H "Authorization: Bearer kf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "callback_url": "https://your-app.com/hooks/codeveil",
    "records": [ /* up to 10,000 records */ ],
    "fields": { "email": "email", "ssn": "national_id" }
  }'

В ответе возвращается идентификатор задачи, по которому можно опрашивать статус, либо вы можете дождаться вебхука.

{
  "data": { "job_id": "job_9f2a", "status": "processing", "record_count": 10000 }
}

Вебхуки о завершении

Вместо опроса зарегистрируйте callback_url, и CodeVeil отправит на него POST-запрос, когда задача будет выполнена. Нагрузка использует событие data.processed:

{
  "event": "data.processed",
  "timestamp": "2026-07-17T09:12:00Z",
  "data": {
    "job_id": "job_9f2a",
    "status": "completed",
    "record_count": 10000,
    "download_url": "https://api.keepflow.ai/v1/codeveil/results/job_9f2a"
  }
}

Проверьте заголовок X-KeepFlow-Signature с помощью секрета вебхука, прежде чем доверять нагрузке, а затем загрузите маскированный набор данных по ссылке download_url. Результаты доступны в течение 24 часов после завершения.