SPEC-SEC-01. Безопасность и персональные данные
1. Назначение
Документ задаёт модель аутентификации и авторизации гостя, классификацию и защиту данных, модель угроз, управление секретами, аудит, шифрование и соответствие 152-ФЗ, 54-ФЗ и требованиям платёжных систем.
2. Scope
Входит: контейнеры SPEC-ARCH-01 §3.2. Не входит: безопасность канала к замку и подпись офлайн-ключей (Сервис доступа, вне рамок), админ-панель.
3. Разделы, специфичные для типа
3.1. Auth model
Authn flow (OTP): номер E.164 → POST /auth/otp (rate limit: 1 запрос / 60 с на номер, 5 / час на номер, 20 / час на IP) → код из 6 цифр, TTL 5 мин, хранится в Redis как HMAC-SHA256 с солью → POST /auth/verify (5 попыток, затем блокировка номера на 10 мин) → access-токен JWT (ES256, TTL 15 мин) + refresh-токен (opaque, TTL 60 дней, ротация при каждом обновлении, привязка к устройству). Refresh-токен хранится в Keychain (iOS) и EncryptedSharedPreferences (Android).
Authz rules:
| Ресурс |
Неавторизованный |
Гость |
Гость с подтверждённой личностью |
| Каталог, карта, отзывы (чтение) |
да |
да |
да |
| Профиль, способы оплаты, история |
— |
только свои |
только свои |
| Создание брони |
— |
— |
да (SR-06#1) |
| Бронь, ключ, проживание |
— |
только свои |
только свои |
| Отзыв |
— |
— |
только на свою завершённую бронь (SR-41#2) |
| Чат поддержки |
— |
только свои диалоги |
только свои диалоги |
Проверка владения ресурсом выполняется в Core (не только в BFF) по guest_id из токена.
3.2. Классификация данных
| Класс |
Данные |
Защита |
| C3 — чувствительные |
серия, номер, дата и орган выдачи паспорта из ЕСИА; идентификатор esia_oid |
поля схемы identity с шифрованием pgcrypto отдельным ключом KMS; доступ только esia-identity-service; в API клиенту — маска паспорта, кроме 4 последних цифр; фото документов и биометрия не собираются (решение заказчика 11.11.2026, B-035) |
| C2 — ПДн |
ФИО и дата рождения из ЕСИА, телефон, email, уровень доверия и время подтверждения личности, история броней, геопозиция в запросе |
схема identity с шифрованием полей (pgcrypto, ключ из KMS); геопозиция не сохраняется |
| C2 — платёжные |
токен карты провайдера, маска «•• 0004» |
PAN и CVC не попадают в систему (форма провайдера, PCI DSS SAQ A) |
| C1 — внутренние |
брони без ПДн, статусы, тарифы |
стандартная защита |
| C0 — публичные |
каталог, отзывы (имя + инициал) |
— |
3.3. Threat model (STRIDE)
| № |
Категория |
Угроза |
Mitigation |
| T1 |
Spoofing |
перебор OTP-кода |
6 цифр, 5 попыток, блокировка 10 мин, rate limit на IP |
| T2 |
Spoofing |
угон refresh-токена |
ротация, привязка к устройству, отзыв всех сессий при входе на новом устройстве по выбору гостя |
| T3 |
Tampering |
подмена цены на клиенте |
цена берётся из серверной котировки quote_id с TTL 10 мин; клиент не передаёт сумму |
| T4 |
Tampering |
повтор запроса оплаты |
ключ идемпотентности на каждом мутирующем запросе, уникальный индекс в ledger |
| T5 |
Repudiation |
спор о списании |
append-only ledger, связь каждой операции с событием брони; чек ОФД |
| T6 |
Information disclosure |
IDOR — чужая бронь по номеру |
проверка владения в Core; идентификаторы — UUID; номер брони A-1042 только для отображения |
| T7 |
Information disclosure |
утечка паспортных данных или перехват кода авторизации ЕСИА |
шифрование полей C3 отдельным ключом; PKCE и одноразовый state в OAuth2; обмен кода на токен только на сервере; токены ЕСИА не сохраняются; аудит доступа |
| T8 |
Information disclosure |
резервный код на экране |
скрыт до «Показать», запрет скриншотов на C-22 (Android FLAG_SECURE; iOS — скрытие при снимке) |
| T9 |
Denial of service |
спам SMS (SMS pumping) |
rate limit, капча после 3 запросов с IP, блок-лист префиксов |
| T10 |
Denial of service |
захват всех капсул неоплаченными бронями |
лимит 1 бронь «Ожидает оплаты» на гостя, автоотмена через 10 мин (SR-24#4) |
| T11 |
Elevation of privilege |
доступ гостя к API админ-панели |
разные аудитории JWT; BFF гостя не проксирует админ-эндпоинты |
3.4. Secrets management
Секреты (ключи провайдеров, ключ подписи запросов ЕСИА, ключ подписи JWT, ключи KMS) — в Yandex Lockbox; в репозитории и образах их нет; ротация ключа JWT — 90 дней с периодом перекрытия; доступ — по сервисным аккаунтам с минимальными правами.
3.5. Аудит
Логируются: вход и выход, выдача и отзыв токенов, просмотр C3-данных (кто, когда, чьи), изменение способов оплаты, каждая денежная операция, запрос на удаление аккаунта. Хранение журнала — 1 год (ПДн в журнале маскируются). Доступ — служба безопасности.
3.6. Шифрование
In-transit: TLS 1.2+ (предпочтительно 1.3), certificate pinning в приложении по публичному ключу с резервным ключом. At-rest: шифрование дисков облака; поля C2 — pgcrypto; поля C3 — pgcrypto с отдельным ключом KMS. Key management — Yandex KMS, ротация ежегодно.
3.7. Compliance mapping
| Норма |
Пункт |
Реализация |
| 152-ФЗ |
ст. 9 (согласие) |
отдельный чекбокс согласия на C-02, реестр согласий consent-registry с версией текста |
| 152-ФЗ |
ст. 9 (согласие на получение данных из ЕСИА) |
отдельный чекбокс согласия на C-05 до перехода в ЕСИА; биометрия не обрабатывается (ст. 11 не применяется) |
| Регламент ЕСИА |
подключение информационной системы-потребителя |
регистрация в ЕСИА, подпись запросов ключом ГОСТ Р 34.10-2012, сертифицированное СКЗИ (SPEC-INT-01 §3.3) |
| 152-ФЗ |
ст. 18 ч. 5 (локализация) |
хранение в РФ (ADR-04) |
| 152-ФЗ |
ст. 21 ч. 5 (уничтожение при отзыве) |
pd-deletion-job, срок 30 дней (SR-09#1) |
| 54-ФЗ |
ст. 1.2 (чек) |
фискализация каждой оплаты и возврата, ссылка на чек на C-24c и в C-32 |
| 402-ФЗ |
ст. 29 (хранение документов) |
платёжные записи хранятся 5 лет после удаления аккаунта, без контактных ПДн |
| PCI DSS |
SAQ A |
ввод карты только в форме провайдера |
| ПП РФ № 1853 (правила гостиничных услуг) |
учёт проживающих |
вопрос регистрации проживающих — ADAPT-001 B-003, вне клиента |
4. Связь с требованиями
SR-03, SR-04, SR-06, SR-07, SR-09, SR-24, SR-31#3, SR-41#2.
5. Связь с другими SPEC
depends-on: SPEC-ARCH-01, SPEC-DATA-01.
6. Verification
TC-006 … TC-012, TC-015, TC-024, TC-025, TC-056, TC-067 и парные -neg. Security-TC (только негативные сценарии T1 – T11) — следующая версия комплекта (README, «Известные пробелы»).