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

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

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

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

Что делает

Скилл подключает плагин twoFactor в Better Auth и экраны вокруг него. Установка — плагин на сервере с issuer, плагин в клиенте с обработчиком onTwoFactorRedirect, миграция и проверка, что в таблице пользователей появилась колонка twoFactorSecret. Включение 2FA требует пароль и возвращает TOTP URI для QR-кода (в примере — react-qr-code) и резервные коды; twoFactorEnabled остаётся false, пока не пройдёт первый код.

Второй фактор бывает трёх видов. TOTP: 6 или 8 цифр, период 30 секунд, допуск на один период в обе стороны. Одноразовые коды на почту или по SMS через ваш sendOTP: по умолчанию живут 3 минуты, 5 попыток, хранятся открыто, зашифрованными, хешированными или через ваши функции. Резервные коды: 10 одноразовых, по умолчанию зашифрованы, перевыпускаются по паролю, и старый набор при этом сгорает.

При входе ответ приходит с twoFactorRedirect: true. Сессия снимается, на 10 минут ставится временная cookie для 2FA, а новая сессия появляется только после проверки кода. С trustDevice: true шаг пропускается 30 дней, и срок продлевается при каждом входе. Ещё скилл отмечает встроенный лимит 3 запроса за 10 секунд на эндпоинты 2FA, шифрование TOTP-секретов секретом авторизации и сравнение за постоянное время; отключение 2FA требует пароль и стирает доверенные устройства. В папке только SKILL.md.

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

Чтобы добавить MFA в приложение на Better Auth, где входят по почте и паролю.

2FA работает только для аккаунтов с паролем, а не для тех, кто входит лишь через OAuth. Passkey — отдельный плагин. В Managed Better Auth от Neon MFA пока в планах, и там для неё нужен Better Auth на своём сервере.

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

Этот скилл мы не копируем: в репозитории автора нет лицензии. Ставьте его оттуда по кнопке к исходнику. Плагин для Claude Code из .claude-plugin/marketplace.json (auth-skills) включает только create-auth и best-practices, поэтому скопируйте папку better-auth/twoFactor в каталог скиллов своего агента. В name записано two-factor-authentication-best-practices:

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

Пример: /two-factor-authentication-best-practices Добавь TOTP с резервными кодами, страницу /2fa после входа и доверенные устройства на 30 дней.

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

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

Установка

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

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

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

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

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

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

Настройка Better Auth

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

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

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

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

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

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

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

Защита Better Auth

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