Настройка Better Auth

Настраивает Better Auth по документации установленной версии: переменные окружения, auth.ts, адаптеры, миграции, сессии и cookie-кэш, хуки, плагины, типичные ошибки. Для случаев, когда в проекте уже есть Better Auth и нужно поменять настройку.

БезопасностьПак: Скиллы Better Authссылкаbetter-auth-best-practices
Автор
Источник
better-auth/skills/better-auth/best-practices @ 20c9e88
Лицензия
не указана

Об этом скилле

Что делает

Скилл — сжатый справочник по настройке Better Auth в проекте на TypeScript, на сервере и в клиенте. Сначала агент привязывает документацию к версии better-auth из лок-файла и читает её через MCP-сервер Better Auth (get_doc, search_docs) или с better-auth.com/llms.txt; при обновлении советы для установленной и целевой версии идут раздельно.

Дальше — установка в шесть шагов: пакет, BETTER_AUTH_SECRET и BETTER_AUTH_URL, auth.ts, обработчик маршрута, миграции (npx auth@latest migrate или generate для Drizzle и Prisma) и проверка GET /api/auth/ok. За ней короткие заметки: основные опции, адаптеры баз, где хранить сессии (secondaryStorage, база или stateless-режим на cookie-кэше), почтовые хуки, флаги безопасности в advanced, лимиты запросов, хуки, плагины, импорт клиента под каждый фреймворк, типы через $Infer. Завершают его восемь подводных камней — например, что в конфиге нужно имя модели, а не таблицы, и что после нового плагина CLI запускают заново.

В папке только SKILL.md. MCP-сервер подключает npx auth@latest mcp --cursor; без него агенту нужен доступ в сеть.

Когда включать и когда не надо

Когда Better Auth в проекте уже стоит или вот-вот встанет, а вопрос в настройке: сессии, cookie, адаптер, плагин, хук, обновление.

Первая установка со страницами входа и вопросами о плане — задача для Авторизация на Better Auth с нуля. В Managed Better Auth от Neon плагины включаются через сам Neon, а клиент @neon/auth не принимает опцию plugins, так что многое отсюда там не пригодится.

Как поставить и вызвать

Этот скилл мы не копируем: в репозитории автора нет лицензии. Ставьте его оттуда по кнопке к исходнику. Файл .claude-plugin/marketplace.json в репозитории описывает плагин для Claude Code auth-skills с этим скиллом и create-auth: claude plugin marketplace add better-auth/skills, затем claude plugin install auth-skills@better-auth-agent-skills. После этого скилл может появиться как auth-skills:better-auth-best-practices. Для другого агента скопируйте папку better-auth/best-practices в его каталог скиллов.

  • Claude Code: /better-auth-best-practices или попросить скилл по имени.
  • Codex: $better-auth-best-practices.
  • Cursor: наберите / в чате Agent и выберите better-auth-best-practices.

Пример: /better-auth-best-practices Сессии теперь в Redis; сохраняй их ещё и в Postgres и переведи cookie-кэш на jwe.

Чем отличается от похожих

Авторизация на Better Auth с нуля строит вход с пустого места, и в нём лежат примеры подключения Drizzle, на которые ссылается этот скилл. Четыре скилла того же набора подробно разбирают то, чему здесь отведено несколько строк: вход по почте и паролю, двухфакторную авторизацию, организации и роли и защиту. Авторизация Neon Auth — это Better Auth как управляемый сервис в Neon с фиксированным набором плагинов. Других скиллов, которые настраивают Better Auth на своём сервере, в нашем каталоге нет: Neon Auth для этого случая только отсылает к документации Better Auth.

Установка

Скилл не скопирован в каталог: в репозитории автора нет текста лицензии. Установите его оттуда.

Скилл написан на английском — агент поймёт его и ответит вам по-русски.

Открыть источник

Подключить через AnyModel API

Скилл работает на той модели, которую использует агент. Подключите Claude Code, Codex или Cursor к AnyModel и запускайте его на Claude, GPT, Gemini и других моделях по одному ключу — оплата за токены, без подписки.

Ещё из пака Скиллы Better Auth

Авторизация на Better Auth с нуля

Подключает Better Auth к приложению на JS/TS: изучает стек, задаёт вопросы, согласует план, затем пишет конфиг, обработчик, миграции, плагины и страницы входа или переносит с другой библиотеки. Для случаев, когда проекту нужен вход.

Вход по почте и паролю в Better Auth

Настраивает вход по почте и паролю в Better Auth: письма и обязательное подтверждение, сброс пароля со сроком токена и отзывом сессий, длину пароля и своё хеширование вроде Argon2id. Для случаев, когда в Better Auth нужен вход по паролю.

Организации и роли в Better Auth

Настраивает плагин организаций в Better Auth: лимиты, активную организацию, участников, приглашения, роли и проверку прав, команды, динамические роли, хуки и защиту владельца. Для случаев, когда на Better Auth строится мультитенантное приложение.

Двухфакторная авторизация в Better Auth

Подключает плагин twoFactor в Better Auth: TOTP с QR-кодом, коды на почту или по SMS, резервные коды, шаг 2FA при входе, доверенные устройства и хранение секретов. Для случаев, когда приложению на Better Auth нужна MFA.

Защита Better Auth

Укрепляет развёртывание Better Auth: секрет, лимиты запросов, CSRF, доверенные origin, сессии и cookie, шифрование OAuth-токенов, IP за прокси, аудит через хуки и чек-лист перед выкладкой. Для случаев, когда приложение на Better Auth готовят к проду.