微信授权登录
经微信开放平台(普通网站应用及移动应用等)授权的应用可以直接使用微信登录 CloudBase。
版本说明
本文将以 V2 版本进行介绍
前置动作
开启微信登录
注册流程
使用微信授权登录时,用户在第一次使用微信登录时会自动创建对应的 CloudBase 用户账号,无需单独的注册流程。
具体流程如下:
- 用户第一次使用微信登录时,系统会自动创建 CloudBase 用户
- 用户的微信信息(如昵称、头像等)会自动同步到 CloudBase 用户资料中
- 后续使用相同微信账号登录时,会直接登录到对应的 CloudBase 用户
登录流程
获取第三方平台授权页地址
填入微信平台 ID、重定向 URI 和自定义状态标识字段用于识别平台回调来源。系统内置有微信开放平台的平台 ID。
auth 实例请参考 SDK 初始化
Auth.genProviderRedirectUri 用于生成第三方平台授权页URL
const {
uri
} = await auth.genProviderRedirectUri({
provider_id: "wx_open", // 微信开放平台
provider_redirect_uri: providerUri, // 重定向 URI
state: state, // 自定义状态标识
other_params: otherParams // 其他参数
});
访问 URI 并进行授权后,回调至指定地址,获取第三方平台 token
将用户重定向至 URI,例如 location.href = uri
;待用户授权完毕后,回调至指定的 provider_redirect_uri
地址。
// 此时 url query 中携带授权 code,state 等参数
// 1. 检查 state 是否符合预期(如设置的 wx_open)
// 2. 获取第三方平台跳转回页面时,url param 中携带的 code 参数
const provider_code = "your_provider_code";
// 3. 如符合预期,获取第三方平台 token
const {
provider_token
} = await auth.grantProviderToken({
provider_id: "wx_open",
provider_redirect_uri: "curpage", // 指定三方平台跳回的 url 地址
provider_code: provider_code // 第三方平台跳转回页面时,url param 中携带的 code 参数
});
通过第三方平台 token 登录
await auth.signInWithProvider({
provider_token: provider_token
});