Files
SHiNE-server/docs/registration-v2/REGISTRAR_CONFIGURATION.md
T

3.3 KiB
Raw Blame History

Локальный регистратор 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. Регистрация окончательно не активируется до Turbo ACK и проверенного импорта.

Безопасность: на реальном сервере ограничить права файла регистратором/пользователем Java-процесса (0600), не сохранять секрет в stdout, crash reports, Git, backup без шифрования. В будущем заменить реализацию RegistrarSigner на аппаратный модуль.

В issue() проверяются текущие известные login/email и namespace; эта проверка сама по себе не резервирует имя. Этап 8 обязан транзакционно повторить проверки и гарантировать уникальность с UNIQUE индексами БД.