SHA256
Ограничить домены email бесплатной регистрации
This commit is contained in:
@@ -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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user