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

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

本节包括以下内容:

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

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

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

4 :总结与下节内容预告

 

 

一: 第三方社区账号登陆的授权流程

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

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

2:用户点击用新浪微博或QQ登陆,系统跳到第三方授权页面,(QQ示例授权界面)

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

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

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

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

connect_UI_5.png  

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

 

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

 

1:下载OAuth2.dll组件,下载: OAuth2.rar(download times)

2:引用该dll到您的网站项目中;

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

 

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

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

接下来,我们要在登陆界面(示如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(); 

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

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

 

用户点击第三方授权,跳到第三方授权页面,操作完回调还会返回到这个登陆界面,只是多了两个参数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 // 读取授权失败。
{
     //提示用户重试,或改用其它社区方法登陆。
}

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

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

 

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:有没有源码?

 

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

 

51cto大赛的参赛页面,感谢路过的朋友也顺手扔一票:http://blog.51cto.com/contest2012/2127378   

 

你可能感兴趣的:(通用社区登陆组件技术分享(开源)中篇:OAuth 登陆组件流程及组件集成方法)