网页授权获取用户基本信息
模板消息里点击详情可以跳转到某个页面,但模板本身是微信内部固定好的,不是随便设计。
如果用户在微信客户端中访问第三方网页,公众号可以通过微信网页授权机制,来获取用户基本信息,进而实现业务逻辑。
网页授权回调域名说明
- 在微信公众号请求用户网页授权之前,开发者需要先到公众平台官网中的“开发 – 接口权限 – 网页服务 – 网页帐号 – 网页授权获取用户基本信息”里,修改授权回调域名。这里填写的是域名(字符串),不是 URL,因此请勿加 http:// 等协议头。
- 授权回调域名配置规范为全域名。比如需要网页授权的域名为:www.qq.com,配置以后此域名下面的页面 http://www.qq.com/music.html 、 http://www.qq.com/login.html 都可以进行 OAuth2.0 鉴权;但 http://pay.qq.com 、 http://music.qq.com 、 http://qq.com 无法进行 OAuth2.0 鉴权。
- 如果公众号登录授权给了第三方开发者来进行管理,则不必做任何设置,由第三方代替公众号实现网页授权即可。
两种 scope 的区别
- 以 snsapi_base 为 scope 发起的网页授权,用来获取进入页面的用户的 openid,是静默授权并自动跳转到回调页。用户感知就是直接进入了回调页(往往是业务页面)。
- 以 snsapi_userinfo 为 scope 发起的网页授权,用来获取用户的基本信息。这种授权需要用户手动同意,用户同意过后,无须关注公众号,也可在授权后获取该用户的基本信息。
- 用户管理类接口中的“获取用户基本信息接口”,是在用户和公众号产生消息交互或关注后事件推送后,才能根据用户 OpenID 来获取用户基本信息。这个接口,包括其他微信接口,都需要该用户(openid)关注了公众号后,才能调用成功。
网页授权 access_token 和普通 access_token 的区别
- 微信网页授权是通过 OAuth2.0 机制实现的,用户授权给公众号后,公众号可以获取到网页授权特有的接口调用凭证(网页授权 access_token),通过它可以进行授权后接口调用,如获取用户基本信息。
- 其他微信接口,需要通过基础支持中的“获取 access_token”接口来获取普通 access_token 调用。
UnionID 机制
- 网页授权获取用户基本信息也遵循 UnionID 机制。如果开发者有多个公众号,或在公众号、移动应用之间统一用户帐号,需要前往微信开放平台(open.weixin.qq.com)绑定公众号后,才能利用 UnionID 机制满足需求。
- UnionID 机制作用:如果开发者拥有多个移动应用、网站应用和公众帐号,可通过用户基本信息中的 unionid 区分用户唯一性。同一用户,对同一个微信开放平台下的不同应用(移动应用、网站应用和公众帐号),unionid 是相同的。
特殊场景下的静默授权
- 以 snsapi_base 为 scope 的网页授权,是静默授权,用户无感知。
- 对于已关注公众号的用户,如果从公众号会话或者自定义菜单进入本公众号的网页授权页,即使是 scope 为 snsapi_userinfo,也是静默授权,用户无感知。
网页授权流程
- 引导用户进入授权页面同意授权,获取 code
- 通过 code 换取网页授权 access_token(与基础支持中的 access_token 不同)
- 如果需要,开发者可以刷新网页授权 access_token,避免过期
- 通过网页授权 access_token 和 openid 获取用户基本信息(支持 UnionID 机制)
配置授权回调域名
在测试账号管理页面中配置网页授权回调域名。
修改菜单地址为网页授权地址
secondButton.Add(new
{
type = "view",
name = "管理后台",
url = string.Format(
"https://open.weixin.qq.com/connect/oauth2/authorize?appid={0}&redirect_uri={1}&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect",
APPID,
"http%3a%2f%2f2l1941590s.imwork.net%2fhome%2fmanage")
});Code language: JavaScript (javascript)
记得要对回调地址进行 URL 编码:
http%3a%2f%2f2l1941590s.imwork.net%2fhome%2fmanageCode language: CSS (css)
用户同意授权后
如果用户同意授权,页面将跳转至:
redirect_uri/?code=CODE&state=STATE
code 说明:code 作为换取 access_token 的票据,每次用户授权带上的 code 都不一样,code 只能使用一次,5 分钟未被使用自动过期。
Previous: 14-发送模板消息