uni-id入门(二)---准备工作

最新推荐文章于 2025-09-23 16:18:56 发布

原创最新推荐文章于 2025-09-23 16:18:56 发布 · 4.6k 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#uni-id #uni-app #uniCloud #云数据库 #用户体系

unicloud云开发同时被 2 个专栏收录

23 篇文章

订阅专栏

uni-id入门

7 篇文章

订阅专栏

本文档介绍了如何使用uni-id构建用户系统，包括登录注册、手机邮箱验证、多应用共享用户等功能。通过HbuilderX创建uni-app项目，配置uni-id模块，集成云服务空间和数据库模板，实现无后端开发的用户管理。同时，提供了视频教程链接和资源下载地址，帮助开发者快速上手云开发。

让我们来开始使用uni-id搭建用户体系吧
他可以让你的系统拥有登陆注册，手机验证码登陆注册，邮箱登陆，手机号和邮箱的绑定以及解绑。
也可以让你拥有多应用共享一套用户的能力。
让你不会写后端也可以拥有用户体系。
结合uni-admin能快速搭建后台管理
比如A,B,C,D用的是同一个服务空间的云数据库，那么就可以共用用户。
后续为视频讲解
我们的视频教程(免费)链接为https://static-b5208986-2c02-437e-9a27-cfeba1779ced.bspapp.com/

课程视频 https://www.bilibili.com/video/BV1yV411j7S6/

在OSCHINA 社区发现未经允许转载所以决定搬运博客过去
我的博客即将同步至 OSCHINA 社区，这是我的 OSCHINA ID：dmhsq，邀请大家一同入驻：https://www.oschina.net/sharing-plan/apply

开发工具

使用Hbuilder X 可更好的使用uni-id

下载地址 https://www.dcloud.io/hbuilderx.html
下载app开发版
在这里插入图片描述

创建服务空间

地址为 https://unicloud.dcloud.net.cn/login

推荐创建阿里云服务空间因为可以创建多个免费的页面托管也免费

在这里插入图片描述

创建数据库表

创建官方给的uni-id模板全套

在这里插入图片描述

引入uni-id模块

打开Hbuilder X创建一个uni-app项目

在这里插入图片描述
关联服务空间如果创建项目时没有启用uniCloud就需要创建云服务空间

在这里插入图片描述
创建cloudfunctions目录

在这里插入图片描述
创建common目录

在这里插入图片描述
插件市场下载 uni-id 地址为 https://ext.dcloud.net.cn/plugin?id=2116

在这里插入图片描述

复制它到common目录下

在这里插入图片描述

配置uni-id

配置文件为config.json

以下来自uni-id文档 https://uniapp.dcloud.io/uniCloud/uni-id

// 如果拷贝此内容切记去除注释
{
    "passwordSecret": "passwordSecret-demo", // 数据库中password字段是加密存储的，这里的passwordSecret即为加密密码所用的密钥，注意修改为自己的密钥，使用一个较长的字符串即可
    "tokenSecret": "tokenSecret-demo", // 生成token所用的密钥，注意修改为自己的，使用一个较长的字符串即可
    "tokenExpiresIn": 7200, // 全平台token过期时间，未指定过期时间的平台会使用此值
    "tokenExpiresThreshold": 600, // 新增于uni-id 1.1.7版本，checkToken时如果token有效期小于此值则自动获取新token，请注意将新token返回给前端保存，如果不配置此参数则不开启自动获取新token功能
    "bindTokenToDevice": true, // 是否将token和设备绑定，设置为true会进行ua校验，默认为true
    "passwordErrorLimit": 6, // 密码错误最大重试次数
    "passwordErrorRetryTime": 3600, // 密码错误重试次数超限之后的冻结时间
    "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=cachepermissionintoken
    "app-plus": {
        "tokenExpiresIn": 2592000,
        "oauth": {
            // App微信登录所用到的appid、appsecret需要在微信开放平台获取，注意：不是公众平台而是开放平台
            "weixin": {
                "appid": "weixin appid",
                "appsecret": "weixin appsecret"
            },
            "apple": { // 使用苹果登录时需要
                "bundleId": "your bundleId"
            }
        }
    },
    "mp-weixin": {
        "tokenExpiresIn": 259200,
        "oauth": {
            // 微信小程序登录所用的appid、appsecret需要在对应的小程序管理控制台获取
            "weixin": {
                "appid": "weixin appid",
                "appsecret": "weixin appsecret"
            }
        }
    },
    "mp-alipay": {
        "tokenExpiresIn": 259200,
        "oauth": {
            // 支付宝小程序登录用到的appid、privateKey请参考支付宝小程序的文档进行设置或者获取，https://opendocs.alipay.com/open/291/105971#LDsXr
            "alipay": {
                "appid": "alipay appid",
                "privateKey": "alipay privateKey", // 私钥
                "keyType": "PKCS8" // 私钥类型，如果私钥类型不是PKCS8，需要填写此字段，否则会出现“error:0D0680A8:asn1 encoding routines:ASN1_CHECK_TLEN:wrong tag”错误
            }
        }
    },
    "service": {
        "sms": {
            "name": "your app name", // 应用名称，对应短信模版的name
            "codeExpiresIn": 180, // 验证码过期时间，单位为秒，注意一定要是60的整数倍
            "smsKey": "your sms key", // 短信密钥key，开通短信服务处可以看到
            "smsSecret": "your sms secret" // 短信密钥secret，开通短信服务处可以看到
        },
        "univerify": {
      "appid": "your appid", // 当前应用的appid，使用云函数URL化，此项必须配置
            "apiKey": "your apiKey",// apiKey 和 apiSecret 在开发者中心获取，开发者中心：https://dev.dcloud.net.cn/uniLogin/index?type=0，文档：https://ask.dcloud.net.cn/article/37965
            "apiSecret": "your apiSecret"
        }
    }
}