Это фактическое описание продукта, а не юридическая консультация и не сертификат соответствия. Какие
из этих фактов значимы для вашего регулятора и что с ними делать — решение ваше и вашего юриста.
Кто чем владеет
Veriqa поставляется как код, который вы запускаете у себя. В self-hosted-модели это и есть весь ответ на вопрос «куда уходят данные»:- Контроллер — вы. База, ключевой материал и логи находятся на вашей инфраструктуре, под вашими строками подключения. Ничего не разворачивается за вас.
- Veriqa (вендор) не контроллер и не процессор данных ваших пользователей. Вендору Veriqa не передаётся ничего: продукт не связывается с вендором, не шлёт телеметрию и не имеет вендорского эндпоинта в принципе. Кроме ваших хранилищ, код подключается только к тому, что настроили вы: API мессенджеров, серверы SMTP и IMAP, провайдеры аккаунтов, HTTP-адаптеры каналов, шина RabbitMQ и коллектор OTLP (см. Что уходит за периметр).
- Провайдеры мессенджеров — ваши контрагенты, а не вендора Veriqa. MAX, Telegram и WhatsApp Cloud API видят сообщения, которые вы отправляете через собственные боты. Отношения с каждым из них у вас прямые.
Инвентарь персональных данных
Всё, чего касается поставляемый продукт, — и ничего сверх того.
Аватар. Telegram-адаптер скачивает аватар при выдаче токенов и только для клиента, запросившего
scope
avatar: без этого scope Veriqa не обращается к Telegram за фото. Адаптер берёт файл не больше
AvatarDataUri.MaxImageBytes (64 КиБ): изображение хранится в payload каждого токена с claim
picture, и предел ограничивает размер этих записей. Фото крупнее не передаётся. Выдача токенов
ждёт аватар не дольше 5 секунд. Некорректное или слишком большое значение от любого адаптера ядро
отбрасывает. Во всех этих случаях вход проходит без аватара.
Чего нет в списке: тела сообщений из канала (адаптер читает то, что нужно для опознания
отправителя и подтверждения, и не сохраняет остального) и любой долгоживущий профиль пользователя сверх собранных claims выше. Справочника пользователей
продукт не поставляет — см.
Идентичности каналов.
Умолчания сбора
Так продукт поставляется. Чтобы сбор начался, ваших действий не нужно; чтобы прекратить его, нужно действие. Исключения по умолчанию выключены: сыройUser-Agent инициатора, сам hop-режим,
а также отпечаток, страна и сырой User-Agent сканирующего телефона. У hop-режима есть своё
исключение, оно описано под таблицей.
Сам hop-режим поставляется выключенным. Для узла его включает
Veriqa:HopMode:Enabled, для одного
канала — Veriqa:Channels:{Channel}:HopEnabled, для одного приложения или тенанта — те же члены
записи клиента или записи тенанта. См. Veriqa:HopMode.
Исключение — канал со стартом только по коду (CodeStart.LinkCarriesTransaction = false):
его QR-код несёт hop-ссылку и при выключенном hop-режиме, на условиях из раздела
Старт по коду. Строки HopMode действуют везде, где открывают hop-ссылку,
поэтому, когда такой канал включён, IP и разобранный User-Agent сканирующего телефона
собираются по умолчанию.
Две оговорки, которые важнее самих флагов.
Геолокация включена по умолчанию, но по умолчанию бездействует. Для поиска нужны отдельный
пакет Veriqa.Core.AuthServer.MaxMind и локальная база .mmdb, а базовые пакеты не несут ни
того, ни другого. Без них провайдер объявляет себя недоступным, и гео-поля остаются пустыми — то
есть штатная установка местоположения не собирает, хотя флаг говорит true. Сбор начинается ровно с
добавлением базы. В standalone-образе пакет уже есть: там сбор начинается, как только вы смонтируете
базу и укажете на неё Veriqa:InitiatorContext:GeoIp:DatabasePath. Нужен ещё доверенный IP: пока пересылаемые заголовки принимаются от любого
источника (не заданы KnownProxies / KnownIPNetworks), поиск не выполняется.
IP собирается, но никогда не показывается и не логируется. Он попадает в снапшот внутри
транзакции и дальше не идёт. Сообщение подтверждения его не несёт (что в сообщении есть, перечислено
в разделе Что уходит за периметр), а диагностическая запись о недоверенной
конфигурации проксирования фиксирует код результата, а не адрес.
Контекст инициатора выключается одной секцией:
appsettings.json
Enabled: false снапшот не строится, а сообщение подтверждения просто не несёт строки
контекста. Можно и сузить, сохранив контекст: убрать region из DisplayFields или поставить
CollectIpAddress: false (тогда отпадёт и геолокация — искать будет не по чему). Подробности и
сужение на уровне приложения — в Контексте инициатора.
У контекста сканирующего телефона свой выключатель: Veriqa:HopMode:CollectScannerContext: false
останавливает его сбор, а hop-режим остаётся включённым.
Где это хранится
Идентичности каналов: по умолчанию не хранится ничего
Порт, который сохранял бы идентичность канала — id пользователя, телефон, email, отображаемое имя, upsert’ом, без TTL и без удаления, — этоIChannelIdentityRepository, и Veriqa не поставляет его
реализации и не регистрирует ни одной. Вход работает и без неё: разрешённая идентичность хранится
вместе с транзакцией и удаляется вместе с ней. Хранить эти данные бессрочно — действие, которое вы
совершаете осознанно, зарегистрировав свою реализацию; см.
Хранилища.
Сроки хранения
Итог: хранилище транзакций очищается примерно за пятнадцать минут после входа, и
единственное хранилище Veriqa, где что-то хранится днями, — журнал аудита. Всё, что хранится
бессрочно, добавили вы: репозиторий идентичностей канала, хранилище собранных claims или токены со
сроком, который выбрали вы.
Аудит включается двумя переключателями
Два независимых переключателя, и нужны оба:- Подключаемый пакет: хост, который не вызвал
AddVeriqaAuditTrail, журнала не имеет вовсе. Veriqa:Logging:Modeпоставляется какSystem, а записи пишутся только в режимеAudit.DisabledиSystemдля приёмника — одно и то же: не писать.
RetentionDays.
ConfigureRetention лишь настраивает частоту прохода и размер пакета — он не «включает» срок
хранения, и его отсутствие не оставляет записи без срока. Нулевой или отрицательный срок хранения
отвергается на старте, а не читается как «не хранить ничего».
Записи никто не удаляет только в одном случае — когда вы подали собственный приёмник через
UseSink<TSink>(). Записи тогда хранятся в вашем хранилище, встроенный проход не регистрируется, и
хост говорит об этом на старте. Границу такому хранилищу ставите вы.
appsettings.json
Что содержит запись аудита
Закрытый набор атрибутов, зафиксированный схемой, — по колонке на атрибут, без произвольного payload: момент, действующее лицо, код действия, объект (id транзакции), исход и код причины, плюс тип транзакции, тип канала, correlation id, тенант,client_id, локаль и часовой пояс интерфейса,
собственные безопасные детали канала и объявленный для него уровень проверки входящих событий.
Действующее лицо замаскировано. Для действия, которое пользователь совершил в канале, это
{канал}:{маскированный id} — читаемыми остаются не более двух последних символов идентификатора.
Немаскированное значение не покидает хранилища транзакций.
Ни IP, ни User-Agent, ни геолокация, ни отображаемое имя, ни email в запись аудита не попадают.
Контекст инициатора хранится в транзакции и удаляется вместе с ней.
Единственное исключение, которое можно включить, — параметры подтверждаемой операции: заявленный вид
действия и значения его слотов. Это предметные данные вашего приложения и в них может быть что
угодно, поэтому по умолчанию их нет, и в запись они копируются только по вашему требованию
(Подготовка к продакшну).
Шифрование
Прикладного шифрования хранимых персональных данных сверх этого одного защищённого поля нет, как нет
и собственного управления ключами. Если ваша модель угроз требует шифрования ПД при хранении, это
требование выполняется на слое хранения, которым управляете вы — шифрованные тома, TDE, защищённое
соединение с базой, — а не настройкой в Veriqa.
Секреты —
client_secret, токены ботов, учётные данные SMTP — хранятся в переменных окружения или
в хранилище секретов, а не в файлах конфигурации в репозитории. Пароли в лог не попадают: там, где пароль нужно
сравнить, сравнение идёт по SHA-256-хешу.
Ключи
Ключевой материал трёх видов хранится в трёх разных местах. Сертификаты подписи и шифрования токенов. ВDevelopment используются dev-сертификаты
OpenIddict. Вне Development загружаются ваши X.509-сертификаты — путём или base64
(Veriqa:OpenIddict:Server:SigningCertificate* / EncryptionCertificate*), и без них хост не
стартует.
Кольцо ключей DataProtection. Одними и теми же ключами защищены ожидания RP, cookie входа,
hop-ссылки и остальные значения из таблицы «Где это хранится»: у кого есть
кольцо, тот расшифрует ожидания и подделает эти значения. Храните его так же, как сертификат подписи.
В хосте Veriqa приоритет у Redis (Veriqa:DataProtection:RedisConnectionString), затем у каталога
(Veriqa:DataProtection:KeysDirectory). Если не задано ни то, ни другое, ASP.NET Core держит ключи
в своём расположении по умолчанию для учётной записи, под которой работает хост: в образе
контейнера это /home/app/.aspnet/DataProtection-Keys внутри контейнера, и ключи пропадают, когда
контейнер пересоздаётся, например при обновлении образа. После этого cookie, hop-ссылки и защищённые
ожидания активных транзакций уже не прочитать. Ключи хранятся незашифрованными, пока вы не задали
Veriqa:DataProtection:Certificate*, чтобы шифровать их сертификатом; в любом случае ограничьте
доступ к Redis или каталогу с ключами. Когда Veriqa работает внутри вашего приложения ASP.NET Core,
она использует кольцо приложения и ключи Veriqa:DataProtection:* не читает; шифрование ключей при
хранении (ProtectKeysWith*) тогда настраивает ваше приложение. Data Protection ротирует свои ключи сам, и
значения, записанные прежним ключом, читаются, пока тот в кольце, — так что кольцо на устойчивом
хранилище делает ротацию незаметной.
Секреты каналов и приложений — токены ботов, client_secret, учётные данные SMTP. Их ротация —
операция на стороне канала и клиента. Новый токен бота MAX или Telegram действует только после
перезапуска Veriqa: эти каналы строят клиент бота из токена один раз и держат его, пока работает
процесс, а канал WeChat делает то же с AppId и AppSecret. До перезапуска канал обращается к API
со старыми учётными данными: после отзыва утёкшего токена он перестаёт работать. Канал Viber читает
токен при каждом обращении, а канал Email — учётные данные SMTP для каждого письма, поэтому новый
токен Viber и новые учётные данные SMTP действуют после перечитывания конфигурации, без перезапуска.
Что уходит за периметр
Только то, что вы настроили. На одно подтверждение исходящее сообщение канала несёт:- имя приложения, начавшего вход;
- браузер, ОС и регион инициатора — там, где они известны и включены к показу;
- ссылку или кнопки подтверждения; сообщение о входе в чате называет ещё и время запроса, а письмо — срок, до которого действуют его ссылка или код;
- для подтверждения операции — текст вопроса со значениями слотов, которые передало ваше приложение, например суммой или получателем. Квитанция исхода несёт их, только если вы добавите эти слоты в её текст: в поставляемых текстах квитанций слотов нет.
User-Agent, ни профильных данных пользователя, ни почты и
телефона, которые ваше приложение ожидает от пользователя. Значения слотов уходят за периметр в
тексте сообщения, поэтому передавайте в них только то, что готовы показать провайдеру мессенджера.
Куда именно уходит сообщение, зависит от канала: platform-api2.max.ru для MAX, api.telegram.org
для Telegram, graph.facebook.com для WhatsApp Cloud API и Messenger*, api.twilio.com для WhatsApp
через Twilio, graph.instagram.com для Instagram*, api.weixin.qq.com для WeChat, chatapi.viber.com
для Viber и ваш собственный SMTP-сервер для Email. В обратную
сторону канал возвращает профиль отправителя — поля из таблицы инвентаря выше. Мессенджер видит
содержимое сообщения и получателя, потому что это и означает «доставить сообщение»; в канале Email
сообщение видно ровно настолько, насколько его видит ваш SMTP-релей.
Внешняя шина событий. Если подключить публикатор RabbitMQ, события транзакций покидают процесс,
неся только безопасную атрибуцию — в том числе маскированную идентичность канала. Параметры
подтверждаемой операции явно исключены из сериализации и на шину не попадают ни при какой настройке
аудита.
Другие исходящие подключения. Каждое появляется, только если вы его настроили:
- Почта через IMAP — сервис читает ящик на вашем почтовом сервере, а при входе по OAuth обращается ещё и к указанному вами адресу выдачи токена.
- Вход через аккаунт провайдера — адаптер обменивает код и запрашивает данные пользователя у провайдера (Google, Apple и других). Провайдер видит, кто входит.
- HTTP-адаптер канала — Veriqa шлёт на
Http:BaseUrlто же, что отправила бы в канал: текст вопроса, подписи кнопок и контекст запроса. Дальше данные обрабатывает ваш адаптер. - Коллектор OTLP — при заданном
OTEL_EXPORTER_OTLP_ENDPOINTтуда уходят метрики, трассировки и логи, включая текст записей с маскированными идентификаторами.
Логи
Логи приложения — не журнал аудита и не задуманы как доказательство. Для этой страницы важно, чего в них быть не должно и что с этим делает код: выше уровняDebug идентификаторы пишутся отпечатком
из 16 hex-символов (первые 8 байт SHA-256 без соли), а не в открытом виде, — так оператор
по-прежнему сшивает шаги одного входа. Отпечаток — псевдоним, а не анонимизация: короткий
идентификатор, например числовой id пользователя или номер телефона, читатель лога восстановит
перебором. Часть записей уровней Information и Warning вместо отпечатка несёт частичную маску: у
адреса почты остаются первый символ и домен (u***@example.com), у sub — два последних символа.
Поэтому логи уровня Information и выше относите к персональным данным. На уровне Debug
и ниже идентификаторы разрешено писать в открытом виде. Токены, секреты и IP инициатора не логируются
вовсе.
Это поставляемое поведение собственных лог-записей Veriqa. Ваш хост, ваш обратный прокси и
request-логирование платформы — вне его: access-лог перед auth-сервером по умолчанию пишет IP
клиентов, и границы ему ставятся тем же шагом развёртывания, что настраивает
ForwardedHeaders:KnownProxies.
Адрес hop-ссылки содержит токен в пути, а ASP.NET Core добавляет путь запроса к записям логов областью
(scope) RequestPath и пишет его в записях Request starting. Поэтому в поставляемых настройках хоста
категория Microsoft.AspNetCore.Hosting.Diagnostics стоит на уровне None, в общем правиле и для
поставщиков EventLog и EventSource: так убираются и область, и эти записи, а записи одного запроса
по-прежнему связывает TraceId. Только окружение Development оставляет категорию на уровне Information.
Токены hop-ссылок вернутся во все выводы логов, если поднять этот уровень или добавить для одного поставщика
правило, которое включает категорию, например Logging:Console:LogLevel:Default.
Во встраиваемом режиме задайте такие же уровни в своём хосте. TraceId останется, только если в хосте
включена трассировка. Без неё у записей одного запроса не будет общего идентификатора, а идентификатор
корреляции в записях аудита входа останется пустым.
Что остаётся решить вам
Ни у одного пункта нет правильного ответа, который продукт мог бы выбрать за вас.- Держать ли контекст инициатора вообще и добавлять ли базу GeoIP.
- Держать ли контекст телефона, который сканирует QR-код hop (
Veriqa:HopMode:Collect*): его IP, браузер, ОС и тип устройства по умолчанию собираются так же, как у инициатора. - Включать ли аудит, с каким сроком хранения и должны ли записи нести параметры подтверждаемых операций.
- Хранить ли идентичности каналов — и если да, как они удаляются.
- Включать ли хранилище собранных claims и с каким сроком хранения.
- Сколько истёкшие и отозванные записи токенов хранятся в базе OpenIddict до чистки.
- Где хранится кольцо ключей DataProtection.
- Шифрование при хранении, бэкапы и их сроки — на слое хранения.
- Как исполняется запрос пользователя на удаление по всем вашим хранилищам. Свои строки транзакций
Veriqa удаляет по собственному расписанию, а записи аудита — по сроку хранения; хранилище собранных
claims вы чистите по
sub(эндпоинтом или вызовом хоста); всё, что добавили вы, удаляете вы сами.
Дальше
Подготовка к продакшну
Чек-лист перед запуском в продакшн.
Хранилища
Какое хранилище что держит и как каждое подключается.
Известные ограничения
Чего продукт не делает.