Vercel 身份认证集成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-vercel-plugin-auth。
技能介绍
要解决什么问题
在 Vercel 上跑 Next.js 时,认证方案往往分散在三套文档里:Clerk(市场原生集成)、Descope(可视化登录流)、Auth0(企业 IdP)。环境变量该叫 CLERK_SECRET_KEY 还是 Auth0 域配置、中间件里用同步 auth() 还是 await auth()、authMiddleware 是否还能用——版本一换就容易踩坑。
技能如何帮你
本技能按提供商拆解可执行路径:
- Clerk:走 Marketplace 安装与自动注入的
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY/CLERK_SECRET_KEY,配置clerkMiddleware、路由保护与 Core 3 下的 Frontend API 代理(自有域名转发,减少第三方请求)。 - Descope:市场安装、SDK 与中间件、登录流搭建。
- Auth0:SDK、必需环境变量、中间与会话读取。
并给出选型对照:最快上手选 Clerk、无密码/社交流选 Descope、企业 SSO/SAML/多租户选 Auth0。另收录 Clerk Core 3(2026 年 3 月) 破坏性变更清单(auth()/clerkClient() 异步化、authMiddleware 移除、类型从 SDK 子路径导入等),便于升级时对照改码。
边界与注意点
技能聚焦 Vercel 部署的 Next.js 类应用 与上述三家;不替代各厂商完整安全审计。Clerk 升级 CLI(npx @clerk/upgrade)要求 Node.js 20.9.0+。与市场安装、中间件路由、环境变量管理相关的细节可对照站内 marketplace、routing-middleware、env-vars 技能交叉阅读。
使用场景
- 新项目已在 Vercel 部署 Next.js,需要在一天内接上登录并区分该用 Clerk、Descope 还是 Auth0
- 维护中的应用要从 Clerk 旧中间件迁移到 `clerkMiddleware`,并按 Core 3 把 `auth()` 改成异步写法
- 产品要求社交/无密码登录流,准备走 Vercel Marketplace 装 Descope 并配置 Provider 与中间件
- 客户要求 SAML/企业 SSO,需要在同一套 Next.js 代码里核对 Auth0 环境变量与会话读取方式
适合人员
- 在 Vercel 上交付客户站点的全栈工程师,需要按交付周期选对认证商并完成路由保护
- 负责 Next.js 升级的同事,要把 Clerk SDK 升到 v7/Core 3 并逐项对照破坏性变更改中间件
- 平台组工程师,统一规范 Vercel Marketplace 集成与环境变量命名(Clerk/Descope)
- 接 B 端项目的后端或全栈,Auth0 多租户与企业 IdP 是硬性要求时的实施者