SuperAPI AI 工具集

workos-authkit-react-router

安全与审计

查看项目

更新于 10-16 04:30

技能介绍

用途:把 WorkOS AuthKit 接入 React Router 应用,覆盖 v6 与 v7 的 Framework、Data、Declarative 三种模式。

主要能力:提供按路由模式分支的集成流程、关键 API 区分(authLoader 仅用于 OAuth 回调路由,authkitLoader 用于需要鉴权的普通路由)、根路由必须挂载鉴权 loader 或 AuthKitProvider 的要求、必需环境变量清单,以及集成后的验证清单与常见错误恢复方案。

使用方式:先获取官方 README(https://raw.githubusercontent.com/workos/authkit-react-router/main/README.md),README 为唯一事实来源,冲突时以 README 为准;再检测路由模式:存在 react-router.config.ts 为 v7 Framework,源码含 createBrowserRouter 为 v7 Data,使用 <BrowserRouter> 为 v7 Declarative,package.json 为 6.x 则按 v6(类似 Declarative)处理;随后按 README 对应章节实施。环境变量需在 .env 或 .env.local 中配置 WORKOS_API_KEY、WORKOS_CLIENT_ID、WORKOS_REDIRECT_URI、WORKOS_COOKIE_PASSWORD(仅服务端模式,32 位以上)。验证命令包括检查 node_modules/@workos-inc/authkit-react-router、grep authLoader/handleCallbackRoute、grep authkitLoader/AuthKitProvider 以及 npm run build。

适用场景:React Router v6/v7 项目需要接入 WorkOS AuthKit 登录与鉴权时。

限制:具体 API 签名与代码模式以 README 为准,本资料未提供完整代码示例;回调路由路径必须与 WORKOS_REDIRECT_URI 完全一致;Declarative/v6 模式使用 AuthKitProvider 与 useAuth,而非 loader 模式。