Что продукт собирает, где хранит и сколько держит — инвентарь, умолчания сбора, сроки
хранения и что уходит за периметр — вынесено на отдельную страницу:
Безопасность и обработка данных. Этот чек-лист — про решения,
которые принимаете вы; та страница — про факты, на которых вы их принимаете.
Issuer и сертификаты
- Стабильный HTTPS issuer, актуальный JWKS, спланированная замена ключей.
iss токенов и в discovery.
Клиенты обязаны доверять ключам через discovery / JWKS, а не через ключи, зашитые в клиент: тогда
замена ключа не требует правок на их стороне. Вне Development сертификаты подписи и шифрования
обязательны в обоих режимах поставки, встроенном и self-hosted, — без них хост не стартует
(ключи: справочник конфигурации).
Клиентские секреты и хранение
-
client_secretи токены каналов — вне репозитория, через окружение, с шифрованием и ротацией.
client_secret, токены ботов, ключи API каналов) только через
переменные окружения или хранилище секретов — не через файлы конфигурации и не через git. Шифруйте
их при хранении и регулярно меняйте.
OIDC PKCE и state
- PKCE (
S256) обязателен для публичных клиентов; валидируйтеstateиnonce.
S256 обязателен. state защищает от CSRF на
редиректе, nonce привязывает id_token к сессии. Veriqa дополнительно проверяет одноразовый
browser-nonce в callback — не отключайте эти проверки.
Redirect URIs
- Только точное совпадение со списком разрешённых; без wildcard в продакшне; только
https(кроме loopback при разработке).
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.
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-токенов не выключены.
EnableRefreshTokenRotation) и эндпоинт отзыва /connect/revoke
(EnableRevocation) включены по умолчанию — не выключайте их. При повторном использовании уже
погашенного refresh-токена (replay) OpenIddict сам отзывает всё семейство: все токены этой
авторизации.
Логирование и аудит
- Не логируйте токены / секреты / PII в своём коде; относите логи к персональным данным; включите аудит транзакций.
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-файлы для языков вашей аудитории.
build/docker/Dockerfile поставляет переводы на английский, русский и китайский; во встроенном режиме каталог локалей
поставляет ваш хост, и без него страница отображается на английском (см.
Локализацию). Формального аудита доступности с
публикуемым отчётом не проводилось — если он требуется вашему регламенту, планируйте его на своей
стороне.
Версионирование и миграции
- SemVer SDK; для реляционных хранилищ — миграции, а не авто-создание схемы.
Операционные основы
- Health-probe, шифрованный канал к БД, хранилище секретов, внешний JS на странице входа выключен.
Дальше
OIDC + Veriqa: разбор
Разберитесь, какое место Veriqa занимает в OIDC-потоке.