跳到主要内容

自定义登录

POST 
/auth/v1/signin/custom

适用场景​

  • 企业自有账号体系与 CloudBase 账号体系的一对一映射
  • 需要完全自定义鉴权流程的业务场景
  • 需要实现自有账号系统与云开发服务的无缝集成

功能说明​

1.服务端签发 Ticket​

开发者需在服务端使用 CloudBase SDK 签发登录凭证(Ticket)，该凭证用于后续客户端认证

代码示例：​

  const cloudbase = require("@cloudbase/node-sdk");

  // 1. 初始化 SDK
  const app = cloudbase.init({
  env: "your-env-id",
    // 传入自定义登录私钥
  credentials: require("/path/to/your/tcb_custom_login.json")
  });
    
  // 2. 开发者自定义的用户唯一身份标识
  const customUserId = "your-customUserId";
  
  // 3. 创建ticket
  const ticket = app.auth().createTicket(customUserId);
  
  // 4. 将ticket返回至客户端
  return ticket;

2.客户端自定义登录​

接口说明​

客户端使用服务端签发的 Ticket 获取访问凭证

请求示例：​

  {
    "provider_id": "custom",
    "ticket": "your_ticket"
  }

关键特性：​

  • access_token 有效期为 7200 秒（2小时）
  • refresh_token 有效期为 2592000 秒（30天）
  • 建议实现 token 自动刷新机制

Request​

Responses​

Response Headers