DIV CSS 佈局教程網

掃碼登入是怎麼運作的?從微信網頁版 JS 看二維碼授權流程
編輯:關於JavaScript     

二維碼登入的基本概念

二維碼本質上就是「存了二進位資料的黑白圖片」。掃碼登入的流程是:伺服器產生一組臨時且唯一的識別碼(uuid),前端把它渲染成二維碼圖片顯示在頁面;手機掃描後確認授權,網頁端則是不停地問伺服器「被授權了嗎?」,直到收到成功回應或逾時作廢。

整個授權流程可以概括成下圖:

關鍵:長輪詢(long polling)

網頁端會持續向伺服器送出 HTTPS 請求,傳輸的資料量極小,收到回應後立刻斷開再重送。微信網頁版的 login.js 把這件事拆成兩個函式:_getUUID() 取得識別碼,_poll() 負責輪詢狀態。

第一步:取得 uuid 並載入二維碼

function _loadQRImg(uuid) {
  _poll(uuid);
  _oLoginQrCodeImg.src = "https://login." + _sBaseHost + "/qrcode/" + uuid + "?t=webwx";

  // 看門狗:每 5 秒檢查圖片是否還在,最多重試 5 次
  loadQRImgWatchDog = setInterval(function(){
    if (reLoadQRImgCount >= 5) { _reset(); return; }
    reLoadQRImgCount++;
    var _img = new Image();
    _img.onload = function(){ _oLoginQrCodeImg.src = this.src; };
    _img.src = _oLoginQrCodeImg.src + "&r=" + new Date().getTime();
  }, 5000);
}

這段有兩個值得學的細節:用 &r=時間戳 讓 src 每次都不同,避免瀏覽器快取到舊圖;另外用 setInterval 當「看門狗」,若圖片一直載不進來就重新抓,超過次數則整頁重載。

第二步:輪詢授權狀態

function _poll(_asUUID) {
  var _self = arguments.callee;
  $.ajax({
    type: "GET",
    url: "https://login." + _sBaseHost + "/cgi-bin/mmwebwx-bin/login?uuid=" + _asUUID + "&tip=" + show_tip,
    dataType: "script",
    cache: false,
    timeout: 100 * 1000,
    success: function(data, textStatus, jqXHR) {
      switch (window.code) {
        case 200:   // 已授權,接著換取真正的登入憑證
          var _fNewLoginFunc = function(){
            $.ajax({
              url: _aoWin.redirect_uri + "&fun=new",
              type: "GET",
              success: function(msg) {
                var code = msg.match(/<script>(.*)<\/script>/);
                if (code) { eval(code[1]); }
              }
            });
          };
          _fNewLoginFunc();
          break;

        case 201:   // 已掃描,等待手機端確認
          show_tip = 0;
          $('.successMsg').show();
          _self(_asUUID);        // 繼續輪詢
          break;

        case 408:   // 尚未掃描,500ms 後再問
          setTimeout(function(){ _self(_asUUID); }, 500);
          break;

        case 400:
        case 500:   // uuid 失效或伺服器異常,重載
          _reset();
          break;
      }
    },
    error: function(jqXHR, textStatus){
      setTimeout(function(){ _self(_asUUID); }, textStatus == 'timeout' ? 500 : 5000);
    }
  });
}

狀態碼就是整個流程的心臟:408 代表還沒人掃,201 代表掃了但等手機確認,200 代表授權完成可以換取憑證,400/500 則要作廢重來。 timeout 設為 100 秒是刻意的——這其實是長輪詢,伺服器會把請求掛住直到狀態改變或逾時,比短間隔輪詢省資源。

第三步:uuid 過期要自動重取

_oResetTimeout = setTimeout(function(){
  location.reload();   // 5 分鐘後重載,注意別用 _reset(),否則可能產生多個 _poll 併行
}, 5 * 60 * 1000);

作者特別在註解裡標明:這裡要用 location.reload() 而非 _reset(),因為直接重啟輪詢會讓多個 _poll 同時跑(它們都收到 408 後各自重排下一輪),造成請求堆積。這是很典型的「重試要收斂」問題。

值得注意的地方

  • 二維碼必須有時效,範例用 5 分鐘,過期後重新整理取得新的 uuid。
  • arguments.callee 遞迴呼叫在嚴格模式下已被禁用,現代寫法應改用具名函式表達式。
  • 程式碼中的 eval(code[1]) 是舊時代做法,服務端回傳可執行腳本本身就是風險點,如今應改為回傳 JSON 再由前端處理。
  • 從流程可以看出,掃碼登入的本質是「把已登入裝置當成授權碼產生器」,網頁端全程不接觸帳密,這也是它比帳號密碼登入安全的原因。

理解這套流程後,不難看懂近年各種「用手機 App 授權電腦端」的設計——它們骨架幾乎一致,差別只在狀態碼定義與輪詢間隔。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved