第三方App接入微信登陸解讀

準備工做

1.在微信開放平臺https://open.weixin.qq.com/註冊成爲開發者。api

2.在「管理中心」中建立一個移動應用，需「應用名稱、簡介、及28*28和108*108的PNG圖片各一張，且大小不超過300k」,點擊下一步，需「應用官網地址，應用簽名及包名」等信息，而後便可提交審覈。
說明：
應用簽名：可在微信開發平臺的資源中心》》資源下載》》中下載「簽名生成工具」，用戶獲取已經安裝到手機的第三方應用的簽名。輸入應用包名，便可得到該應用的簽名值。服務器

3.提交審覈後，在7個工做日內騰訊將給出審覈結果。（一般較快，幾個小時就可反饋結果）微信

微信登陸接入

微信登陸遵循協議Aouth2.0中的受權碼模式微信開發

咱們來看一下Aouth2.0中的受權碼模式是怎麼定義的：app

受權碼模式（authorization code）是功能最完整、流程最嚴密的受權模式。它的特色就是經過客戶端的後臺服務器，與」服務提供商」的認證服務器進行互動。
它的步驟以下：ide

（A）用戶訪問客戶端，後者將前者導向認證服務器。工具

（B）用戶選擇是否給予客戶端受權。ui

（C）假設用戶給予受權，認證服務器將用戶導向客戶端事先指定的」重定向URI」（redirection URI），同時附上一個受權碼。this

（D）客戶端收到受權碼，附上早先的」重定向URI」，向認證服務器申請令牌。這一步是在客戶端的後臺的服務器上完成的，對用戶不可見。url

（E）認證服務器覈對了受權碼和重定向URI，確認無誤後，向客戶端發送訪問令牌（access token）和更新令牌（refresh token）

微信登陸的官方文檔將微信登陸分爲3個步驟：

第一步.請求code

{
    // send oauth request 
     Final SendAuth.Req req = new SendAuth.Req();
     req.scope = "snsapi_userinfo";
     req.state = "wechat_sdk_demo_test";
     api.sendReq(req);
    }

用這段代碼向微信開放平臺請求受權碼code,可拉起微信並打開受權登陸頁（前提是你安裝了微信應用並已登陸，未登陸的會引導你先登陸），以下圖：

1.若是微信受權頁不顯示，請檢查你的APP簽名是否和你在騰訊開放平臺的APP簽名一致，不一致可修改騰訊開放平臺中的APP簽名，修改後重裝微信或清除微信數據後重試。

2.在你的包名相應目錄下新建一個wxapi目錄，並在該wxapi目錄下新增一個WXEntryActivity類，該類繼承自Activity（例如應用程序的包名爲net.sourceforge，則新的包名爲：net.sourceforge.wxapi）,此處應注意包名不要弄錯，新增類的名字必須爲WXEntryActivity。

返回說明
用戶點擊受權後，微信客戶端會被拉起，跳轉至受權界面，用戶在該界面點擊容許或取消，SDK經過SendAuth的Resp返回數據給調用方。回調WXEntryActivity中的onResp(BaseResp resp)方法，以下：

@Override
    public void onResp(BaseResp resp) {
        int errorCode = resp.errCode;
        switch (errorCode) {
        case BaseResp.ErrCode.ERR_OK:
            //用戶贊成
            String code = ((SendAuth.Resp) resp).code;
            break;
        case BaseResp.ErrCode.ERR_AUTH_DENIED:
            //用戶拒絕
            break;
        case BaseResp.ErrCode.ERR_USER_CANCEL:
            //用戶取消
            break;
        default:
            break;
        }
        ToastUtil.showMessageLong(this, resp.errStr);
    }

客戶端收到受權碼後，向本身的服務器發起登陸請求，並附帶收到的受權碼。

服務端收到登陸請求，向微信開放平臺請求獲取access_token，微信開放平臺返回Json字符串：

第二步：經過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

