SuperAPI AI 工具集

auth-nodejs-cloudbase

通用与其它

查看项目

更新于 10-16 08:41

技能介绍

用途:面向 CloudBase 项目中运行于 Node.js 的服务端代码,处理身份认证与用户识别,而非登录界面或服务商配置。

主要能力:getUserInfo() 读取当前调用者的 openId、appId、uid、customUserId;getEndUserInfo(uid) 按 uid 获取用户资料,省略 uid 时取当前调用者;queryUserInfo({platform, platformId, uid?}) 按手机号、邮箱、用户名或自定义 ID 查询用户;getClientIP() 获取调用者 IP;createTicket(customUserId, options) 签发自定义登录票据,供客户端换取 CloudBase 登录。

使用方式:安装最新 @cloudbase/node-sdk,按固定结构初始化:import tcb from "@cloudbase/node-sdk"; const app = tcb.init({ env: "your-env-id" }); const auth = app.auth();。自定义登录需在初始化时通过 credentials 加载控制台下载的 tcb_custom_login.json 私钥文件。createTicket 的 customUserId 长度 4–32 字符,允许字母、数字及 _-#@(){}[]:.,<>+#~。

适用场景:云函数中判断调用者身份并做鉴权、日志与个性化;后端按 uid 或登录标识查询用户;将已有用户体系通过自定义登录票据桥接到 CloudBase;记录客户端 IP 用于审计或访问控制。

限制:不覆盖服务商启用/禁用与登录控制台配置、前端登录注册 UI、小程序原生认证,也不描述原始 HTTP 认证接口。前端登录应使用 @cloudbase/js-sdk 相关技能,原始 HTTP 集成应使用 http-api 技能。票据签发仅限服务端,私钥文件须保密,不得打包进前端。所有 auth.* 方法名与参数结构以官方 Node SDK 文档为准,不确定的 API 不应猜测使用。具体字段取值与类型以官方文档为准,本资料未提供完整类型定义。