Перейти к основному содержанию
Это чек-лист того, что команды чаще всего упускают перед запуском в продакшн. Это не полное руководство по развёртыванию: здесь собраны только пункты, которые легко пропустить. Состояние галочек хранится локально в браузере; чтобы сохранить копию, распечатайте страницу в PDF средствами браузера.
Что продукт собирает, где хранит и сколько держит — инвентарь, умолчания сбора, сроки хранения и что уходит за периметр — вынесено на отдельную страницу: Безопасность и обработка данных. Этот чек-лист — про решения, которые принимаете вы; та страница — про факты, на которых вы их принимаете.

Issuer и сертификаты

  • Стабильный HTTPS issuer, актуальный JWKS, спланированная замена ключей.
Issuer должен быть постоянным HTTPS-адресом — он попадает в iss токенов и в discovery. Клиенты обязаны доверять ключам через discovery / JWKS, а не через ключи, зашитые в клиент: тогда замена ключа не требует правок на их стороне. Вне Development сертификаты подписи и шифрования обязательны в обоих режимах поставки, встроенном и self-hosted, — без них хост не стартует (ключи: справочник конфигурации).
Ротация без простоя не поддерживается. Конфигурация принимает один сертификат подписи и один сертификат шифрования, поэтому JWKS отдаёт один ключ подписи — перекрытия старого и нового нет. Замена сертификата делает недействительными выданные токены, подписанные прежним ключом; то же предупреждение — в self-hosted-старте. Планируйте замену ключей как операцию, после которой сессии становятся недействительными, а не как фоновую.

Клиентские секреты и хранение

  • client_secret и токены каналов — вне репозитория, через окружение, с шифрованием и ротацией.
Передавайте секреты (клиентские client_secret, токены ботов, ключи API каналов) только через переменные окружения или хранилище секретов — не через файлы конфигурации и не через git. Шифруйте их при хранении и регулярно меняйте.

OIDC PKCE и state

  • PKCE (S256) обязателен для публичных клиентов; валидируйте state и nonce.
Для публичных клиентов PKCE с методом S256 обязателен. state защищает от CSRF на редиректе, nonce привязывает id_token к сессии. Veriqa дополнительно проверяет одноразовый browser-nonce в callback — не отключайте эти проверки.

Redirect URIs

  • Только точное совпадение со списком разрешённых; без wildcard в продакшне; только https (кроме loopback при разработке).
Redirect URI сверяется точным совпадением. Wildcard в продакшне запрещён, http допустим только для loopback-адресов (localhost, 127.0.0.1, [::1]) при разработке.

Scopes и claims

  • Минимальный набор scopes; openid обязателен; не запрашивайте лишних персональных данных.
Запрашивайте минимум: openid обязателен, остальное — по необходимости. Не просите email, если он не нужен; не храните PII сверх требуемого. /userinfo отдаёт только claims, разрешённые scopes и конфигурацией.

Rate limiting и anti-abuse

  • Лимиты ядра подобраны под трафик каждого маршрута; ограничитель по IP стоит на reverse-proxy / WAF.
Ядро ограничивает публичные маршруты общими бакетами, по одному на группу: эндпоинты OIDC (authorize, callback, token), живой статус страницы входа (signalr, polling), вебхуки каналов, форма Email, отправка письма и ввод кода (email-start), маршруты входа через аккаунт провайдера (web-provider-pages), страницы, которые открывают ссылки из писем (email-link-pages), страницы подтверждения и страницы режима hop. Поверх этого ядро считает попытки входа по пользователю (channel identity), чтобы подтверждение нельзя было перебрать. Каждому relying party оно даёт собственный бюджет на серверном API подтверждения. Общие бакеты подбирайте под суммарный трафик маршрута: они защищают доступность, а не одного посетителя от другого. Маршруты каждого бакета, значения под ваше число пользователей и правило пересчёта приведены на странице Лимиты запросов под ваш трафик. Письма входа считаются ещё и по получателю: по адресу (по умолчанию 5 в час) и по домену. Лимит по домену по умолчанию выключен: один счётчик на домен заблокировал бы крупные домены почтовых сервисов. Включите его сами ключом SignInMailsPerDomain (см. Повторная отправка письма). Ограничитель по IP на краю эти счётчики не заменяют: того, кто вводит много адресов разных доменов, по-прежнему останавливает только общий бакет email-start или этот ограничитель. Ядро не считает лимиты по IP клиента и не блокирует адреса. Лимит по IP ловит то, чего не видят два других ключа, — горизонтальный перебор: много аккаунтов с одного адреса, каждый в пределах своего пользовательского лимита. Его ставят на краю сети, который у вас уже есть: limit_req в NGINX, rate-правило WAF, fail2ban по 429 в access-логе. Тем же шагом развёртывания настраивается ForwardedHeaders:KnownProxies (см. self-hosted, шаг 6): край видит реальный адрес клиента, ядро доверяет только тому, что край пробросил. Установка без ограничителя на краю открыта для такого перебора, поэтому поставьте его до запуска в продакшн. Конфигурация NGINX, которая ограничивает по адресу запросы входа и письма входа, приведена на странице За reverse-proxy.