private String getAccessToken(String code) {
        String url = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code";
        URI uri = URI.create(url);
        HttpClient client = new DefaultHttpClient();
        HttpGet get = new HttpGet(uri);

        HttpResponse response;
        try {
            response = client.execute(get);
            if (response.getStatusLine().getStatusCode() == 200) {
                HttpEntity entity = response.getEntity();

                BufferedReader reader = new BufferedReader(new InputStreamReader(entity.getContent(), "UTF-8"));
                StringBuilder sb = new StringBuilder();

                for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) {
                    sb.append(temp);
                }

                JSONObject object = new JSONObject(sb.toString().trim());
                accessToken = object.getString("access_token");
                openID = object.getString("openid");
                refreshToken = object.getString("refresh_token");
                expires_in = object.getLong("expires_in");
                return accessToken;
            }
        } catch (ClientProtocolException e) {
            // TODO Auto-generated catch block 
            e.printStackTrace();
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (IllegalStateException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (JSONException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }

        return null;
    }

參數說明

參數        是否必須        說明 
appid       是        應用惟一標識，在微信開放平臺提交應用審覈經過後得到

secret      是      應用密鑰AppSecret，在微信開放平臺提交應用審覈經過後得到

code        是       填寫第一步獲取的code參數

grant_type  是      填authorization_code回說明**

正確的返回：

{ 
"access_token":"ACCESS_TOKEN", 
"expires_in":7200, 
"refresh_token":"REFRESH_TOKEN",
"openid":"OPENID", 
"scope":"SCOPE",
"unionid":"o6_bmasdasdsad6_2sgVt7hMZOPfL"
}

參數                              說明
access_token                    接口調用憑證
expires_in  access_token        接口調用憑證超時時間，單位（秒）
refresh_token                   用戶刷新access_token
openid                          受權用戶惟一標識
scope                           用戶受權的做用域，使用逗號（,）分隔
unionid          只有在用戶將公衆號綁定到微信開放平臺賬號後，纔會出現該字段。

服務端收到返回的access_token,將access_token,expires_in,access_token是否有效 等數據返回給客戶端，客戶端成功登陸錯誤返回樣例：
{"errcode":40029,"errmsg":"invalid code"}

客戶端可利用已有的access_token獲取微信用戶信息

第三步：經過access_token調用接口

獲取access_token後，進行接口調用，有如下前提：

access_token有效且未超時；
微信用戶已受權給第三方應用賬號相應接口做用域（scope）。

對於接口做用域（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，從而致使沒法獲取到須要用戶受權才容許得到的數據和基礎功能。

以獲取用戶信息爲例：

private void getUserInfo() {
        if (isAccessTokenIsInvalid() && System.currentTimeMillis() < expires_in) {
            String uri = "https://api.weixin.qq.com/sns/userinfo?access_token=" + accessToken + "&openid=" + openID;
            HttpClient client = new DefaultHttpClient();
            HttpGet get = new HttpGet(URI.create(uri));
            try {
                HttpResponse response = client.execute(get);
                if (response.getStatusLine().getStatusCode() == 200) {
                    BufferedReader reader = new BufferedReader(new InputStreamReader(response.getEntity().getContent(), "UTF-8"));
                    StringBuilder builder = new StringBuilder();
                    for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) {
                        builder.append(temp);
                    }
                    JSONObject object = new JSONObject(builder.toString().trim());
                    String nikeName = object.getString("nickname");
                }
            } catch (ClientProtocolException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            } catch (IOException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            } catch (JSONException e) {
                // TODO Auto-generated catch block
                e.printStackTrace();
            }
        }
    }

微信重複登陸

假設用戶已經得到受權，則下次登陸時只須要驗證access_token是否有效，無效則從新獲取受權，有效則無需從新得到受權。

1.用戶向本身的服務器請求登陸，登陸方式爲微信登陸，附帶上次登陸返回的的access_token

2.服務器收到用戶的登陸請求，向微信開放平臺發送access_token是否有效的驗證請求以下：

返回說明private boolean isAccessTokenIsInvalid() {
        String url = "https://api.weixin.qq.com/sns/auth?access_token=" + accessToken + "&openid=" + openID;
        URI uri = URI.create(url);
        HttpClient client = new DefaultHttpClient();
        HttpGet get = new HttpGet(uri);
        HttpResponse response;
        try {
            response = client.execute(get);
            if (response.getStatusLine().getStatusCode() == 200) {
                HttpEntity entity = response.getEntity();

                BufferedReader reader = new BufferedReader(new InputStreamReader(entity.getContent(), "UTF-8"));
                StringBuilder sb = new StringBuilder();

                for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) {
                    sb.append(temp);
                }
                JSONObject object = new JSONObject(sb.toString().trim());
                int errorCode = object.getInt("errcode");
                if (errorCode == 0) {
                    return true;
                }
            }
        } catch (ClientProtocolException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (JSONException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
        return false;
    }

正確的Json返回結果：
{ 
"errcode":0,"errmsg":"ok"
}
錯誤的Json返回示例:
{ 
"errcode":40003,"errmsg":"invalid openid"
}

若是access_token有效，服務端將信息返回給客戶端，客戶端成功登陸。

若是access_token無效，服務端向微信開放平臺發送刷新access_token的請求以下：

access_token是調用受權關係接口的調用憑證，因爲access_token有效期（目前爲2個小時）較短，當access_token超時後，可使用refresh_token進行刷新，access_token刷新結果有兩種：

1.若access_token已超時，那麼進行refresh_token會獲取一個新的access_token，新的超時時間；
2.若access_token未超時，那麼進行refresh_token不會改變access_token，但超時時間會刷新，至關於續期access_token。

refresh_token擁有較長的有效期（30天），當refresh_token失效的後，須要用戶從新受權。

private void refreshAccessToken() {
        String uri = "https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=" + ShareUtil.APP_ID + "&grant_type=refresh_token&refresh_token="
                + refreshToken;
        HttpClient client = new DefaultHttpClient();
        HttpGet get = new HttpGet(URI.create(uri));
        try {
            HttpResponse response = client.execute(get);
            if (response.getStatusLine().getStatusCode() == 200) {
                BufferedReader reader = new BufferedReader(new InputStreamReader(response.getEntity().getContent(), "UTF-8"));
                StringBuilder builder = new StringBuilder();
                for (String temp = reader.readLine(); temp != null; temp = reader.readLine()) {
                    builder.append(temp);
                }
                JSONObject object = new JSONObject(builder.toString().trim());
                accessToken = object.getString("access_token");
                refreshToken = object.getString("refresh_token");
                openID = object.getString("openid");
                expires_in = object.getLong("expires_in");
            }
        } catch (ClientProtocolException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        } catch (JSONException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

返回說明

正確的返回：
{ 
"access_token":"ACCESS_TOKEN", 
"expires_in":7200, 
"refresh_token":"REFRESH_TOKEN", 
"openid":"OPENID", 
"scope":"SCOPE" 
}
參數                    說明
access_token       接口調用憑證
expires_in        access_token接口調用憑證超時時間，單位（秒）
refresh_token     用戶刷新access_token
openid           受權用戶惟一標識
scope          用戶受權的做用域，使用逗號（,）分隔

錯誤返回樣例：
{
"errcode":40030,"errmsg":"invalid refresh_token"
}