Senparc.Weixin.MP SDK 微信公众平台开发教程(十二):OAuth2.0说明

紧接上一篇《Senparc.Weixin.MP SDK 微信公众平台开发教程(十一):高级接口说明》,这里专讲OAuth2.0。

理解OAuth2.0

  首先我们通过一张图片来了解一下OAuth2.0的运作模式:

  从上图我们可以看到,整个过程进行了2次“握手”,最终利用授权的AccessToken进行一系列的请求,相关的过程说明如下:

  • A:由客户端向服务器发出验证请求,请求中一般会携带这些参数
    • ID标识,例如appId
    • 验证后跳转到的URL(redirectUrl)
    • 状态参数(可选)
    • 授权作用域scope(可选)
    • 响应类型(可选)
  • B:服务器返回一个grant授权标识(微信默认情况下称之为code),类似于一个一次性的临时字符串密钥。如果在A中提供了redirectUrl,这里服务器会做一次跳转,带上grant和状态参数,访问redirectUrl。
  • C:客户端的redirectUrl对应页面,凭借grant再次发起请求,这次请求通常会携带一些敏感信息:
    • ID标识
    • 密码
    • grant字符串(code)
    • grant类型(可选,微信中默认为code)
  • D:服务器验证ID标识、密码、grant都正确之后,返回AccessToken(注意,这里的AccessToken和之前通用接口、高级接口介绍的AccessToken没有关系,不能交叉使用)
  • E:客户端凭借AccessToken请求一系列的API,在此过程中不再会携带appId,Secret,grant等敏感的信息。
  • F:服务器返回请求结果。

微信的OAuth2.0使用

  了解了OAuth2.0的基本原理之后,我们来看一下OAuth2.0在微信中是如何运用的。

  假设一个场景:用户进入了一个微信公众账号,随后通过消息中的链接,在微信内嵌浏览器中打开了一个游戏网页,这个游戏需要用户登录并且记录用户的游戏得分。

  这种情况下我们有两种处理方式:

  1. 让用户在网页中进行注册、登录(并且每次打开这个网页都可能要重新进行登录,因为微信内置浏览器的cookie保存时间非常短),这个当然是个很坑爹的设计。
  2. 利用OAuth2.0。在用户进入这个页面的时候,先判断用户是否登录,如果没有,自动跳转到OAuth2.0授权页面,这个页面又自动进行了上述ABCD一系列验证,再通过EF得到用户的OpenId甚至更加详细的信息(包括头像),自动完成登录(或必要的注册)过程,随后用户以登录状态直接进入游戏。

  可以看出,使用OAuth2.0大幅度提高了用户体验,并且可以自动绑定识别用户微信OpenId。

  需要注意的是,上面提到的“OAuth2.0授权页面”还有两种形式:

  1. 当请求A中的Scope为snsapi_base时,整个授权过程自动完成,用户的客户端不会有任何中间页面显示,但是授权的结果仅能获取用户的OpenId(不管用户是否已关注,当然如果用户是关注用户,再次利用高级接口中的用户信息接口,利用OpenId获取用户资料也是可以的,只不过绕了几个弯)
  2. 当请求A中的Scope为snsapi_userinfo时,需要提供一个授权页面(类似很多网站利用微博账号、QQ号登陆的那种授权),仅当用户同意之后,立即获取到用户的详细信息,这里的用户可以是关注用户,也可以是未关注用户,返回的内容一致。

  也就是说,snsapi_base的方法可以“神不知鬼不觉”地获取用户OpenId,全自动完成登录注册过程,但是信息量有限;snsapi_userinfo需要用户在指定界面上授权之后,自动完成整个过程,这个授权有一个时间段,超过时间后需要重新询问用户。

Senparc.Weixin.MP OAuth2.0接口

  源文件文件夹:Senparc.Weixin.MP/AdvancedAPIs/OAuth

  源代码中相关方法如下:

