From d71ba1192b00cfb7a3438fa09dc997ee5651b44b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E4=BA=9A=E7=90=AA?= Date: Sat, 15 Jan 2022 16:09:02 +0800 Subject: [PATCH] docs: uni-id preferedAppPlatform --- docs/uniCloud/uni-id.md | 39 ++++++++++++++++++++++++++++++++++++++- 1 file changed, 38 insertions(+), 1 deletion(-) diff --git a/docs/uniCloud/uni-id.md b/docs/uniCloud/uni-id.md index ecc1f3bc0..f49aeb61b 100644 --- a/docs/uniCloud/uni-id.md +++ b/docs/uniCloud/uni-id.md @@ -151,7 +151,8 @@ exports.main = async (event, context) => { "autoSetInviteCode": false, // 是否在用户注册时自动设置邀请码，默认不自动设置 "forceInviteCode": false, // 是否强制用户注册时必填邀请码，默认为false（需要注意的是目前只有短信验证码注册才可以填写邀请码）,设置为true时需要在loginBySms时指定type为register来使用注册，登录时也要传入type为login "removePermissionAndRoleFromToken": false, // 新增于uni-id 3.0.0版本，如果配置为false则自动缓存用户的角色、权限到token中，默认值为false。详细说明见https://uniapp.dcloud.io/uniCloud/uni-id?id=cache-permission-in-token - "app-plus": { + "preferedAppPlatform": "app", // 指定app端对应的PLATFORM名称，用于处理app-plus和app的兼容问题，详细说明见：https://uniapp.dcloud.net.cn/uniCloud/uni-id?id=prefered-app-platform + "app": { // 此处需和preferedAppPlatform保持一致 "tokenExpiresIn": 2592000, "oauth": { // App微信登录所用到的appid、appsecret需要在微信开放平台获取，注意：不是公众平台而是开放平台 @@ -243,6 +244,42 @@ const userSegment = token.split('.')[1] const userInfo = atob(userSegment) // '{"uid":"61a593ba91a750000166f78d","role":["admin"],"permission":[],"iat":1638243365,"exp":1638250565}' ``` +## preferedAppPlatform@prefered-app-platform + +**前提介绍：** + +uni-app vue2版本app端对应的platform为`app-plus`，uni-app vue3版本app端对应的platform为`app`。此改动引发了一些问题，比如在uni-id内使微信登录会无法匹配对应的平台导致登录报错。 + +由于uni-id将客户端平台存储在了数据库内（例如：app端微信登录的openid被存储为`wx_openid['app-plus']`），此问题无法平滑升级，因此对于新老项目建议分别处理。 + +### 旧项目的处理 + +旧项目建议将所有platform为app的场景统一为app-plus，即建议使用如下配置 + +```js +// 以下仅列出相关配置 +{ + "preferedAppPlatform": "app-plus", // uni-id内部会将收到的app平台全部转化为app-plus平台 + "app-plus": { // 配置内的平台名称和preferedAppPlatform保持一致 + "oauth": {} + } +} +``` + +### 新项目的处理 + +新项目建议将platform统一为app，即建议使用如下配置 + +```js +// 以下仅列出相关配置 +{ + "preferedAppPlatform": "app", // uni-id内部会将收到的app-plus平台全部转化为app平台 + "app": { // 配置内的平台名称和preferedAppPlatform保持一致 + "oauth": {} + } +} +``` + # 用户角色权限@rbac 为什么需要角色权限管理？ -- GitLab