위챗 미니 프로그램 - 위챗 로그인, 위챗 결제, 템플릿 메시지에 대한 자세한 설명

위챗 공개 플랫폼은 최근 위챗 미니 프로그램(위챗 공개 계정) 기능에 대한 내부 테스트를 조용히 시작했으며, 미니 프로그램 출시와 함께 수많은 개발자와 일반 사용자의 관심을 끌었습니다. 기능은 다음과 같이 소개됩니다.

wx.login(객체)

인터페이스를 호출하여 로그인 자격 증명(코드)을 얻은 다음 사용자의 고유 식별자(openid) 및 이 로그인에 대한 세션 키(session_key)를 포함하여 사용자 로그인 상태 정보를 교환합니다. 사용자 데이터 통신의 암호화 및 암호 해독은 세션 키에 따라 다릅니다.

OBJECT 매개변수 설명:

샘플 코드:

//app.js
App({
 onLaunch: function() {
  wx.login({
   success: function(res) {
    if (res.code) {
     //发起网络请求
     wx.request({
      url: 'https://test.com/onLogin',
      data: {
       code: res.code
      }
     })
    } else {
     console.log('获取用户登录态失败！' + res.errMsg)
    }
   }
  });
 }
})

이는 HTTP 인터페이스이며 개발자 서버는 로그인 자격 증명 코드를 사용하여 session_key 및 openid를 얻습니다. 여기서 session_key는 사용자 데이터를 암호화하고 서명하는 데 사용되는 키입니다. 애플리케이션 보안을 위해 session_key는 네트워크를 통해 전송되어서는 안 됩니다.

인터페이스 주소:

https://api.weixin.qq.com/sns/jscode2session?appid=APPID&secret=SECRET&js_code=JSCODE&grant_type=authorization_code

요청 매개변수:

반환 매개변수:

반품 지침:

//正常返回的JSON数据包
{
   "openid": "OPENID",
   "session_key": "SESSIONKEY"
   "expires_in": 2592000
}
//错误时返回JSON数据包(示例为Code无效)
{
  "errcode": 40029,
  "errmsg": "invalid code"
}

​

로그인 상태 유지 관리

wx.login()을 통해 사용자 로그인 상태를 얻은 후에는 로그인 상태를 유지해야 한다. 개발자는 session_key 및 openid와 같은 필드를 사용자 식별자 또는 세션 식별자로 직접 사용하지 않도록 주의해야 합니다. 대신 세션 로그인 상태를 직접 전달해야 합니다(로그인 시퀀스 다이어그램 참조). 개발자가 직접 생성한 세션의 경우 보안이 보장되어야 하며 만료 시간을 길게 설정해서는 안 됩니다. 세션이 미니 프로그램 클라이언트로 디스패치된 후 후속 통신을 위해 스토리지에 저장할 수 있습니다.

로그인 순서 다이어그램

wx.checkSession(객체)

로그인 상태가 만료되었는지 확인하세요.

샘플 코드:

wx.checkSession({
 success: function(){
  //登录态未过期
 },
 fail: function(){
  //登录态过期
  wx.login()
 }
})

​

서명 확인 및 사용자 데이터 암호화 및 복호화

데이터 서명 확인

개방형 인터페이스에서 반환된 사용자 데이터의 보안을 보장하기 위해 WeChat은 일반 텍스트 데이터에 서명합니다. 개발자는 데이터 무결성을 보장하기 위해 비즈니스 요구 사항에 따라 데이터 패킷에 대한 서명 확인을 수행할 수 있습니다.

서명 검증 알고리즘은 사용자의 session_key를 포함하며, wx.login 로그인 프로세스를 통해 사용자의 session_key를 획득하고 애플리케이션 자체 로그인 상태와의 해당 관계를 자체적으로 유지합니다.

인터페이스(예: wx.getUserInfo)를 호출하여 데이터를 얻을 때 인터페이스는 rawData와 서명을 동시에 반환합니다. 여기서 서명 = sha1(rawData + session_key)

개발자는 확인을 위해 서명과 rawData를 개발자 서버로 보냅니다. 서버는 사용자의 해당 session_key를 이용하여 동일한 알고리즘으로 서명(signature2)을 계산하고, 서명(signature)과 서명2(signature2)를 비교하여 데이터의 무결성을 검증한다.

wx.getUserInfo의 데이터 확인과 같은:

인터페이스에서 반환된 rawData:

{
 "nickName": "Band",
 "gender": 1,
 "language": "zh_CN",
 "city": "Guangzhou",
 "province": "Guangdong",
 "country": "CN",
 "avatarUrl": "http://wx.qlogo.cn/mmopen/vi_32/1vZvI39NWFQ9XM4LtQpFrQJ1xlgZxx3w7bQxKARol6503Iuswjjn6nIGBiaycAjAtpujxyzYsrztuuICqIM5ibXQ/0"
}

​

사용자의 세션 키:

