SuperAPI AI 工具集

iblai-vibe-auth

前端与建站

查看项目

更新于 10-15 22:16

技能介绍

用途:为原生 Next.js(App Router)应用添加 ibl.ai 单点登录(SSO)。完成后未认证用户会被重定向到 login.iblai.app,登录后带会话返回,无需自行管理 API 令牌。

主要能力:通过内置 Jinja2 模板生成认证相关文件(lib/iblai/config.ts、auth-utils.ts、storage-service.ts、tenant.ts、store/iblai-store.ts、providers/iblai-providers.tsx、app/iblai-styles.css、app/sso-login-complete/page.tsx),并打补丁:next.config 中为 @reduxjs/toolkit 添加 webpack resolve.alias 去重、globals.css 引入 SDK 样式、.env.local 设置 NEXT_PUBLIC_MAIN_TENANT_KEY 与 IBLAI_API_KEY。

使用方式:需 Next.js 14+(App Router)与 Node.js 18+。先确认项目根目录存在含 PLATFORM、DOMAIN、TOKEN 的 iblai.env;再按 references/auth-interface.md 定制认证界面;随后渲染模板、安装依赖(pnpm add @iblai/iblai-js @reduxjs/toolkit react-redux sonner lucide-react,pnpm install --ignore-scripts)、在 app/layout.tsx 用 IblaiProviders 包裹 children(须为最外层 provider)、配置环境变量、导入 SDK 样式、替换默认首页,最后 pnpm dev 启动并访问 http://localhost:3000 验证重定向与 localStorage 中的 axd_token、userData、tenants。

适用场景:单组织(默认,NEXT_PUBLIC_MAIN_TENANT_KEY 固定)、多组织(URL 中带 org 并支持切换)以及无头场景(应改用 /iblai-api-login 系列)。新项目可直接使用 vibe-starter 模板。

限制:SSO 回调页必须位于 AuthProvider 之外,否则会死锁或无限重定向;所有运行来源(localhost、部署地址、自定义 scheme)须加入组织允许的重定向来源,应用本身无法修复;组织键不能为 main 或占位值;localhost 下 /api/custom-domains 报错可忽略。具体收费、价格与效果资料未提供。