Agent Skills
返回列表
💻

Vercel 身份认证集成

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 是硬性要求时的实施者