↑

CloudBase Node.js 身份认证参考v1.0.0

cloudbase-references-auth-nodejs5 KB

面向 CloudBase Node.js 后端场景,提供云函数内获取调用者身份、查询用户完整资料、生成自定义登录票据等具体代码模式。当用户需要在 Node 服务中接入 CloudBase 认证体系、或已有用户系统需桥接 CloudBase 登录时使用。

0 0 0 0 更新于 2026-10-28 18:24

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 聚焦 CloudBase Node SDK 的服务端身份认证能力,覆盖云函数与长期运行 Node 服务两种运行环境。针对「后端如何识别调用者」「如何查询任意用户资料」「如何将自有用户系统接入 CloudBase」三类核心需求,提供可直接复用的初始化模式、API 调用范式与安全实践要点。所有代码片段均围绕 @cloudbase/node-sdk 的 auth 模块展开,明确区分 Node 端与 Web 端、原始 HTTP 接口的职责边界,避免前端登录流程或纯数据库操作混入后端认证逻辑。

技能包含

  • SKILL.md:技能主说明(本文件),含触发条件、Node 认证架构、5 个 auth 方法签名及 5 组可复用场景代码

核心能力

  • 调用者身份识别:在云函数内通过 auth.getUserInfo() 提取 uid、openId、customUserId,用于授权决策与日志追踪
  • 用户资料查询:按 uid 查完整档案(getEndUserInfo),或按手机号/邮箱/用户名/自定义 ID 反查(queryUserInfo)
  • 自定义登录桥接:为已有用户系统签发 createTicket 票据,让客户端免注册直接换取 CloudBase 登录态
  • 安全审计辅助:通过 getClientIP() 获取调用方 IP,支撑异常检测与访问日志
  • SDK 初始化规范:锁定 tcb.init + app.auth() 标准初始化模式,禁止硬编码敏感信息

应用场景

用户怎么说本技能做什么
"云函数里怎么知道是谁在调用?"给出 getUserInfo() 代码,解释 uid 与 customUserId 的用法区别,提示授权校验最佳实践
"我有用户的手机号,怎么查到他的 CloudBase 资料?"提供 queryUserInfo({ platform: "PHONE", platformId: "..." }) 的完整调用示例,含其他平台类型枚举
"我们已有用户系统,想直接接入 CloudBase"演示 createTicket 生成票据并返回客户端的 Node 端流程,明确 Web SDK 消费票据的分工
"需要记录用户 IP 做安全审计"给出 getClientIP() 在云函数中的使用方式,提示环境适配与异常处理
"这个老代码里的 auth API 还能用吗?"对照本 Skill 收录的 5 个官方方法签名,标记未列出的 API 为待验证,建议查阅最新文档