SuperAPI AI 工具集

auth-nodejs-cloudbase

通用与其它

查看项目

更新于 10-16 08:44

技能介绍

用途:本技能面向在 CloudBase 项目中进行服务端认证与身份处理的场景,代码运行在 Node.js,例如云函数需要知道调用者是谁、Node 服务用 CloudBase Node SDK 查用户资料、后端为 Web 或移动端签发自定义登录票据、管理工具查看终端用户档案。前端登录流程、直连 HTTP 认证接口、与身份无关的数据库或存储操作不属本技能范围;前后端混合需求应分别处理。

主要能力:使用 @cloudbase/node-sdk,先用 tcb.init({ env: "your-env-id" }) 与 app.auth() 初始化。覆盖的方法有:getUserInfo() 返回当前调用者的 openId、appId、uid、customUserId;getEndUserInfo(uid?) 获取指定 uid 或当前调用者的完整用户档案;queryUserInfo({ platform, platformId, uid? }) 按手机号、邮箱、自定义 ID 等登录标识查用户;getClientIP() 返回调用者 IP;createTicket(customUserId, options) 生成自定义登录票据。

使用方式:云函数中用 getUserInfo 取 uid 做鉴权、日志与个性化;已知 uid 用 getEndUserInfo,只有登录标识时用 queryUserInfo;自定义登录需先安装商户私钥文件,将 credentials 传给 init,再调用 createTicket,把票据返回给可信客户端,由 Web SDK 完成换票登录。customUserId 长度为 4–32 字符,仅允许字母、数字及 _-#@(){}[]:.,<>+#~。

限制与注意事项:切勿修改 SDK 方法名与参数字段,不要猜测参数结构,未在文档中的旧方法应避免使用;tcb_custom_login.json 须保密,严禁打包进前端;getEndUserInfo 与 queryUserInfo 只在可信后端调用,不得直接暴露给不可信客户端;授权判断应依据 uid 而非仅登录成功;promise 调用需 try/catch 并避免记录敏感数据。完整端到端体验需配合 Web 端或 HTTP 认证文档。收费、价格与具体流程等细节资料未提供。