SHA256
16 lines
3.3 KiB
Markdown
16 lines
3.3 KiB
Markdown
# Локальный регистратор SHiNE, этап 7
|
||
|
||
Модуль `shine-server-archive/server.archive.registration` выдаёт **сырой signed ANS-104 DataItem**, но **не публикует** его и **не создаёт пользователя** (это этап 8). В этот патч публичный WS/API не добавлялся.
|
||
|
||
## Конфигурация
|
||
|
||
- `freeRegistration.enabled=false` по умолчанию. Включается только на тестовом сервере после проверки соответствия namespace.
|
||
- `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` отказывает.
|
||
- При включённой бесплатной регистрации обязательно задать `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` на аппаратный модуль.
|
||
|
||
В `issue()` проверяются текущие известные login/email и namespace; эта проверка сама по себе не резервирует имя. Этап 8 обязан транзакционно повторить проверки и гарантировать уникальность с `UNIQUE` индексами БД.
|