用途:在 Next.js 应用中集成 Auth0 身份平台,实现认证、授权与用户管理,支持 App Router 与 Pages Router。
主要能力:提供登录、登出、OAuth 回调与用户信息路由;客户端 useUser 钩子与 UserProvider;服务端 getSession;中间件、页面级与 API 路由保护;通过 getAccessToken 调用外部 API;基于角色的访问控制(需在 Auth0 Actions 中把角色写入自定义声明);自定义登录/登出参数;会话更新;组织(Organization)登录与动态组织;多因素认证(MFA);测试中可用 UserProvider 模拟用户。
使用方式:安装 npm install @auth0/nextjs-auth0;配置环境变量 AUTH0_SECRET、AUTH0_BASE_URL、AUTH0_ISSUER_BASE_URL、AUTH0_CLIENT_ID、AUTH0_CLIENT_SECRET,可用 openssl rand -hex 32 生成密钥;在 Auth0 Dashboard 创建 Regular Web Application 并设置回调、登出与 Web Origins;App Router 下创建 app/auth/[auth0]/route.ts 并导出 handleAuth(),在布局中包裹 Auth0Provider。
适用场景:需要企业 SSO、角色权限、API 保护与用户管理的 Next.js 项目。
限制:资料未提供收费、价格、平台支持范围与效果数据;角色声明需自行配置 Auth0 Actions;密钥必须通过环境变量管理,不可硬编码。