微信幾乎是移動開發中必接的平台能力,登錄、授權、支付、分享都繞不開它。本文聚焦其中的微信授權登錄。
微信 OAuth2.0 授權登錄讓微信用戶可以使用微信身份安全地登錄第三方應用或網站。在用戶授權之後,第三方可以獲取到接口調用憑證(access_token),憑藉它可以調用微信開放平台的授權關系接口,從而獲取用戶的基本開放信息、實現基礎開放功能。
1. 第三方發起微信授權登錄請求,微信用戶允許授權後, 微信會拉起應用或重定向到第三方網站,並帶上授權臨時票據 code 參數; 2. 通過 code 加上 AppID 和 AppSecret,調用 API 換取 access_token; 3. 通過 access_token 調用接口,獲取用戶基本數據資源或實現基本操作。
接入前需要在微信開放平台完成應用註冊與配置,具體步驟直接參考微信官方文檔的 iOS 接入指南即可。
除了文檔中提到的內容,還有幾個地方需要額外注意。

需要註冊 URL Scheme(用於微信拉起你的 App 時回調)以及白名單 LSApplicationQueriesSchemes(加入 weixin、weixinULAPI 等)。
iOS 9 引入了 App Transport Security(ATS)特性,目的是把原本使用 HTTP 的請求都升級到 TLS 1.2 協議傳輸,也就是強制使用 HTTPS。如果服務端暫時無法滿足要求,可以在 Info.plist 中加入一段配置放開限制:
<key>NSAppTransportSecurity</key>
<dict>
<key>NSAllowsArbitraryLoads</key>
<true/>
</dict>
這樣就可以允許 HTTP 傳輸了。不過要提醒的是,這是妥協方案,上架審核時蘋果可能會要求說明原因,條件允許的話還是應該把接口全部切換到 HTTPS。
假設界面上有一個按鈕,用戶點擊後發起微信授權。
- (IBAction)sendAuthRequest {
// 構造 SendAuthReq 結構體
SendAuthReq *req = [[[SendAuthReq alloc] init] autorelease];
req.scope = @"snsapi_userinfo";
req.state = WXPacket_State;
// state 用於在 OnResp 中判斷是哪個應用發起的授權,
// 這裡填寫的值會被微信原樣返回
// 向微信終端發送 SendAuthReq 消息
[WXApi sendReq:req];
}


參數說明可參考:
其中 scope 有兩個可選值:snsapi_base 表示静默授權,僅能獲取 openid;snsapi_userinfo 表示需要用戶點擊確認,可以獲取頭像、昵稱等更多信息。
拿到 code 後,請求以下接口:
https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code
用戶在授權頁點擊確認登錄後,微信會調用 AppDelegate 中的 onResp 回調。在那裡即可拿到 code 並發起請求:
// 微信代理回調
- (void)onResp:(BaseResp *)resp {
SendAuthResp *aresp = (SendAuthResp *)resp;
if (aresp.errCode == 0 && [aresp.state isEqualToString:WXPacket_State]) {
NSString *code = aresp.code;
[self getWeiXinOpenId:code];
}
}
// 通過 code 獲取 access_token、openid、unionid
- (void)getWeiXinOpenId:(NSString *)code {
NSString *url = [NSString stringWithFormat:
@"https://api.weixin.qq.com/sns/oauth2/access_token?appid=%@&secret=%@&code=%@&grant_type=authorization_code",
AppId, AppSerect, code];
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
NSURL *zoneUrl = [NSURL URLWithString:url];
NSString *zoneStr = [NSString stringWithContentsOfURL:zoneUrl
encoding:NSUTF8StringEncoding
error:nil];
NSData *data = [zoneStr dataUsingEncoding:NSUTF8StringEncoding];
dispatch_async(dispatch_get_main_queue(), ^{
if (data) {
NSDictionary *dic = [NSJSONSerialization JSONObjectWithData:data
options:NSJSONReadingMutableContainers
error:nil];
NSString *openID = dic[@"openid"];
NSString *unionid = dic[@"unionid"];
// 後續把 openID / unionid 傳給自己的後端完成登錄
}
});
});
}

要點:access_token 有效期僅 2 小時,refresh_token 有效期 30 天。因此不能把 access_token 長期存到本地,正確做法是把 code 傳給自己的後端,由後端保管這些敏感憑證。

access_token 過期後,可用 refresh_token 換取新的:
https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN

此接口用於獲取用戶個人信息,開發者可通過 OpenID 來獲取用戶基本信息。
特別需要注意的是:如果開發者擁有多個移動應用、網站應用和公眾號,可通過 unionid 來區分用戶的唯一性。只要是同一個微信開放平台賬號下的移動應用、網站應用和公眾號,用戶的 unionid 是唯一的。也就是說,同一用戶對同一開放平台下的不同應用,unionid 相同。
另外要註意:在用戶修改微信頭像後,舊的頭像 URL 將會失效。因此開發者在獲取用戶信息後,應該自己把頭像圖片保存下來,避免 URL 失效導致的異常。
HTTP 方法:GET
請求地址:https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID

1、https://www.jianshu.com/p/0c3df308bcb3
2、微信開放平台文檔:https://open.weixin.qq.com/cgi-bin/showdocument?action=doc&id=open1419317851
3、https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=open1419317853&lang=zh_CN
4、https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=1417694084&lang=zh_CN
實踐中強烈建議不要把 AppSecret 放在客戶端。上述示例為了展示完整流程把請求寫在了 App 端,但 AppSecret 一旦被打包進 ipa 就等同於公開,攻擊者可以反編譯提取後冒充你的應用調用微信接口。正確架構是:客戶端只負責拿到 code 並上傳給自有後端,由後端完成 code 換 token、拉取用戶信息、生成自家會話憑證等一系列操作。