HyVFkGl5F5OQWJZZaNzBBg==

따라서 서명에 사용되는 문자열은 다음과 같습니다.

{
 "nickName": "Band",
 "gender": 1,
 "language": "zh_CN",
 "city": "Guangzhou",
 "province": "Guangdong",
 "country": "CN",
 "avatarUrl": "http://wx.qlogo.cn/mmopen/vi_32/1vZvI39NWFQ9XM4LtQpFrQJ1xlgZxx3w7bQxKARol6503Iuswjjn6nIGBiaycAjAtpujxyzYsrztuuICqIM5ibXQ/0"
}HyVFkGl5F5OQWJZZaNzBBg==

​

sha1을 사용하여 얻은 결과는 다음과 같습니다.

75e81ceda165f4ffa64f4068af58c64b8f54b88c

암호화된 데이터 복호화 알고리즘

인터페이스에 민감한 데이터(예: wx.getUserInfo의 openId 및 UnionId)가 포함된 경우 인터페이스의 일반 텍스트 콘텐츠에는 이러한 민감한 데이터가 포함되지 않습니다. 개발자가 중요한 데이터를 확보해야 하는 경우 인터페이스에서 반환된 암호화된 데이터(encryptedData)를 대칭적으로 해독해야 합니다. 해독 알고리즘은 다음과 같습니다.

대칭 복호화에 사용되는 알고리즘은 AES-128-CBC이며 데이터는 PKCS#7로 채워집니다.

대칭 복호화의 대상 암호문은 Base64_Decode(encryptedData)입니다.

대칭 복호화 키 aeskey = Base64_Decode(session_key), aeskey는 16바이트입니다.

对称解密算法初始向量 iv 会在数据接口中返回。

微信官方提供了多种编程语言的示例代码（点击下载）。每种语言类型的接口名字均一致。调用方式可以参照示例。

注：此前提供的加密数据（encryptData）以及对应的加密算法将被弃用，请开发者不要再依赖旧逻辑。

用户信息：

### wx.getUserInfo(OBJECT)

获取用户信息，需要先调用 wx.login 接口。

OBJECT参数说明：

success返回参数说明：

示例代码：

wx.getUserInfo({
 success: function(res) {
  var userInfo = res.userInfo
  var nickName = userInfo.nickName
  var avatarUrl = userInfo.avatarUrl
  var gender = userInfo.gender //性别 0：未知、1：男、2：女
  var province = userInfo.province
  var city = userInfo.city
  var country = userInfo.country
 }
})

encryptedData 解密后为以下 json 结构，详见加密数据解密算法

{
  "appId": "APPID",
  "openId": "OPENID",
  "nickName": "NICKNAME",
  "gender": 1,
  "city": "CITY",
  "province": "PROVINCE",
  "country": "COUNTRY",
  "avatarUrl": "AVATARURL",
  "unionId": "UNIONID"
}

UnionID机制说明：

如果开发者拥有多个移动应用、网站应用、和公众帐号（包括小程序），可通过unionid来区分用户的唯一性，因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号（包括小程序），用户的unionid是唯一的。换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。

微信开放平台绑定小程序流程

前提：微信开放平台帐号必须已完成开发者资质认证

开发者资质认证流程：

登录微信开放平台(open.weixin.qq.com) – 帐号中心 – 开发者资质认证

微信支付：

wx.requestPayment(OBJECT)
发起微信支付。

Object参数说明：

示例代码：

wx.requestPayment({
  'timeStamp': '',
  'nonceStr': '',
  'package': '',
  'signType': 'MD5',
  'paySign': '',
  'success':function(res){
  },
  'fail':function(res){
  }
})

基于微信的通知渠道，我们为开发者提供了可以高效触达用户的模板消息能力，以便实现服务的闭环并提供更佳的体验。

模板推送位置：服务通知

模板下发条件：用户本人在微信体系内与页面有交互行为后触发，详见下发条件说明

模板跳转能力：点击查看详情仅能跳转下发模板的该帐号的各个页面

使用说明

获取模板 id

登录https://mp.weixin.qq.com获取模板，如果没有合适的模板，可以申请添加新模板，审核通过后可使用，详见模板审核说明

页面的

{"access_token": "ACCESS_TOKEN", "expires_in": 7200}

{
 "touser": "OPENID", 
 "template_id": "TEMPLATE_ID", 
 "page": "index",     
 "form_id": "FORMID",     
 "data": {
   "keyword1": {
     "value": "339208499", 
     "color": "#173177"
   }, 
   "keyword2": {
     "value": "2015年01月05日 12:30", 
     "color": "#173177"
   }, 
   "keyword3": {
     "value": "粤海喜来登酒店", 
     "color": "#173177"
   } , 
   "keyword4": {
     "value": "广州市天河区天河路208号", 
     "color": "#173177"
   } 
 },
 "emphasis_keyword": "keyword1.DATA"
}

{
 "errcode": 0,
 "errmsg": "ok",
}