小程序登陆流程梳理

1,584 阅读3分钟

希望通过小程序+node来整体的了解下小程序登陆的流程。如有不对欢迎在评论区指出👏

1. client: wx.login / wx.getUserInfo

微信开放平台有APP PC 网站想用微信登录/分享到朋友圈等其提供微信登录、分享、支付等相关权限和服务。需要用unionid来区分用户的唯一性。 需要通过wx.getUserInfo()api拿到用户的encryptedData, iv这些加密数据传给服务端,通过服务端解密获取用户的unionid

getUserInfo() {
  const _this = this
  wx.login({
    success(res) {
      const { code } = res
      console.log(res)
      wx.getUserInfo({
        withCredentials: true,
        success(res) {
          const { encryptedData, iv } = res
          _this.reSaveUserLogin({ code, data: encryptedData, iv })
        }
      })
    }
  })
},

这里需要注意的是,wx.getUserInfo()触发必须得通过button open-type设置为"getUserInfo"点击后才能触发。

    <button wx:if="!isLogin" open-type="getUserInfo" bindtap="getUserInfo">获取用户信息</button>

2. service: request 请求微信服务 / 解密出unionid

  • 服务端请求,需要的参数(js_code:client传的code;appid:小程序唯一标识申请账号时拿到;secret:小程序密钥申请账号时拿到;grant_type:默认值为 authorization_code)
  • 获取 openid sessen_key 参数
// 请求方法
const request = require('request')
const url = https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code
module.exports = {
 async getSession(code) {
   return new Promise((resolve, reject) => {
     request(url,{
         method: 'GET',
         json: true
       },
       (error, res, body) => {
         if (error) {
           reject(error)
         } else {
           if (body.errcode) {
             reject(new Error(body.errmsg))
           } else {
             resolve(body)
           }
         }
       }
     )
   })
 }
}
  • 通过 appId , code,encryptedData,iv 来解密出用户的信息其中包括 unionid字段
  • 需要注意⚠️的是,如果小程序没有绑定过微信开放平台解密出来的字段中是没有unionid的
async function login(ctx) {
 const { code, data, iv } = ctx.request.body
 const session = await getSession(code)
 const { session_key, openid } = session
 const pc = new WXBizDataCrypt(appId, session_key)
 const result = pc.decryptData(data, iv)
 console.log('解密后', result)
}
  • 关于解密的官方提供demo WXBizDataCrypt就是直接copy的官方demo中使用node作为服务端的模版。去官网可以点击下载使用即可

3.service:服务端获取sesson_key 等信息不能直接返回客户端需要加密解密处理

const crypto = require('crypto')
const secret = '2019_06'
const algorithm = 'aes-256-cbc'

function encode(id) {
  const encoder = crypto.createCipher(algorithm, secret)
  const str = [id, Date.now(), '2019'].join('|')
  let encrypted = encoder.update(str, 'utf8', 'hex')
  encrypted += encoder.final('hex')
  return encrypted
}

function decode(str) {
  const decoder = crypto.createDecipher(algorithm, secret)
  let decoded = decoder.update(str, 'hex', 'utf8')
  decoded += decoder.final('utf8')
  const arr = decoded.split('|')
  return {
    id: arr[0],
    timespan: parseInt(arr[1])
  }
}
module.exports = {
  encode,
  decode
}

4.service:返回登陆态

    const { encode } = require('./lib/crypto')
    const jsonMine = 'application/json'
    const now = Date.now()
    function handle(ctx, data, code = 0, message = 'success') {
      ctx.type = jsonMine
      ctx.body = {
        code,
        data,
        message
      }
    }
  router.get('/login', async (ctx, next) => {
    const { code } = ctx.request.query
    const session = await login(code)
    if (session) {
        const { session_key, openid } = session
        // 查找数据库中是否已经存有openid,如果 hasOpenid 为null说明是新用户
        const hasOpenid = await User.findByPk(openid)
        if(!hasOpenid){
            // 数据库存储openid,时间戳
            User.create({openid,timespan:Date.now()})
        }
        handle(ctx, { token: encode(openid) })
    } else {
      throw new Error('登陆失败')
    }
  })

5.client:存储登陆态在storage

import { LOGIN_TOKEN } from '../../utils/localStorage'
// 拿到token存储到客户端
wx.setStorageSync(LOGIN_TOKEN, token)

我在发起请求时将登陆态放在请求头中,相应的服务端可以从请求头中获取

 header: {
    'x-session': wx.getStorageSync(LOGIN_TOKEN)
  },

6.service:校验登陆态

module.exports = async function(ctx, next) {
  const sessionKey = ctx.get('x-session')
  const { id, timespan } = decode(sessionKey)
  // 查找数据库中是否存在该 openid,返回是一个数组,如果不存在则返回[]
  const targetList = await getOpenid(id)
  if (targetList.length > 0) {
    // 如果超过设定的过期时间,标记isExpired字段为登陆过期
    const oneHour = 1000 * 60 * 60 * 24
    if (Date.now() - timespan > oneHour) {
      ctx.state.isExpired = true
      // 跟前台约定,如果code=2说明登陆过期跳登陆页面
      handle(ctx, '', 2, '登陆过期')
    } else {
      handle(ctx, '', 0, '登陆成功')
    }
  } else {
    // 通过ctx.throw可以直接抛出错误
    ctx.throw(401, '登陆失败')
  }

整体流程图