通用社区登陆组件技术分享（开源）中篇：OAuth 登陆组件流程及组件集成方法

上节内容：通用社区登陆组件技术分享（开源）上篇：OAuth 授权登陆介绍
 

本节包括以下内容：

1：第三方社区账号登陆的授权流程

2：OAuth2 组件的下载及web.config配置

3：OAuth2 组件的5行代码编写流程

4 ：总结与下节内容预告

1：首先从这里开始：用户进入登陆界面

 

2：用户点击用新浪微博或QQ登陆，系统跳到第三方授权页面，（QQ示例授权界面）

3：确定授权后，第三方跳转返回你的回调页（在应用里设置），通常仍是系统登陆页面统一处理。授权用户绑定您网站的账号。

 

我们首次引导登陆并绑定账号，当然，官方建议的比较好的用户体验的界面是这样的：

  

4：用户正常登陆或注册新账号，自动实现绑定，至此流程结束，下一次用户点用第三方账号登陆时，系统检测到已绑定账号，直接用绑定的账号进入后台。

 

二：OAuth2 组件的下载及web.config配置 

 

1：下载OAuth2.dll组件，下载： OAuth2.rar()

2：引用该dll到您的网站项目中；

3：在web.config配置您的appkey、appsercet及回调网址（通常是登陆页面），相关的数据填写到web.config对应key的value里。

 

PS：获取或调置回调网址是在新浪和QQ开放者平台操作的，相关网址见上节文章。

 

接下来，我们要在登陆界面（示如Login.aspx)动点小手术： 

三：OAuth2 组件的5行代码编写流程 

1： OAuth2.UI.GetHtml() //获取界面显示

代码示例：通常我们可能会在Login.aspx的html里写上这么一行代码来显示：  %=OAuth2.UI.GetHtml()%

当然我们也经常喜欢在Login.aspx.cs后台代码（通常是Page_Load事件）里输出：div控件ID.InnerHtml=OAuth2.UI.GetHtml(); 

于是就有了刚才的登陆界面下面那两个第三方授权链接图标： 

  

 

用户点击第三方授权，跳到第三方授权页面，操作完回调还会返回到这个登陆界面，只是多了两个参数code=xxxx state=xxx（回调页面仍设置登陆页）。

2：OAuth2.OAuth2Base ob = OAuth2.OAuth2Factory.Current;//获取当前的授权类型，如果成功，则缓存到Session中。 

3：ob.Authorize(out account)//检测是否授权成功，并返回绑定的账号。

这两行代码，是写在Page_Load事件中，判断如果是跳转回来的，就分析授权，然后进行分支处理：

以下是示例的分支代码：

OAuth2.OAuth2Base ob = OAuth2.OAuth2Factory.Current;//获取当前的授权类型
if (ob != null) //说明用户点击了授权，并返回到登陆界面来
{
    string account = string.Empty;
    if (ob.Authorize(out account))//检测是否授权成功，并返回绑定的账号（具体是绑定ID还是用户名，你的选择）
    {  
      if (!string.IsNullOrEmpty(account))//已绑定账号，直接用该账号设置登陆。
      {
          //根据账号，设置登陆、设置cookie，跳转到后台管理界面。
      }
      else // 未绑定账号，引导提示用户绑定账号。
      {
           //取用户的第三方头像和昵称，组装界面显示，像秋色园就一行提示文字           
      }

    } 

}
else // 读取授权失败。
{
     //提示用户重试，或改用其它社区方法登陆。
}

如果用户已经授权，首次未绑定账号，通常就有了最下方的提示文字，同时“登陆”的文字就改成了“绑定账号"：

  

 

4：OAuth2.OAuth2Base ob = OAuth2.OAuth2Factory.SessionOAuth;//获取存在Session的授权

5：ob.SetBindAccount(userName);//绑定账号

这两行代码，写在BtnLogin和BtnRegister按钮的事件中，当用户登陆，或注册新账号时，我们从Session中获取刚刚的社区授权，然后绑定账号：

//用户登陆，或注册完账号（这时我们可以拿到ID或者username，绑定哪个就看使用哪个方便了，我们添加以下三行代码，
OAuth2.OAuth2Base ob = OAuth2.OAuth2Factory.SessionOAuth;//获取刚刚的授权（授权后存在Session中）
if (ob != null   !string.IsNullOrEmpty(ob.openID))
{
   ob.SetBindAccount(userName);//绑定账号username或id都可以

｝ 

到这里，整个应用就完成了，就是这么简单，除配置项，组件提供的关键的代码只有5行，却实现了相关的功能。

四：总结与下节内容预告

A：看完本文，您应该可以获取到以下信息： 

 

1：知道OAuth授权的界面流程

2：知道怎么实现这个授权流程。

 

B：如果您认真看完本节，或自己实操下，您可能有以下问题想问：

 

1：和网站绑定授权，没看到相关的数据库操作，那获取的token和openid存在哪？

2：如何修改界面，或自定义UI界面？

3：有没有源码？

 

也许，下面这句话给了您答案：下节，将开放源码下载并尝试为您讲解源码中的组件设计思路，敬请关注。

又又又一个小更新，主题插件上线！ 开源 API 管理工具更有意思 近日 Postcat 终于上新了用户期待已久的 12 款【主题插件】！喵喵我啊，想着这下再也没有哪位用户老爷会吐槽 我们 Postcat 的主题过于简洁吧！
SpringCloud微服务实战——搭建企业级开发框架（四十一）：扩展JustAuth+SpringSecurity+Vue实现多租户系统微信扫码、钉钉扫码等第三方登录   如果我们自己的系统需要调用第三方登录，那么我们就需要实现单点登录客户端，然后跟需要对接的平台调试登录SDK。JustAuth是第三方授权登录的工具类库，对接了国外内数十家第三方登录的SDK，我们在需要实现第三方登录时，只需要集成JustAuth工具包，然后配置即可实现第三方登录，省去了需要对接不同SDK的麻烦。   JustAuth官方提供了多种入门指南，集成使用非常方便。但是如果要贴合我们自有开发框架的业务需求，还是需要进行整合优化。下面根据我们的系统需求，从两方面进行整合：一是支持多租户功能，二是和自有系统的用户进行匹配。
SpringCloud微服务实战——搭建企业级开发框架（二十六）：自定义扩展OAuth2实现短信验证码登录 我们系统集成了短信通知服务，这里我们进行OAuth2的扩展，使系统支持短信验证码登录。 1、在gitegg-oauth中新增SmsCaptchaTokenGranter 自定义短信验证码令牌授权处理类 2、自定义GitEggTokenGranter，支持多种token模式
SpringCloud微服务实战——搭建企业级开发框架（二十四）：集成行为验证码和图片验证码实现登录功能 随着近几年技术的发展，人们对于系统安全性和用户体验的要求越来越高，大多数网站系统都逐渐采用行为验证码来代替图片验证码。GitEgg-Cloud集成了开源行为验证码组件和图片验证码，并在系统中添加可配置项来选择具体使用哪种验证码。 • AJ-Captcha：行为验证码 • EasyCaptcha: 图片验证码