thinkjs微信中控之微信鑒權(quán)登陸的實(shí)現(xiàn)代碼
前言
上一篇文章大概寫了一下如何搭一個(gè)微信中控服務(wù): 【thinkjs搭建微信中控服務(wù)】 。
接下來這篇,專門寫一下如何在此基礎(chǔ)上擴(kuò)展出來一個(gè)比較好用的微信鑒權(quán)登陸的方案。
由于這一段的邏輯著實(shí)有點(diǎn)繞,所以就單獨(dú)拿出來寫了。
有時(shí)候,調(diào)用方甚至可以通過這個(gè)方案,進(jìn)行多公眾號(hào)openid的之間的關(guān)聯(lián)。
官方說明
開發(fā)文檔
微信文檔地址:傳送門
鑒權(quán)邏輯
- 前端跳轉(zhuǎn)到以下url,重定向或者代碼跳轉(zhuǎn)都可以:https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
- 彈出是否同意授權(quán)的框,用戶同意授權(quán)(如果是靜默授權(quán),就不會(huì)彈出同意框),然后頁面會(huì)重定向到上面鏈接的redirect_uri地址(一般是開發(fā)者處理下一步鑒權(quán)邏輯的服務(wù)端API),并且會(huì)帶上code參數(shù)。
- 服務(wù)端拿到code之后,調(diào)用以下api來獲取網(wǎng)頁授權(quán)的access_token和用戶的openid:https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
拿到openid之后,理論上鑒權(quán)的邏輯就算完成了。
開發(fā)者可以繼續(xù)用openid和access_token去獲取用戶信息;或者進(jìn)行一些其他的業(yè)務(wù)流程。
具體的參數(shù)說明看微信的官方文檔就可以了。
中控邏輯
第一步:頁面跳轉(zhuǎn)至中控API
業(yè)務(wù)調(diào)用方會(huì)有自己的登陸邏輯,只需要獲取到當(dāng)前調(diào)用接口的用戶的openid,然后再進(jìn)行接下來的業(yè)務(wù)邏輯即可。
前端調(diào)用業(yè)務(wù)接口的時(shí)候,如果服務(wù)端發(fā)現(xiàn)當(dāng)前訪問用戶沒有登陸狀態(tài),就會(huì)告訴前端需要鑒權(quán),并且把需要跳轉(zhuǎn)的中控API鏈接響應(yīng)給前端。
然后前端就開始往中控的API鏈接跳轉(zhuǎn)。
第二步:中控重定向到微信API
相關(guān)代碼
// 接口 - 鑒權(quán)獲取code async go_authAction() { let that = this; let {back, serve = ''} = that.get(); if (think.isEmpty(back)) { return that.json({code: 1, msg: '參數(shù)不正確'}) } let newBack = encodeURIComponent(back); let redirectUri = `${baseHost}/api/open/wx/login_wechat?${encodeURIComponent(`back=${newBack}&wxid=${that.wxConfig.id}&serve=${serve}`)}`; let url = `https://open.weixin.qq.com/connect/oauth2/authorize?appid=${that.wxConfig.appid}&redirect_uri=${redirectUri}&response_type=code&scope=snsapi_base&state=STATE#wechat_redirect` that.redirect(url); }
作用:
鑒權(quán)獲取code
地址:
baseHost + /open/wx/go_auth
參數(shù):
參數(shù)名 | 必選 | 說明 |
---|---|---|
wxid | 是 | 對應(yīng)配置公眾號(hào)的id,告訴中控用哪個(gè)公眾號(hào)鑒權(quán) |
back | 是 | 跳轉(zhuǎn)到鑒權(quán)鏈接之前的頁面完整url,便于鑒權(quán)完畢后重定向回之前頁面 |
serve | 是 | 調(diào)用方api回調(diào)地址,在鑒權(quán)邏輯完成后,會(huì)攜帶openid重定向回這個(gè)地址 |
描述:
我這里默認(rèn)都是靜默授權(quán)。
在這里可以看到代碼里面,中控把調(diào)用方傳過來的 wxid , back 和 serve 三個(gè)參數(shù)拼接到了微信API的回調(diào)鏈接 redirect_uri 里面。
第三步:微信回調(diào)中控API
相關(guān)代碼
async login_wechatAction() { let that = this; let {code, back, serve = ''} = that.get(); if (think.isEmpty(code) || think.isEmpty(back)) { return that.json({code: 1, msg: '參數(shù)不正確'}) } let newBack = encodeURIComponent(back); let apiWxController = that.controller('private/wx'); let openid = await that._getOpenIdByAuthCode(that.wxConfig.id, code); let backUrl = `${serve}?wxid=${that.wxConfig.id}&openid=${openid}&redirect=${newBack}`; that.redirect(backUrl); } _getOpenIdByAuthCode(wxid, code){ let that = this; let {appid, secret} = await that.controller('common').getWxConfigById(wxid); let {data} = await axios({ method: 'get', url: `https://api.weixin.qq.com/sns/oauth2/access_token?appid=${appid}&secret=${secret}&code=$[code]&grant_type=authorization_code` }) return data.openid }
作用:
通過微信回調(diào)傳回來的code,獲取openid
地址:
baseHost + /open/wx/login_wechat
參數(shù):
參數(shù)名 | 必選 | 說明 |
---|---|---|
wxid | 是 | 對應(yīng)配置公眾號(hào)的id,告訴中控用哪個(gè)公眾號(hào)鑒權(quán) |
code | 是 | 微信回傳的code |
back | 是 | 跳轉(zhuǎn)到鑒權(quán)鏈接之前的頁面完整url,便于鑒權(quán)完畢后重定向回之前頁面(上一步拼接的) |
serve | 是 | 調(diào)用方api回調(diào)地址,在鑒權(quán)邏輯完成后,會(huì)攜帶openid重定向回這個(gè)地址(上一步拼接的) |
描述:
這里中控拿到code之后,去獲取openid。 獲取完之后,重定向回 serve (業(yè)務(wù)系統(tǒng))地址,并把獲取到的 openid 和 back 作為參數(shù)傳回去
第四步:業(yè)務(wù)系統(tǒng)自行處理
接下來業(yè)務(wù)系統(tǒng)就能通過開放的回調(diào)地址(上面的 serve ),來拿到以下信息:
- openid (微信ID),
- redirect (上面的 back ,最初用戶在前端調(diào)用接口的頁面地址)
這時(shí)候就能用這個(gè)openid去處理自己的登陸邏輯,比如獲取用戶信息,緩存session保存登陸狀態(tài)之類的。
然后再重定向回 back 地址,也就是用戶在鑒權(quán)之前訪問的頁面。
鑒權(quán)結(jié)束
簡單說就是以下邏輯
- 前端 調(diào)用 業(yè)務(wù)接口 發(fā)現(xiàn)沒有登陸狀態(tài),告訴前端往中控跳!
- 前端 跳轉(zhuǎn)至 中控API 拼接接下來要回調(diào)的參數(shù)
- 中控 重定向至 微信API 獲取code
- 微信 重定向至 中控API 獲取openid
- 中控 重定向回 業(yè)務(wù)回調(diào)API 拿到openid,保存用戶登陸狀態(tài)
- 業(yè)務(wù) 重定向回 前端
- 前端 調(diào)用 業(yè)務(wù)接口 發(fā)現(xiàn)有登陸狀態(tài)了,完事兒
雖然歷經(jīng)的跳轉(zhuǎn)和重定向看起來很多,但是實(shí)際用起來,其實(shí)是很快的,用戶基本上沒有什么感知。
而且對于業(yè)務(wù)調(diào)用方來說,只需要提供一個(gè)回調(diào)地址即可,然后在回調(diào)里面等著openid傳過來就好,剩下的交給中控自己去來回蹦噠吧。
結(jié)尾
需要注意的是,公眾號(hào)的后臺(tái)需要配置好以下信息。
- JS接口安全域名:就是前端的訪問域名。
- 網(wǎng)頁授權(quán)域名:中控API域名。
- ip白名單:中控的ip地址。
否則是沒有權(quán)限鑒權(quán)的。
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
詳解用Webpack與Babel配置ES6開發(fā)環(huán)境
這篇文章主要介紹了詳解用Webpack與Babel配置ES6開發(fā)環(huán)境,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-03-03顏色選擇器 Color Picker,IE,Firefox,Opera,Safar
顏色選擇器 Color Picker,需要的朋友可以參考下。2010-11-11JS庫particles.js創(chuàng)建超炫背景粒子插件(附源碼下載)
particles.js用于創(chuàng)建粒子的輕量級(jí) JavaScript 庫。使用方法非常簡單,代碼也很容易實(shí)現(xiàn),下面通過本文給大家分享JS庫particles.js創(chuàng)建超炫背景粒子插件附源碼下載,需要的朋友參考下吧2017-09-09