Вход для каждого элемента вашего узла
Одна служба говорит каждому элементу, кто пришёл и с какими ролями. Почта и пароль работают сразу, гости появляются по запросу, а учётные записи остаются на вашем компьютере.
OpenSource Web4 agent & app starter kitКак человек входит
Страница спрашивает, кто пришёл
Элемент передаёт cookie посетителя в /api/session и получает сессию с её ролями или 401.
Служба проверяет вход
Почта и пароль работают сразу; Google и волшебная ссылка Resend открываются, как только появятся их ключи.
Остальное решают роли
Четырнадцать ролей и гость, и каждый маршрут элемента сам говорит, кому его открывать.
Элемент на своём домене
Он впускает людей через единый вход: одноразовый код превращается в билет этого сайта.
Первая учётная запись, зарегистрированная на этом компьютере, навсегда становится архитектором узла.
Работает всегда
Узел никогда не выключает этот элемент: от него зависят остальные. Он запускается вместе с узлом и не засыпает, даже когда памяти мало.
Гости и два готовых провайдера
Гостевой вход встроен: гостевой аккаунт появляется по запросу и помнит, что посетитель делал в этом браузере, например наполовину собранную корзину. Число гостей ограничено: предел на один адрес и общий потолок, при котором первым уходит гость, дольше всех не заходивший.
Google и волшебная ссылка Resend уже установлены. Чтобы их включить, достаточно внести их ключи: код писать не нужно.
Что меняется для вас
| Без него | Со службой входа |
|---|---|
| Каждый элемент строил бы свой вход | Каждый элемент спрашивает одну службу, кто пришёл |
| Наполовину собранная корзина посетителя теряется | Гостевой аккаунт помнит, что посетитель делал в этом браузере |
| Роли переписывают руками в каждое приложение | Четырнадцать ролей и гость, заданные для каждого маршрута |
| Учётные записи лежат на чужом сервере | Они остаются в одном файле на вашем компьютере, никогда в git |
С чего начать
- 1
На этом компьютере зарегистрируйте первую учётную запись: она станет архитектором узла.
- 2
Подключите свой домен: на временном адресе вход и регистрация закрыты.
- 3
Добавьте ключ Google или Resend, когда понадобятся эти способы входа; почте и паролю ничего не нужно.
Все учётные записи узла видны и меняются в ядре, на вкладке «Пользователи» этого элемента. Удаление стирает личные данные и сохраняет идентификатор и журнал.
Спросить, кто пришёл
Элемент узла спрашивает службу с cookie посетителя:
const r = await fetch(`${process.env.AUTH_SERVICE_URL}/api/session`, {
headers: { cookie: request.headers.get('cookie') ?? '' },
})
const session = r.ok ? await r.json() : null // null — никто не вошёлГости появляются по запросу, и их число ограничено: предел на один адрес и потолок гостевых записей, при котором первым уходит гость, дольше всех не заходивший.
Что под капотом
Часть
Что делает
- NextAuth 5
- Провайдеры, обратные вызовы, сессии и выход
- SQLite
- Один файл учётных записей, организаций и ролей на этом компьютере, никогда в git
- /api/session
- Кто пришёл и с какими ролями, или 401
- /api/auth/sso
- Единый вход для элемента на своём домене
- 82 языка
- Каждый экран входа говорит на языке посетителя, прямо в странице
- Приложения
- В заводе приложений у каждого приложения свои люди: одна почта в двух приложениях — две учётные записи
Меняйте вход пораньше
Вход лучше менять в начале жизни приложения: это самая рискованная правка. Если вход сломается, никто не откроет защищённые маршруты, даже архитекторы, и восстанавливать его придётся через режим разработки.
Свой строитель в комплекте
Каждый элемент узла приходит со своим агентом Claude Code и может получить свой Telegram-бот. Нужно что-то поменять в этом элементе — напишите его боту с телефона, и агент обновит логику или дизайн.
Агент работает только в папке своего элемента и не читает весь узел, поэтому каждая правка стоит меньше токенов. Платит за неё ваша подписка Claude Code.
- Бот элемента подключается в ядре, на его странице «Telegram».
- Агент возвращает коммит; вы смотрите его в «Предпросмотре» и принимаете или отклоняете.
- За компьютером терминал агента — в ядре, в разделе «Сборка» этого элемента.
Открытый код
Сделано Fractera для протокола Lagrix и для любого web2-проекта, которому нужен вход. Лицензия MIT, код — github.com/Fractera/fractera-auth-starter.
Вопросы и ответы
- Нужно ли посетителю регистрироваться?
- Нет. Гостевой аккаунт появляется по запросу, и посетитель начинает без пароля; вход спрашивается только там, где он нужен маршруту.
- Как включить Google или Resend?
- Оба уже установлены. Внесите их ключи, и они появятся на экране входа; почта и пароль продолжают работать рядом.
- Кто становится архитектором?
- Первая учётная запись, зарегистрированная на этом компьютере, навсегда. Создайте её до того, как подключите свой домен.
- Где хранятся учётные записи?
- В одном файле на вашем компьютере, никогда в git. Видны и меняются они в ядре, на вкладке «Пользователи» этого элемента.