SuperAPI AI 工具集

middleware-protection

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:为 Next.js 应用提供基于 Clerk 的中间件路由保护与授权模式,适用于实现路由守卫、保护路由、配置认证边界。

主要能力:提供中间件配置、路由匹配器(matcher)、基于角色的访问控制、认证边界;支持公开路由、受保护路由、组织路由、角色路由等保护层级;提供 API 路由保护、多租户保护、条件性路由保护等高级模式;附带模板、脚本与示例目录(如 templates/middleware.ts、scripts/generate-middleware.sh、examples/ 等)。

使用方式:在项目根目录创建 middleware.ts,从 @clerk/nextjs/server 导入 clerkMiddleware,导出默认中间件函数,并配置 matcher;通过 glob 模式定义公开路由,其余默认受保护。安全原则包括默认拒绝、纵深防御、每次请求校验会话、CSRF 防护。

适用场景:需要登录态区分的仪表盘与个人资料页、组织成员限定路由、管理员与普通用户权限区分、受保护的 API 端点等。

限制与要求:需 Next.js 13.4+(App Router)或 12+(Pages Router),@clerk/nextjs 4.0+,Node.js 16+;需 .env.local 配置 Clerk 环境变量。切勿硬编码 CLERK_SECRET_KEY 或 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY,应使用占位符或从环境变量读取,并将 .env* 加入 .gitignore。生产环境仅使用 HTTPS。具体收费与价格暂未提供。