6.3 KiB
Подтверждение email при бесплатной регистрации SHiNE
Реализация: SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/.
Подключение Resend
- В Resend подтвердить
shineup.me(DNS DKIM + отправляющие CNAME), статус Verified. - Получить в Resend API key с правом
Sending access. - Указать API-ключ как
RESEND_API_KEYв окружении Java-процесса (предпочтительно) или черезfreeRegistration.email.apiKeyво внешнем, недоступном из Gitapplication.properties. Никогда не коммитить реальный ключ, не печатать в журнале и не отдавать клиенту. - Настройка
freeRegistration.email.from. По умолчанию отправитель:SHiNE <noreply@shineup.me>. При необходимости изменить внешним параметромfreeRegistration.email.from, но адрес обязан относиться к подтверждённому домену. - Настройка
freeRegistration.email.allowTestCode=falseпо умолчанию. Только для тестированияtrueразрешает код777777на этапе подтверждения любой активной заявки. Это полностью обходит подтверждение владения email и НЕ ДОЛЖНО использоваться на публичном/production-сервере. - На сервере, где
freeRegistration.enabled=true, без API-ключа Resend старт завершится ошибкой (fail-closed), даже если тестовый код включён. При создании заявки письмо всегда отправляется. - После локальных тестов перезапустить только нужный тестовый сервер по инструкциям 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 заявка удаляется, код не считается отправленным.
Проверка
- Для тестового окружения задать
RESEND_API_KEYв systemd EnvironmentFile (файл с ограниченными правами), не добавляя ключ в репозиторий. При изменении секрета перезапустить сервис. - Зарегистрировать новый
login@freeи доступный адрес email. - Проверить письмо, неверный код, истечение срока, пять ошибок, повторную отправку через минуту, успешное подтверждение, Turbo ACK и отсутствие email/кода в системных журналах.
- Проверить ошибки/квоту Resend в панели провайдера и корректное поведение UI.
Сервис Resend может принять запрос на отправку, но не гарантирует доставку во входящие пользователя; статусы доставки анализируются в панели Resend, особенно для bounce/spam.
Три настройки сервера
# Реальный секрет предпочтительно задавать через 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-процесса.