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

Кто чем владеет

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 или токены со сроком, который выбрали вы.
Базу OpenIddict чистит сам auth-сервер. Фоновая задача раз в TokenPruneIntervalSeconds (1 ч) удаляет записи токенов и авторизаций, которые уже недействительны (истекли или отозваны) и созданы раньше, чем Veriqa:OpenIddict:Server:TokenPruneThresholdSeconds назад (по умолчанию 24 ч), — при любом провайдере хранилища. Действующие записи не удаляются. Пока запись не вычищена, её payload — для клиентов с avatar вместе с изображением аватара — лежит в базе, поэтому меньший порог сокращает срок хранения этих данных.

Аудит включается двумя переключателями

Два независимых переключателя, и нужны оба:
  1. Подключаемый пакет: хост, который не вызвал AddVeriqaAuditTrail, журнала не имеет вовсе.
  2. 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*), и без них хост не стартует.
Замена сертификата делает сессии недействительными. Конфигурация принимает ровно один сертификат подписи и один сертификат шифрования, поэтому в JWKS один ключ подписи и старый с новым нигде не пересекаются. Токены, подписанные прежним ключом, перестают проходить проверку в момент замены. Планируйте смену ключа как регламентное окно, а не как фоновую ротацию — то же предупреждение есть на странице «Подготовка к продакшну».
Кольцо ключей 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 действуют после перечитывания конфигурации, без перезапуска.

Что уходит за периметр

Только то, что вы настроили. На одно подтверждение исходящее сообщение канала несёт:
  • имя приложения, начавшего вход;
  • браузер, ОС и регион инициатора — там, где они известны и включены к показу;
  • ссылку или кнопки подтверждения; сообщение о входе в чате называет ещё и время запроса, а письмо — срок, до которого действуют его ссылка или код;
  • для подтверждения операции — текст вопроса со значениями слотов, которые передало ваше приложение, например суммой или получателем. Квитанция исхода несёт их, только если вы добавите эти слоты в её текст: в поставляемых текстах квитанций слотов нет.
Оно не несёт ни IP-адреса, ни сырого 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 (эндпоинтом или вызовом хоста); всё, что добавили вы, удаляете вы сами.

Дальше

Подготовка к продакшну

Чек-лист перед запуском в продакшн.

Хранилища

Какое хранилище что держит и как каждое подключается.

Известные ограничения

Чего продукт не делает.
* Instagram и Messenger — продукты компании Meta, признанной в России экстремистской организацией; её деятельность в стране запрещена.