在現今很多網站裡面,都使用了微信開放平臺的掃碼登錄認證處理,這樣做相當於把身份認證交給較為權威的第三方進行認證,在應用網站裡面可以不需要存儲用戶的密碼了。本篇介紹如何基於微信開放平臺的掃碼進行網站的登陸處理。 ...
在現今很多網站裡面,都使用了微信開放平臺的掃碼登錄認證處理,這樣做相當於把身份認證交給較為權威的第三方進行認證,在應用網站裡面可以不需要存儲用戶的密碼了。本篇介紹如何基於微信開放平臺的掃碼進行網站的登陸處理。
1、開放平臺的認證
要使用網站的掃碼登錄處理,就需要先進行微信開放平臺帳號的開發者資質認證,提交相關的資料,以及交付每年300元的認證費用。
認證後,建立相關的網站應用後,就有相關的APPID和APPSecret了,這些關鍵的參數就可以用來獲取相關的用戶信息了。
網站應用的應用詳情界面如下所示。
整個開放平臺感覺沒有多少東西,不過需要收費認證才能使用這些功能,感覺不是很爽。
2、掃碼登錄的說明和具體使用
網站應用微信登錄是基於OAuth2.0協議標準構建的微信OAuth2.0授權登錄系統。
在進行微信OAuth2.在進行微信OAuth2.0授權登錄接入之前,在微信開放平臺註冊開發者帳號,並擁有一個已審核通過的網站應用,並獲得相應的AppID和AppSecret,申請微信登錄且通過審核後,可開始接入流程。
微信OAuth2.0授權登錄讓微信用戶使用微信身份安全登錄第三方應用或網站,在微信用戶授權登錄已接入微信OAuth2.0的第三方應用後,第三方可以獲取到用戶的介面調用憑證(access_token),通過access_token可以進行微信開放平臺授權關係介面調用,從而可實現獲取微信用戶基本開放信息和幫助用戶實現基礎開放功能等。
微信OAuth2.0授權登錄目前支持authorization_code模式,適用於擁有server端的應用授權。該模式整體流程為:
1. 第三方發起微信授權登錄請求,微信用戶允許授權第三方應用後,微信會拉起應用或重定向到第三方網站,並且帶上授權臨時票據code參數; 2. 通過code參數加上AppID和AppSecret等,通過API換取access_token; 3. 通過access_token進行介面調用,獲取用戶基本數據資源或幫助用戶實現基本操作。
獲取access_token時序圖:
從上圖我們可以大概瞭解整個掃碼登陸的處理過程。
3、掃碼登錄的各個步驟處理
1)用戶身份的綁定
為了實現二維碼掃碼登錄,我們需要在現有系統裡面綁定用戶的微信,這樣才能在用戶掃碼的時候,判斷用戶的身份從而實現自動登錄的過程。
我們可以在用戶管理裡面進行統一設置,也可以在常規用戶登錄(用戶名+密碼)後進行設置,這個主要看我們是否需要保留用戶名密碼登陸這種方式。
例如可以在用戶管理裡面統一綁定,也就是在創建用戶的時候,讓用戶綁定下微信,獲取微信的唯一標識。
也可以在保留用戶名密碼的登陸方式外,讓用戶登陸系統後自行進行綁定微信即可。
上面的界面,就是在一個頁面裡面彈出一個層,然後請求二維碼顯示即可,如下界面代碼所示。
<div id="divWechat" class="easyui-dialog" style="width:450px;height:350px;padding:10px 20px" closed="true" resizable="true" modal="true" iconcls="icon-setting"> <div> <h4>掃描用戶二維碼,進行綁定</h4> </div> <div align="center"> <img id="imgQRcode" alt="使用微信掃碼進行綁定" style="height:200px;width:auto" /> </div> <div align="right"> <a href="javascript:void(0)" class="easyui-linkbutton" iconcls="icon-cancel" onclick="javascript: $('#divWechat').dialog('close')">關閉</a> </div> </div>
上面的層在打開的時候,我們使用JS來動態獲取二維碼進行顯示,具體JS代碼如下所示。
//綁定微信登陸 function BindWechat() { var url = "http://www.iqidi.com/H5/BindWechat?id=@Session["UserID"]"; url = encodeURIComponent(url); $("#imgQRcode").attr("src", "/H5/QR?url=" + url); //打開綁定視窗 $("#divWechat").dialog('open').dialog('setTitle', '使用微信掃碼進行綁定'); }
上面的JS只是做前端的數據請求和顯示,具體的QR動作Action其實就是生成掃描二維碼的過程,這個二維碼其實就是採用通用的方式,來構建一個指向我們綁定賬號的地址,從而實現我們綁定賬號的判斷,二維碼的生成過程如下所示。
/// <summary> /// 轉換二維碼連接為圖片格式 /// </summary> /// <param name="url">二維碼連接</param> /// <returns></returns> [HttpGet] public ActionResult QR(string url) { //初始化二維碼生成工具 QRCodeEncoder qrCodeEncoder = new QRCodeEncoder(); qrCodeEncoder.QRCodeEncodeMode = QRCodeEncoder.ENCODE_MODE.BYTE; qrCodeEncoder.QRCodeErrorCorrect = QRCodeEncoder.ERROR_CORRECTION.M; qrCodeEncoder.QRCodeVersion = 0; qrCodeEncoder.QRCodeScale = 4; //將字元串生成二維碼圖片 var image = qrCodeEncoder.Encode(url, Encoding.Default); //保存為PNG到記憶體流 MemoryStream ms = new MemoryStream(); image.Save(ms, ImageFormat.Png); image.Dispose(); return File(ms.ToArray(), "image/Png"); }
為了實現用戶的綁定,我們需要獲取當前用戶的身份信息,因此需要在BindWeChat的操作裡面做一個轉向處理,如下介面所示。
/// <summary> /// 生成綁定微信的地址 /// </summary> /// <returns></returns> public ActionResult BindWechat()
這個函數處理裡面,我們需要重新定向處理,我們把它定向到BindAccount函數裡面,方便獲取用戶的openid和其他必要的信息。
另外我們基於微信開放平臺的應用,建立了一個和微信賬號信息的聯繫,因此創建資料庫信息如下所示。
也就是一個具體的開放平臺應用對應著一個具體的微信賬號,這樣我們就可以充分利用配置進行處理了。
上面提到的BindAccount的處理的邏輯就是獲取必要的信息,然後在資料庫層面對身份信息進行驗證,具體代碼如下所示。
/// <summary> /// 綁定用戶微信號 /// </summary> /// <param name="id">賬號ID</param> /// <returns></returns> public ActionResult BindAccount() { WebAppInfo appInfo = GetWebApp(ConfigData.WebAppId); AccountInfo accountInfo = GetAccount(appInfo.AccountNo); var htResult = GetOpenIdAndUnionId(accountInfo.UniteAppId, accountInfo.UniteAppSecret);//存儲openid方便使用 string openid = htResult["openid"].ToString(); var unionid = htResult["unionid"].ToString(); var userid = Request.QueryString["id"]; var state = Request.QueryString["state"]; if (!string.IsNullOrEmpty(openid) && !string.IsNullOrEmpty(userid)) { CommonResult result = BLLFactory<User>.Instance.BindUser(openid, unionid, userid.ToInt32()); if (result.Success) { return BindSuccess(); } else { return BindFail(); } } else { throw new WeixinException("無法獲取openid" + string.Format(", openid:{0}, userid:{1}", openid, userid)); } }
在綁定的過程,我們需要考慮綁定正確賬號,重覆綁定其他賬號,無效綁定幾種情況,如果成功綁定正確賬號(可多次處理結果一樣),那麼得到界面如下所示(這個界面的樣式採用了weui的樣式)。
2)用戶的掃碼登錄處理
上面綁定了賬號後,就可以通過掃碼進行登錄了,掃碼回調的時候我們有自己的判斷處理,掃碼界面如下所示(我們在保留用戶名密碼登陸的方式外,增加了一個掃碼登錄的處理)。
如果是Bootstrap的界面效果
如果是EasyUI的界面效果
這個和前面的二維碼顯示規則差不多,不過他們的連接地址是不同的,這個地方用到了開放平臺的介面,也就是我們前面提到開放平臺認證的介面了。
上面的掃碼登錄的界面代碼如下所示。
<!--二維碼掃描登陸的界面層--> <div id="divWechat" class="easyui-dialog" style="width:550px;height:500px;padding:10px 20px" closed="true" resizable="true" modal="true" iconcls="icon-setting"> <div id="login_container" align="center"> </div> <div align="right"> <a href="javascript:void(0)" class="easyui-linkbutton" iconcls="icon-cancel" onclick="javascript: $('#divWechat').dialog('close')">關閉</a> </div> </div>
上面代碼需要引入JS文件,並使用微信JSSDK的API進行顯示的。
<!--使用微信掃碼進行登陸--> <script src="http://res.wx.qq.com/connect/zh_CN/htmledition/js/wxLogin.js"></script> <script language="javascript"> function OpenJSLogin() { var obj = new WxLogin({ id: "login_container", appid: "@ViewBag.appid", scope: "snsapi_login", redirect_uri: "@ViewBag.redirect_uri", state: "@ViewBag.state", style: "black", href: ".impowerBox .qrcode {width: 200px;}" }); //打開綁定視窗 $("#divWechat").dialog('open').dialog('setTitle', '使用微信掃碼進行登陸'); } </script>
這個裡面的參數,如APPID就是來源我們認證後的開放平臺參數。
這些信息我們在MVC控制器後面獲取後綁定在ViewBag,方便界面前端的使用。
//使用JSLogin登陸 WebAppInfo appInfo = BLLFactory<WebApp>.Instance.FindByID(ConfigData.WebAppId); ArgumentValidation.CheckForNullReference(appInfo, "Web應用程式appInfo"); if (appInfo != null) { ViewBag.appid = appInfo.OpenAppID; ViewBag.redirect_uri = appInfo.LoginCallBackUrl; ViewBag.state = ConfigData.AuthState; }
其中的redirect_uri是通過資料庫獲取的LoginCallBackUrl地址,這個地址類似如下格式:http://www.iqidi.com/H5/callback?uid=iqidiSoftware
也就是我們在開放平臺處理返回後進行的回調處理。
通過開放平臺的APPID和APPSecret,我們可以獲取到對應的介面調用憑證,然後根據介面憑證,以及openid,獲得用戶的公眾平臺統一的UnionID,這個標識是我們用戶的唯一標識,代碼如下所示。
var result = baseApi.GetAuthToken(appid, appsecret, code); if (result != null && !string.IsNullOrEmpty(result.openid)) { openid = result.openid; var unionResult = baseApi.GetSnsapiUserInfo(result.access_token, result.openid); ht.Add("openid", openid); ht.Add("unionid", unionResult != null ? unionResult.unionid : ""); }
有了unionid我們就可以根據這個標識在我們的用戶資料庫裡面查找對應的用戶,如下代碼所示。
//開放平臺的OpenID,不是公眾號的OpenID,需要轉換為unionid if (!string.IsNullOrEmpty(openid) && !string.IsNullOrEmpty(unionid)) { UserInfo userInfo = BLLFactory<User>.Instance.FindByUnionId(unionid);
然後判斷我們去到的用戶信息是否正確,如下代碼所示
if (userInfo != null) { CommonResult loginResult = CheckLogin(userInfo.Name); if (!loginResult.Success) { LogHelper.Info(string.Format("用戶登陸不成功,{0}", loginResult.ErrorMessage)); } //登陸成功後的重定向地址 var url = appInfo.HomeUrl; //例如:http://www.iqidi.com/Home return Redirect(url); }
如果不成功,那麼我們定向到指定的界面即可。
//如不成功,最後都統一提示信息 ViewBag.Error = "獲取信息失敗,登陸錯誤"; return View("LoginError");
如果我們登陸成功後,需要設置一些Session信息或者Cookie信息,那麼就可以通過CheckLogin函數進行處理即可。
以上就是我們結合微信開放平臺實現微信掃碼登錄的過程,其中整個過程就是用到了下麵幾個過程。
1)使用JSSDK的腳本實現掃碼獲取code
JS微信登錄主要用途:網站希望用戶在網站內就能完成登錄,無需跳轉到微信域下登錄後再返回,提升微信登錄的流暢性與成功率。 網站內嵌二維碼微信登錄JS實現辦法:
步驟1:在頁面中先引入如下JS文件(支持https):
<script src="http://res.wx.qq.com/connect/zh_CN/htmledition/js/wxLogin.js"></script>
步驟2:在需要使用微信登錄的地方實例以下JS對象:
var obj = new WxLogin({ id:"login_container", appid: "", scope: "", redirect_uri: "", state: "", style: "", href: "" });
2) 第二步:通過code獲取access_token
通過code獲取access_token
https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
3)第三步:通過access_token調用介面
獲取access_token後,進行介面調用,
對於介面作用域(scope),能調用的介面有以下:
授權作用域(scope) | 介面 | 介面說明 |
---|---|---|
snsapi_base | /sns/oauth2/access_token | 通過code換取access_token、refresh_token和已授權scope |
/sns/oauth2/refresh_token | 刷新或續期access_token使用 | |
/sns/auth | 檢查access_token有效性 | |
snsapi_userinfo | /sns/userinfo | 獲取用戶個人信息 |
其中snsapi_base屬於基礎介面,若應用已擁有其它scope許可權,則預設擁有snsapi_base的許可權。使用snsapi_base可以讓移動端網頁授權繞過跳轉授權登錄頁請求用戶授權的動作,直接跳轉第三方網頁帶上授權臨時票據(code),但會使得用戶已授權作用域(scope)僅為snsapi_base,從而導致無法獲取到需要用戶授權才允許獲得的數據和基礎功能。
4)獲取信息在回調界面中進行登錄前處理
通過上面介面,我們可以獲得相應的用戶身份信息,因此可以結合我們用戶資料庫進行用戶身份的認定和處理,並設置必要的Session或者Cookie信息等,最後定位到我們的應用主界面即可。