SHA256
4.1 KiB
4.1 KiB
Локальный регистратор SHiNE, этап 7
Модуль shine-server-archive/server.archive.registration выдаёт сырой signed ANS-104 DataItem, но не публикует его и не создаёт пользователя (это этап 8). В этот патч публичный WS/API не добавлялся.
Конфигурация
freeRegistration.enabled=falseпо умолчанию. Для включения обязательно одновременно задатьfreeRegistration.namespace=<namespace>: это единственный type-2 namespace, в котором данный сервер выдаёт бесплатные аккаунты. Если namespace не задан илиenabled=false, сервер публикует только платные namespace и не показывает в UI вариант бесплатной регистрации.- При включении сервер до начала работы сверяет, что указанный namespace имеет type 2, его
default_server_loginсовпадает сserver.SHiNE.login, аregistrar_pubkey— с публичным ключом из seed. При несовпадении запуск прекращается; чужой 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 индексами БД.