Ограничить домены email бесплатной регистрации

This commit is contained in:
AidarKC
2026-11-05 03:27:52 +03:00
parent e84ab41fe6
commit bd52a23bec
15 changed files with 424 additions and 20 deletions
@@ -11,11 +11,25 @@
При необходимости изменить внешним параметром `freeRegistration.email.from`, но адрес обязан относиться к подтверждённому домену.
5. Настройка `freeRegistration.email.allowTestCode=false` по умолчанию. Только для тестирования `true` разрешает код `777777` на этапе подтверждения любой активной заявки. Это полностью обходит подтверждение владения email и НЕ ДОЛЖНО использоваться на публичном/production-сервере.
6. На сервере, где `freeRegistration.enabled=true`, без API-ключа Resend старт завершится ошибкой (fail-closed), даже если тестовый код включён. При создании заявки письмо всегда отправляется.
7. После локальных тестов перезапустить только нужный тестовый сервер по инструкциям deploy (production отдельно согласовывать).
7. В корне репозитория есть `allowed-email-domains.txt` — закрытый список допустимых почтовых доменов.
Файл копируется скриптом `deploy/scripts/deploy_server.sh` рядом с JAR в рабочую директорию сервера.
Не кладите его внутрь JAR и не задавайте путь из UI: проверка выполняется на сервере.
При необходимости путь можно изменить через `freeRegistration.email.allowedDomainsFile` (относительный путь — от
рабочей директории Java-процесса). `./gradlew startLocal` передаёт абсолютный путь к файлу
в корне репозитория, поскольку запускает JAR из `SHiNE-server/`.
После изменения списка или пути требуется перезапуск процесса.
Если `freeRegistration.enabled=true`, а файл отсутствует, пустой или содержит некорректные домены,
регистрация не запустится (fail-closed). На выключенную бесплатную регистрацию этот файл не влияет.
8. После локальных тестов перезапустить только нужный тестовый сервер по инструкциям deploy (production отдельно согласовывать).
## Процесс
- `CheckRegistrationEmail` проверяет известный занятый email, без отправки.
- `CheckRegistrationEmail` проверяет домен по `allowed-email-domains.txt` и затем занятость email, без отправки.
Если домен не разрешён, возвращается `emailAvailable=false` без запроса к БД.
Формат API не менялся: `false` означает «адрес занят **или** домен не разрешён».
То же ограничение повторно применяется в `StartFreeRegistration`, включая прямые запросы к API.
Список проверяется по точному совпадению после `@` (регистр не важен), поддомены и wildcard не допускаются.
Список ограничивает только бесплатную регистрацию с подтверждением email, не регистрацию через Solana.
- `StartFreeRegistration` создаёт случайный 6-значный код и challenge, отправляет письмо через HTTP API Resend;
только после ответа 2xx возвращает `challengeId` и `expiresAtMs`.
- `ConfirmFreeRegistration` принимает код для конкретного challenge. После верного кода
@@ -48,6 +62,7 @@ freeRegistration.email.apiKey=
freeRegistration.email.allowTestCode=false
freeRegistration.email.allowReuse=false
freeRegistration.email.from=SHiNE <noreply@shineup.me>
freeRegistration.email.allowedDomainsFile=allowed-email-domains.txt
```
Параметры читаются из `AppConfig`: системное свойство → переменная окружения
@@ -60,3 +75,22 @@ Resend успешно принял запрос на отправку. Он не
`StartFreeRegistration` и не работает после истечения 1 часа или перезапуска Java.
Для применения изменений настроек нужен перезапуск Java-процесса.
## Обновление разрешённых почтовых доменов
Редактируйте `allowed-email-domains.txt` в корне проекта: по одному домену на строку,
без символа `@`; строки с `#` — комментарии. Например `gmail.com`, но не `*.gmail.com`.
`user@gmail.com` и `user@GMAIL.COM` подходят, `user@sub.gmail.com` — нет, пока его
не добавили отдельной строкой. Новые домены не подхватываются до перезапуска.
Список ограничивает злоупотребления, но сам по себе не гарантирует доставку письма
и не заменяет rate limiting, проверку кода и защиту от ботов.
Быстрая локальная проверка парсера без внешних зависимостей:
```bash
mkdir -p /tmp/shine-allowlist-check
javac -d /tmp/shine-allowlist-check \
SHiNE-server/shine-server-archive/src/main/java/server/archive/registration/AllowedEmailDomains.java \
SHiNE-server/shine-server-archive/src/test/java/server/archive/registration/AllowedEmailDomainsCheck.java
java -cp /tmp/shine-allowlist-check server.archive.registration.AllowedEmailDomainsCheck
```