CloudBase Web 身份认证
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/tencentcloudbase-skills-auth-web-cloudbase。
技能介绍
要解决什么问题
在 CloudBase 环境里做 Web 前端登录、注册、会话保持或受保护路由时,容易在服务商是否开启、accessKey 是否正确、以及 SDK 3.x 的会话语义上踩坑。本技能面向已用或计划用 @cloudbase/js-sdk 的页面与 SPA,把「先确认后台再写前端」的顺序写清楚,避免用旧版 getLoginState() 误判已登录、或在未建立真实会话就去调 NoSQL 接口导致 401。
技能如何工作
激活前提通常是:登录方式已在控制台 / MCP 侧核对过(配合 auth-tool-cloudbase 的 queryAppAuth、manageAppAuth)。在此基础上,技能指导你:
- 用 Supabase 风格的
{ data, error }调用:signInWithPassword、signInWithOtp、signUp、signOut、getSession、onAuthStateChange等 - 区分 邮箱 / 手机 / 用户名密码 / 匿名 / OAuth:例如纯
admin类账号走signInWithPassword({ username, password }),写代码前用listProviders确认对应方式为 On - 用
auth.getSession()做路由守卫;data.session === undefined才表示未登录 - 在 SDK 3.x 下,对数据库读写前需
signInAnonymously()或其它真实登录(若环境已开启匿名登录)
页面结构、部署可与同插件下的 web-development 技能衔接;服务商配置细节以 auth-tool-cloudbase 为准。
适用边界与注意点
- 不适用:小程序、原生 App、纯服务端鉴权搭建
- 不要在未确认 provider 前直接写
signInWithPassword/signUp;邮件注册还需确认 SMTP - 不要把登录框仍设
type="email"而业务账号是用户名;也不要用云函数登录逻辑替换内置 Web Auth - 兄弟技能缺失时,应提示安装完整 CloudBase 插件,而非远程拉取 SKILL 内容
使用场景
- React/Vite 项目需要登录页,并在路由层用 getSession 拦截未登录用户
- 控制台已开用户名密码登录,要把表单提交接到 signInWithPassword 而非空壳 helper
- 邮箱或手机 OTP 注册流程:signUp/signInWithOtp 后在前端调用 data.verifyOtp
- SPA 初始化 SDK 后要先 signInAnonymously 再读写 NoSQL,避免网关返回 401
适合人员
- 用 CloudBase 托管后端的 Web 前端,要在现有表单上接通官方 Auth 而非自写云函数登录
- 维护管理后台(admin/editor 用户名账号),需区分用户名登录与邮箱字段的集成工程师
- 从 Supabase Auth 迁移到 CloudBase,希望沿用 signInWithPassword、getSession 心智模型的全栈开发者
- 负责 CloudBase 控制台登录方式与 publishable key,再交给 AI 生成页面集成代码的技术负责人