Ротация refresh-токенов

  • Ротация и отзыв refresh-токенов не выключены.
Ротация refresh-токенов (EnableRefreshTokenRotation) и эндпоинт отзыва /connect/revoke (EnableRevocation) включены по умолчанию — не выключайте их. При повторном использовании уже погашенного refresh-токена (replay) OpenIddict сам отзывает всё семейство: все токены этой авторизации.

Логирование и аудит

  • Не логируйте токены / секреты / PII в своём коде; относите логи к персональным данным; включите аудит транзакций.
Токены и секреты в логи Veriqa не попадают. Выше уровня Debug идентификаторы записаны отпечатком или частичной маской, а это псевдоним, поэтому такие логи тоже относите к персональным данным. Включите журнал аудита транзакций — он даёт прослеживаемость входов и подтверждений. Журнал пишется по событиям транзакции — создание, подтверждение, завершение, отказ, истечение — и по security-событиям каналов. Каждая запись фиксирует время, действующее лицо, код события (action), объект и исход (result).
Два известных ограничения журнала — учтите их, планируя отчётность и разбор инцидентов.Выпуск токенов не аудируется. Ни первичный выпуск по authorization code, ни ротация refresh-токена аудит-записи не создают. Журнал пишется по событиям транзакции, а выпуск токенов через них не проходит и к транзакции не привязан. Ротация — тем более: она случается уже вне жизненного цикла транзакции. Не стройте доказательство выдачи токена на аудит-журнале: выпуск и ротацию контролируют отзыв токена и отзыв всего семейства при replay (см. Ротация refresh-токенов).Исход канальной security-записи неинформативен. У записей, порождённых security-событиями канала, поле исхода одинаково — «отказ», и так для любого кода канала. «Отказ» в такой строке не значит «что-то сломалось»: смысл события несёт код в поле action, а его словарь даёт документация конкретного канала. Фильтруйте и разбирайте такие записи по action, а не по исходу.
Параметры подтверждённой операции записываются только по явному включению. По умолчанию записи транзакции подтверждения не содержат, что именно подтверждали: объявленный вид действия и значения слотов — предметные данные вашего приложения и могут содержать персональные. Если журнал должен отвечать на вопрос «какая операция и с какими параметрами была подтверждена», включите это осознанно:
Program.cs
Включённые параметры копируются в саму запись, а не берутся по ссылке на транзакцию: завершённая транзакция удаляется через минуты, а запись остаётся в журнале весь срок хранения аудита. Их получает каждая аудит-запись такой транзакции — не только запись подтверждения, но и создание, завершение, отказ, истечение: вопрос «какая это была операция» задают и о них. Из процесса эти параметры не уходят — во внешнюю шину событий они не публикуются.

Уровень проверки входящего события канала

  • InboundVerification объявлен у каждой канальной секции — и объявлен осознанно.
Каждая канальная секция обязана нести InboundVerification: развёртывание с включённым поставляемым каналом без значения не стартует. Стартовая проверка перебирает тот же набор каналов, из которого ядро строит список включённых. Все поставляемые каналы в этом наборе есть, а канала стороннего адаптера, подключённого одним вызовом AddChannel, в нём нет — его секцию проверьте сами. Смотрите не на то, что ключ есть, а на то, что в нём написано: значение обязано соответствовать режиму, в котором канал реально работает (таблица — в Настройке каналов). Расхождение здесь тихое: канал в вебхук-режиме, которому объявили outbound_fetch, стартует молча. none — осознанный выбор, а не умолчание: он означает «подлинность входящего события не проверяется», то есть эндпоинт подтверждения этого канала принимает запрос от кого угодно. Ставьте его, только если действительно приняли этот риск, и заносите такое решение туда, где хранятся остальные решения о рисках.

Доступность каналов

  • Определите поведение при недоступности канала.
Заранее решите, что происходит, если канал недоступен: предложить альтернативный канал или показать понятную ошибку — но не «зависать» в незавершённой транзакции.

Локализация и доступность

  • WCAG 2.2 AA; locale-файлы для языков вашей аудитории.
Страницы входа и подтверждения проектируются под WCAG 2.2 AA. Отдельный хост из build/docker/Dockerfile поставляет переводы на английский, русский и китайский; во встроенном режиме каталог локалей поставляет ваш хост, и без него страница отображается на английском (см. Локализацию). Формального аудита доступности с публикуемым отчётом не проводилось — если он требуется вашему регламенту, планируйте его на своей стороне.

Версионирование и миграции

  • SemVer SDK; для реляционных хранилищ — миграции, а не авто-создание схемы.
Следуйте SemVer и планируйте обновления между minor / major. Реляционные хранилища инициализируйте миграциями (история схемы), а не авто-созданием.

Операционные основы

  • Health-probe, шифрованный канал к БД, хранилище секретов, внешний JS на странице входа выключен.
Настройте health-probe хоста, шифрованное соединение с БД и хранилище секретов. Внешний JS на странице входа по умолчанию запрещён — включайте только осознанно (см. кастомизацию).

Дальше

OIDC + Veriqa: разбор

Разберитесь, какое место Veriqa занимает в OIDC-потоке.