SHA256
Добавить email-подтверждение бесплатной регистрации
This commit is contained in:
@@ -176,6 +176,6 @@
|
||||
## Регистрация V2: полные логины и независимые проверки
|
||||
|
||||
Публичные WS-операции нового протокола перечислены в `docs/registration-v2/WS_REGISTRATION_V2_PROPOSED_NOT_ENABLED.md`.
|
||||
Сначала `GetNamespaces` → `CheckRegistrationLogin` с полным `login@namespace`; затем **только для бесплатной регистрации** отдельное `CheckRegistrationEmail`. После проверки запускается `StartFreeRegistration`, затем `ConfirmFreeRegistration` с тестовым кодом `1111`. Состояние читается через `GetRegistrationStatus`.
|
||||
Сначала `GetNamespaces` → `CheckRegistrationLogin` с полным `login@namespace`; затем **только для бесплатной регистрации** отдельное `CheckRegistrationEmail`. После проверки запускается `StartFreeRegistration`, затем `ConfirmFreeRegistration` с шестизначным одноразовым кодом из письма (1 час, 5 попыток). Состояние читается через `GetRegistrationStatus`.
|
||||
|
||||
Все бесплатные сертификаты подписаны ANS-104 и внутренней подписью Ed25519; успешный Turbo ACK не означает подтверждённую высоту Arweave. Клиент никогда не отправляет пароль или приватные ключи на сервер.
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
- `freeRegistration.registrarSeedFile` — абсолютный путь к файлу вне Git, внутри одна Base64-строка **32-byte Ed25519 seed**. Пример имени `/var/lib/shine/secrets/registrar-seed.b64`; не создавать файл с тестовым ключом внутри репозитория.
|
||||
- `LocalRegistrarSigner.fromConfig(AppConfig)` проверяет enabled и наличие пути, не печатает секрет или bytes в лог.
|
||||
- Публичный ключ signer должен совпадать с `shine_namespace_current.registrar_pubkey` (из on-chain namespace), иначе `FreeRegistrationIssuer.issue` отказывает.
|
||||
- В режиме демонстрации код — `1111`. Владение почтой не подтверждается. Регистрация окончательно не активируется до Turbo ACK и проверенного импорта на этапе 8.
|
||||
- При включённой бесплатной регистрации обязательно задать `RESEND_API_KEY` в окружении процесса (или `freeRegistration.email.apiKey` в защищённом внешнем конфиге). Настройки: `freeRegistration.email.allowTestCode=false` — временный обход `777777`, `freeRegistration.email.allowReuse=false` — запрет повторного использования одного email, `freeRegistration.email.from=SHiNE <noreply@shineup.me>` — отправитель. `allowReuse=true` допустим только в закрытом тестовом окружении: при этом один email может завершить несколько регистраций. Тестовый обход включать исключительно в закрытом тестовом окружении. 6-значный код отправляется на email через Resend и проверяется до выдачи сертификата. Подробности: [RESEND_EMAIL_VERIFICATION.md](RESEND_EMAIL_VERIFICATION.md). Регистрация окончательно не активируется до Turbo ACK и проверенного импорта.
|
||||
|
||||
**Безопасность:** на реальном сервере ограничить права файла регистратором/пользователем Java-процесса (0600), не сохранять секрет в stdout, crash reports, Git, backup без шифрования. В будущем заменить реализацию `RegistrarSigner` на аппаратный модуль.
|
||||
|
||||
|
||||
@@ -0,0 +1,62 @@
|
||||
# Подтверждение email при бесплатной регистрации SHiNE
|
||||
|
||||
Реализация: `SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/`.
|
||||
|
||||
## Подключение Resend
|
||||
|
||||
1. В Resend подтвердить `shineup.me` (DNS DKIM + отправляющие CNAME), статус **Verified**.
|
||||
2. Получить в Resend API key с правом `Sending access`.
|
||||
3. Указать API-ключ как `RESEND_API_KEY` в окружении Java-процесса (предпочтительно) или через `freeRegistration.email.apiKey` во **внешнем**, недоступном из Git `application.properties`. Никогда не коммитить реальный ключ, не печатать в журнале и не отдавать клиенту.
|
||||
4. Настройка `freeRegistration.email.from`. По умолчанию отправитель: `SHiNE <noreply@shineup.me>`.
|
||||
При необходимости изменить внешним параметром `freeRegistration.email.from`, но адрес обязан относиться к подтверждённому домену.
|
||||
5. Настройка `freeRegistration.email.allowTestCode=false` по умолчанию. Только для тестирования `true` разрешает код `777777` на этапе подтверждения любой активной заявки. Это полностью обходит подтверждение владения email и НЕ ДОЛЖНО использоваться на публичном/production-сервере.
|
||||
6. На сервере, где `freeRegistration.enabled=true`, без API-ключа Resend старт завершится ошибкой (fail-closed), даже если тестовый код включён. При создании заявки письмо всегда отправляется.
|
||||
7. После локальных тестов перезапустить только нужный тестовый сервер по инструкциям deploy (production отдельно согласовывать).
|
||||
|
||||
## Процесс
|
||||
|
||||
- `CheckRegistrationEmail` проверяет известный занятый email, без отправки.
|
||||
- `StartFreeRegistration` создаёт случайный 6-значный код и challenge, отправляет письмо через HTTP API Resend;
|
||||
только после ответа 2xx возвращает `challengeId` и `expiresAtMs`.
|
||||
- `ConfirmFreeRegistration` принимает код для конкретного challenge. После верного кода
|
||||
подписывает сертификат и публикует прежним Turbo/Arweave путём. Формат WS/API и сертификата не меняется.
|
||||
- Код действует 1 час, хранится в памяти как SHA-256(challengeId + `:` + code), максимум 5 ошибок на challenge.
|
||||
Повторная отправка ограничена одной попыткой в минуту на email и логин. Общий лимит — 60 отправок в час
|
||||
на процесс. Повторная публикация сертификата после сетевой ошибки допускается до конца TTL.
|
||||
- Данные challenge в памяти: после перезапуска сервера ещё не подтверждённый код перестаёт действовать;
|
||||
пользователь начинает новую заявку. Для нескольких Java-инстансов понадобится общее хранилище TTL (Redis/Postgres),
|
||||
иначе challenge, созданный на одном узле, не подтвердится на другом.
|
||||
- При HTTP-ошибке Resend заявка удаляется, код не считается отправленным.
|
||||
|
||||
## Проверка
|
||||
|
||||
1. Для тестового окружения задать `RESEND_API_KEY` в systemd EnvironmentFile (файл с ограниченными правами),
|
||||
не добавляя ключ в репозиторий. При изменении секрета перезапустить сервис.
|
||||
2. Зарегистрировать новый `login@free` и доступный адрес email.
|
||||
3. Проверить письмо, неверный код, истечение срока, пять ошибок, повторную отправку через минуту,
|
||||
успешное подтверждение, Turbo ACK и отсутствие email/кода в системных журналах.
|
||||
4. Проверить ошибки/квоту Resend в панели провайдера и корректное поведение UI.
|
||||
|
||||
Сервис Resend может принять запрос на отправку, но не гарантирует доставку во входящие пользователя;
|
||||
статусы доставки анализируются в панели Resend, особенно для bounce/spam.
|
||||
|
||||
## Три настройки сервера
|
||||
|
||||
```properties
|
||||
# Реальный секрет предпочтительно задавать через RESEND_API_KEY или внешнюю конфигурацию.
|
||||
freeRegistration.email.apiKey=
|
||||
freeRegistration.email.allowTestCode=false
|
||||
freeRegistration.email.allowReuse=false
|
||||
freeRegistration.email.from=SHiNE <noreply@shineup.me>
|
||||
```
|
||||
|
||||
Параметры читаются из `AppConfig`: системное свойство → переменная окружения
|
||||
(`FREE_REGISTRATION_EMAIL_API_KEY`, `FREE_REGISTRATION_EMAIL_ALLOW_TEST_CODE`,
|
||||
`FREE_REGISTRATION_EMAIL_FROM`) → внешний `application.properties` → встроенный файл.
|
||||
`RESEND_API_KEY` имеет приоритет над `freeRegistration.email.apiKey`.
|
||||
|
||||
Ограничение: чит-код действует **только для уже созданного challenge**, когда
|
||||
Resend успешно принял запрос на отправку. Он не создаёт пользователя без
|
||||
`StartFreeRegistration` и не работает после истечения 1 часа или перезапуска Java.
|
||||
|
||||
Для применения изменений настроек нужен перезапуск Java-процесса.
|
||||
Reference in New Issue
Block a user