namespace Senparc.Weixin.MP.AdvancedAPIs
{
    //官方文档:http://mp.weixin.qq.com/wiki/index.php?title=%E7%BD%91%E9%A1%B5%
<think>好的,我现在需要帮助用户解决如何使用Senparc.Weixin.Open库获取微信开放平台的component_verify_ticket的问题。首先,我需要回顾用户提供的引用内容,看看有没有相关的信息。 用户提供了三个引用,其中引用[3]提到在.net web api中接收推送的component_verify_ticket,并可以将其保存在缓存、数据库或文件中。这说明component_verify_ticket是通过微信开放平台推送过来的,而不是主动获取的。因此,步骤应该是配置接收推送的消息,然后从中提取并存储这个票据。 接下来,我需要考虑Senparc.Weixin.Open库中的相关类和方法。引用[1]提到了WeixinOpenException,可能和异常处理有关,但这不是当前问题的重点。引用[2]提到CustomThirdPartyMessageHandlers用于接收和解析消息,这应该与处理微信推送的component_verify_ticket有关。 用户的问题是如何获取component_verify_ticket,根据微信开放平台的流程,第三方平台需要提供一个接收消息的URL,微信服务器会定期推送component_verify_ticket到这个URL。因此,使用Senparc库时,需要设置一个Controller来处理这个推送,并使用CustomThirdPartyMessageHandlers来解析消息。 然后,我需要检查是否需要注册第三方平台信息,例如ComponentBag,这在引用[1]的WeixinOpenException中有提到ComponentBag属性,可能用于存储平台相关信息。注册信息可能需要AppId、密钥等。 另外,引用[3]提到将component_verify_ticket存储在缓存中,这可能涉及到Senparc的缓存机制,比如使用Cache或数据库存储。用户需要在自己的代码中处理接收到的票据,并保存到合适的存储介质中。 可能还需要配置消息处理程序,确保能够正确解析微信推送的XML数据,并从中提取component_verify_ticket。处理完成后,返回成功响应给微信服务器,以避免重复推送。 总结步骤应该是:配置接收URL的Controller,使用CustomThirdPartyMessageHandlers解析消息,提取票据并存储。同时,需要注册第三方平台信息,确保库能正确处理请求。 现在需要验证这些步骤是否正确,是否有遗漏。比如是否需要配置中间件或路由,确保请求能正确路由到Controller。另外,处理消息时是否需要验证签名,这部分Senparc库可能已经封装好了,用户只需关注处理逻辑。 可能还需要参考Senparc的官方文档,确保代码示例的正确性。例如,处理推送消息的Controller可能继承自特定的基类,或者使用特定的属性标记路由。 最后,确保用户了解component_verify_ticket的有效期较长,但仍需定期检查更新,避免过期导致的问题。</think>要通过 Senparc.Weixin.Open 获取微信开放平台的 component_verify_ticket,需通过以下步骤实现: --- ### 一、配置接收推送的 Controller 1. **创建消息接收接口** 在 Web API 中创建用于接收微信推送的 Controller,继承 `WeixinOpenController`: ```csharp public class WeixinOpenController : Senparc.Weixin.Open.Containers.ThirdPartyMessageHandler.WeixinOpenController { // 处理 component_verify_ticket 推送 public override ActionResult Post(string postModel) { var messageHandler = new CustomThirdPartyMessageHandler(Request.InputStream, postModel); messageHandler.Execute(); // 执行消息解析 return Content("success"); // 必须返回 success } } ``` 2. **注册路由** 确保路由配置中包含该接口(如 `/WeixinOpen`),需与微信开放平台后台设置的**授权事件接收URL**一致[^3]。 --- ### 二、实现消息处理器 使用 `CustomThirdPartyMessageHandler` 解析 XML 消息: ```csharp public class CustomThirdPartyMessageHandler : ThirdPartyMessageHandler { public CustomThirdPartyMessageHandler(Stream inputStream, string postModel) : base(inputStream, postModel) { } public override IResponseMessageBase OnComponentVerifyTicketRequest(RequestMessageComponentVerifyTicket requestMessage) { // 提取 component_verify_ticket var componentVerifyTicket = requestMessage.ComponentVerifyTicket; // 存储到缓存(示例使用 Senparc 缓存) CacheStrategyFactory.GetObjectCacheStrategyInstance().Set( "ComponentVerifyTicket", componentVerifyTicket, TimeSpan.FromMinutes(20)); // 根据实际情况设置过期时间[^3] return new SuccessResponseMessage(); } } ``` --- ### 三、注册第三方平台信息 在全局启动时注册组件信息: ```csharp var componentAppId = "第三方平台AppId"; var componentSecret = "第三方平台AppSecret"; var componentToken = "令牌"; var componentEncodingAESKey = "消息加解密Key"; ComponentContainer.Register( componentAppId, componentSecret, componentToken, componentEncodingAESKey); ``` --- ### 四、获取已存储的 component_verify_ticket 后续通过缓存或数据库读取: ```csharp var componentVerifyTicket = CacheStrategyFactory.GetObjectCacheStrategyInstance().Get<string>("ComponentVerifyTicket"); ``` --- 相关问题
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值