Навыки configuring-better-auth

🔐

configuring-better-auth

Name: configuring-better-auth
Author: Asmayaseen

Безопасно ⚙️ Внешние команды🌐 Доступ к сети📁 Доступ к файловой системе🔑 Переменные окружения

Настройка Better Auth OAuth 2.1 и OIDC

Этот навык помогает разработчикам внедрить безопасную аутентификацию OAuth 2.1 и OIDC с использованием фреймворка Better Auth. Он предоставляет пошаговое руководство по настройке централизованных серверов аутентификации с SSO, потоками PKCE и верификацией токенов JWKS.

Поддерживает: Claude Codex Code(CC)

🥉 76 Бронза

Скачать ZIP навыка

Загрузить в Claude

Перейдите в Settings → Capabilities → Skills → Upload skill

Включите и начните использовать

Протестировать

Использование «configuring-better-auth». Настроить Better Auth с OIDC provider

Ожидаемый результат:

Установить зависимости: better-auth, @better-auth/oidc-provider, drizzle-orm
Настроить адаптер базы данных и параметры сессии
Настроить доверенных клиентов с поддержкой PKCE
Добавить верификацию email с помощью Resend или SMTP

Использование «configuring-better-auth». Реализовать PKCE логин в Next.js

Ожидаемый результат:

Сгенерировать криптографически безопасный code verifier используя crypto.getRandomValues
Создать SHA-256 code challenge для запроса авторизации
Сохранить verifier в sessionStorage перед редиректом
Обменять код авторизации на токены на стороне сервера

Использование «configuring-better-auth». Верифицировать токены с помощью JWKS

Ожидаемый результат:

Создать удаленную конечную точку JWKS, указывающую на сервер аутентификации
Использовать библиотеку jose для верификации JWT с RS256
Валидировать claims issuer и audience
Корректно обрабатывать истечение срока действия токена и обновление

Аудит безопасности

Безопасно

v5 • 1/16/2026

All static findings are FALSE POSITIVES. This is legitimate OAuth/OIDC authentication documentation for Better Auth framework. The scanner flagged standard OAuth patterns (network calls for token exchange, environment config, PKCE code verifiers in sessionStorage) as suspicious, but these are required for OAuth/OIDC flows. Uses industry-standard RS256 cryptography, proper httpOnly cookies, and PKCE security measures.

Просканировано файлов

1,735

Проанализировано строк

находки

Всего аудитов

Факторы риска

⚙️ Внешние команды (125)

🌐 Доступ к сети (61)

📁 Доступ к файловой системе (4)

references/auth-server-setup.md:266 references/auth-server-setup.md:557 skill-report.json:6 SKILL.md:238

🔑 Переменные окружения (66)

Проверено: claude Посмотреть историю аудитов →

Оценка качества

Архитектура

100

Сопровождаемость

Контент

Сообщество

100

Безопасность

Соответствие спецификации

Что вы можете построить

Создание SSO-платформы

Создание централизованного сервера аутентификации для нескольких приложений с правильным соответствием OAuth 2.1.

Добавление SSO-входа

Интеграция Better Auth SSO в приложения Next.js с безопасным потоком PKCE и управлением токенами.

Настройка инфраструктуры аутентификации

Настройка готовой к production аутентификации с JWKS, верификацией email и административными элементами управления.

Попробуйте эти промпты

Базовая настройка аутентификации

Настроить сервер аутентификации Better Auth OAuth 2.1 с плагином OIDC provider, включая конфигурацию базы данных и регистрацию доверенных клиентов.

Интеграция SSO

Реализовать интеграцию SSO-клиента в приложении Next.js с потоком PKCE, обменом токенов и хранением в httpOnly cookies.

Безопасность токенов

Настроить конечную точку JWKS и верификацию токенов на стороне клиента для Better Auth, включая подпись RS256 и валидацию токенов.

Production настройка

Настроить production версию Better Auth с верификацией email через Resend или SMTP, административной панелью и функциональностью глобального выхода.

Лучшие практики

Всегда используйте PKCE для публичных клиентов (SPA, мобильные приложения) вместо client secrets
Храните токены в httpOnly cookies с SameSite=Lax, никогда в localStorage
Валидируйте redirect URI точно и настраивайте доверенные источники для CORS
Используйте RS256 для подписи JWT с автоматической ротацией ключей JWKS

Избегать

Хранение access tokens в localStorage делает их уязвимыми для XSS-атак
Пропуск PKCE для публичных клиентов позволяет перехват кода авторизации
Использование слабого хеширования типа MD5 или SHA1 для паролей или операций с токенами
Жесткое кодирование секретов или учетных данных в исходном коде вместо переменных окружения

Часто задаваемые вопросы

Что такое Better Auth?

Better Auth — это библиотека аутентификации TypeScript, которая обеспечивает соответствие OAuth 2.1 и OIDC с плагинами для различных провайдеров.

Когда следует использовать PKCE?

Используйте PKCE для всех публичных клиентов, включая SPA и мобильные приложения. Он заменяет client secrets и предотвращает кражу кода авторизации.

Что такое JWKS?

JSON Web Key Set (JWKS) — это набор публичных ключей, используемых для верификации JWT токенов. Better Auth предоставляет их через конечную точку JWKS.

Как безопасно хранить токены?

Храните токены в httpOnly, Secure, SameSite=Lax cookies. Никогда не используйте localStorage, так как он уязвим для XSS-атак.

В чем разница между OAuth и OIDC?

OAuth обрабатывает авторизацию (разрешение на доступ к ресурсам). OIDC добавляет аутентификацию (проверку личности пользователя) поверх OAuth.

Как работает глобальный выход?

Глобальный выход перенаправляет пользователей на конечную точку endsession сервера аутентификации, которая очищает SSO-сессию во всех подключенных приложениях.

Сведения для разработчиков

Автор

Asmayaseen

Лицензия

MIT

Репозиторий

https://github.com/Asmayaseen/hackathon-2/tree/main/.claude/skills/configuring-better-auth

Ссылка

main

Структура файлов

📁 references/

📄 auth-server-setup.md

📄 sso-client-integration.md

📁 scripts/

📄 verify.py

📄 SKILL.md