Домики · Rest&Go

renar/guest-app/spec/SPEC-SEC-01.md · Исходный файл

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, «Известные пробелы»).

Метаданные RENAR
id: SPEC-SEC-01
title: "Безопасность и персональные данные"
type: SPEC-SEC
source: { adapt: ADAPT-001, adapt-section: "Forward §6; B-002, B-003, B-004, B-035", tz-section: "§2; §5.2 C-02 – C-06, C-30" }
depends-on: [SPEC-ARCH-01, SPEC-DATA-01]
ai-provenance:
  generated-by: "anthropic-claude-opus-5-5@2026-11-11"
  generated-at: "2026-11-11T12:00:00Z"
  prompt-template: "renar-agent-ru.md@1.0"
  context-tokens: null
  output-tokens: null
  human-edits: false