SuperAPI AI 工具集

configuring-better-auth

智能体与模型

查看项目

更新于 10-15 20:06

技能介绍

用途:这是一份围绕 Better Auth 实现 OAuth 2.1 / OIDC 认证的技能资料,覆盖两条主线——搭建集中式认证服务器(SSO 提供方)与在应用中集成 SSO 客户端;同时提供 MCP 辅助配置能力,用于引导式初始设置、生成 OIDC 提供方插件配置、排查认证问题与解释认证流程。

主要能力:认证服务器侧使用 npm install better-auth @better-auth/oidc-provider drizzle-orm,通过 betterAuth 配置数据库适配器、邮箱密码登录、会话有效期(expiresIn、updateAge),并启用 oidcProvider 插件(loginPage、consentPage、requirePKCE 等),以及用 auth.api.createOAuthClient 注册客户端(name、redirectUris、type 如 public)。客户端侧使用 npm install jose,采用 PKCE 授权码流程,包含生成 code verifier / challenge、跳转 /oauth2/authorize、在回调路由换取 /oauth2/token、用 jose 的 createRemoteJWKSet 与 jwtVerify 校验 JWKS(issuer、audience)、刷新令牌、全局登出等模式。

使用方式:MCP 可通过 claude mcp add --transport http better-auth https://mcp.chonkie.ai/better-auth/better-auth-builder/mcp 添加,或在 settings.json 中配置 http 类型与对应 URL。客户端需配置 NEXT_PUBLIC_SSO_URL、NEXT_PUBLIC_SSO_CLIENT_ID 等环境变量;令牌建议存于 httpOnly cookie(SameSite=Lax),不要放在 localStorage。

适用场景:单点登录、多应用共享认证、OIDC 提供方插件接入、理解认证流程等;编写自定义中间件时资料建议不使用 MCP。

限制:资料未提供收费、价格与平台适配信息;未给出完整代码示例之外的部署细节;验证方式为运行 python3 scripts/verify.py,预期输出 ✓ configuring-better-auth skill ready,失败时检查 references/ 是否包含两个设置文件。