微信OAuth 2.0网站应用登录

随便写写
278 阅读6分钟

网站应用微信登录开发指南

网站应用微信登录是基于OAuth2.0协议标准构建的微信OAuth2.0授权登录系统。

准备工作

在进行微信OAuth2.0授权登录接入之前，在微信开放平台注册开发者账号，并拥有一个已审核通过的网站应用，并配置回调的域名，获得相应的AppID和AppSecret，申请微信登录且通过审核后，可开始接入流程。

提交网站应用： image.png

开发者资质认证：

ifFpD0VdDb.jpg

授权流程

微信OAuth2.0授权登录目前支持authorization_code模式，适用于拥有server端的应用授权。该模式整体流程为：

  1. 第三方发起微信授权登录请求，微信用户允许授权第三方应用后，微信会拉起应用或重定向到第三方网站，并且带上授权临时票据code参数
  2. 通过code参数加上AppID和AppSecret等，通过API换取access_token
  3. 通过access_token进行接口调用，获取用户基本数据资源或帮助用户实现基本操作

image.png

第一步：请求CODE

第三方通过授权临时票据code进行获取access_token，code的超时时间为10分钟，一个code只能成功换取一次access_token即失效。code的临时性和一次保障了微信授权登录的安全性。第三方可通过使用https和state参数，进一步加强自身授权登录的安全性。

访问链接： https://open.weixin.qq.com/connect/qrconnect?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

参数说明

参数是否必填说明
appid是应用唯一标识，在微信开放平台提交应用审核通过后获得
redirect_uri是请使用urlEncode对链接进行处理
response_type是应用唯一标识
scope是应用授权作用域，网页应用目前仅填写snsapi_login
state否用于保持请求和回调的状态，授权请求后原样带回给第三方。该参数可用于防止csrf攻击，建议第三方带上该参数，可设置为简单的随机数加session进行校验

返回说明

用户允许授权后，将会重定向到redirect_uri的网址上，并且带上code和state参数：redirect_uri?code=CODE&state=STATE。若用户禁止授权，则不会发生重定向。

请求示例

一号店的微信登陆授权申请链接：https://open.weixin.qq.com/connect/qrconnect?appid=wxbdc5610cc59c1631&redirect_uri=https%3A%2F%2Fpassport.yhd.com%2Fwechat%2Fcallback.do&response_type=code&scope=snsapi_login&state=3d6be0a4035d839573b04816624a415e#wechat_redirect，其中state参数是一号店生成的。访问链接会出现提供给用户扫描的二维码：

image.png

第二步，通过CODE获取access_token

访问链接https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

参数说明

参数是否必填说明
appid是应用唯一标识
secret是应用密钥AppSecret，在微信开放平台提交应用审核通过后获得
code是填写第一步获取的code参数
grant_type是填authorization_code

返回说明

{ 
    "access_token":"ACCESS_TOKEN", 
    "expires_in":7200, 
    "refresh_token":"REFRESH_TOKEN",
    "openid":"OPENID", 
    "scope":"SCOPE",
    "unionid": "UNIONID"
}
参数说明
access_token接口调用凭证
expires_inaccess_token接口调用凭证超时时间，单位（秒）
refresh_token用于刷新access_token
openid授权用户唯一标识
scope用户授权的作用域，使用逗号（,）分隔
unionid当且仅当该网站应用已获得该用户的userinfo授权时，才会出现该字段

错误的返回样例：

{
    "errcode": 40029,
    "errmsg": "invalid code"
}

检验授权凭证(access_token)是否有效

访问链接：https://api.weixin.qq.com/sns/auth?access_token=ACCESS_TOKEN&openid=OPENID

参数说明

参数是否必须说明
access_token是调用接口凭证
openid是普通用户标识，对该公众账号唯一

返回说明

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

刷新access_token有效期

access_token是调用授权关系接口的调用凭证，由于access_token有效期（目前为2个小时）较短，当access_token超时后，可以使用refresh_token进行刷新，access_token刷新结果有两种：

  1. 若access_token已超时，那么进行refresh_token会获取一个新的access_token，新的超时时间；
  2. 若access_token未超时，那么进行refresh_token不会改变access_token，但超时时间会刷新，相当于续期access_token。

https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN

参数说明

参数是否必须说明
appid是应用唯一标识
grant_type是填refresh_token
refresh_token是通过CODE获取access_token时获取的refresh_token

返回说明

同获取access_token的返回。

第三步：通过access_token调用接口

使用未过期access_token可以进行接口调用，能调用的接口如下：

授权作用域（scope）接口接口说明
snsapi_base/sns/oauth2/access_token通过code换取access_token、refresh_token和已授权scope
snsapi_base/sns/oauth2/refresh_token刷新或续期access_token使用
snsapi_base/sns/auth检查access_token有效性
snsapi_userinfo/sns/userinfo获取用户个人信息

授权作用域（scope）代表用户授权给第三方的接口权限，第三方应用需要向微信开放平台申请使用相应scope的权限后，使用文档所述方式让用户进行授权，经过用户授权，获取到相应access_token后方可对接口进行调用。

获取用户个人信息（UnionID机制）

开发者可通过OpenID来获取用户基本信息。如果开发者拥有多个移动应用、网站应用和公众账号，可通过获取用户基本信息中的unionid来区分用户的唯一性。换句话说，同一用户，对同一个微信开放平台下的不同应用，unionid是相同的。

请注意，在用户修改微信头像后，旧的微信头像URL将会失效，因此开发者应该自己在获取用户信息后，将头像图片保存下来，避免微信头像URL失效后的异常情况。开发者最好保存用户unionID信息，以便以后在不同应用中进行用户信息互通。

访问链接： https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID

参数说明

参数是否必须说明
access_token是调用凭证
openid是普通用户的标识，对当前开发者账号唯一

返回说明

{
    "openid":"OPENID",
    "nickname":"NICKNAME",
    "headimgurl": "https://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/0",
    "privilege":[
        "PRIVILEGE1",
        "PRIVILEGE2"
        ],
    "unionid": " o6_bmasdasdsad6_2sgVt7hMZOPfL"
}
参数说明
openid普通用户的标识，对当前开发者账号唯一
nickname普通用户昵称
headimgurl用户头像，最后一个数值代表正方形头像大小（有0、46、64、96、132数值可选，0代表640x640正方形头像），用户没有头像时该项为空
privilege用户特权信息，json数组
unionid用户统一标识。针对一个微信开放平台账号下的应用，同一用户的unionid是唯一的。

参考

微信登录功能 / 网站应用微信登录开发指南 (qq.com)

avatar
文章
阅读
粉丝