您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 使用技巧 >> iOS 技巧大全

iOS 接入微信授權登錄完整流程

編輯:iOS 技巧大全
[摘要]本文完整講解 iOS 接入微信授權登錄的三個步驟:構造 SendAuthReq 獲取 code、通過 code 換取 access_token 與 openid、再憑 access_token 拉取用戶基本信息,並附 ATS 配置與注意事項。

微信幾乎是移動開發中必接的平台能力,登錄、授權、支付、分享都繞不開它。本文聚焦其中的微信授權登錄。


1、什麼是微信授權

微信 OAuth2.0 授權登錄讓微信用戶可以使用微信身份安全地登錄第三方應用或網站。在用戶授權之後,第三方可以獲取到接口調用憑證(access_token),憑藉它可以調用微信開放平台的授權關系接口,從而獲取用戶的基本開放信息、實現基礎開放功能。


2、授權流程的三個步驟

1. 第三方發起微信授權登錄請求,微信用戶允許授權後,
   微信會拉起應用或重定向到第三方網站,並帶上授權臨時票據 code 參數;

2. 通過 code 加上 AppID 和 AppSecret,調用 API 換取 access_token;

3. 通過 access_token 調用接口,獲取用戶基本數據資源或實現基本操作。

3、準備工作

接入前需要在微信開放平台完成應用註冊與配置,具體步驟直接參考微信官方文檔的 iOS 接入指南即可。

除了文檔中提到的內容,還有幾個地方需要額外注意。

3.1、修改 Info.plist

需要註冊 URL Scheme(用於微信拉起你的 App 時回調)以及白名單 LSApplicationQueriesSchemes(加入 weixin、weixinULAPI 等)。

3.2、App Transport Security 設置

iOS 9 引入了 App Transport Security(ATS)特性,目的是把原本使用 HTTP 的請求都升級到 TLS 1.2 協議傳輸,也就是強制使用 HTTPS。如果服務端暫時無法滿足要求,可以在 Info.plist 中加入一段配置放開限制:

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

這樣就可以允許 HTTP 傳輸了。不過要提醒的是,這是妥協方案,上架審核時蘋果可能會要求說明原因,條件允許的話還是應該把接口全部切換到 HTTPS。


4、第一步:獲取 code

假設界面上有一個按鈕,用戶點擊後發起微信授權。

- (IBAction)sendAuthRequest {
    // 構造 SendAuthReq 結構體
    SendAuthReq *req = [[[SendAuthReq alloc] init] autorelease];
    req.scope = @"snsapi_userinfo";
    req.state = WXPacket_State;
    // state 用於在 OnResp 中判斷是哪個應用發起的授權,
    // 這裡填寫的值會被微信原樣返回

    // 向微信終端發送 SendAuthReq 消息
    [WXApi sendReq:req];
}
4.1、拉起授權頁面

4.2、返回結果說明

參數說明可參考:

其中 scope 有兩個可選值:snsapi_base 表示静默授權,僅能獲取 openid;snsapi_userinfo 表示需要用戶點擊確認,可以獲取頭像、昵稱等更多信息。


5、第二步:用 code 換取 access_token、openid、unionid

拿到 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 傳給自己的後端完成登錄
            }
        });
    });
}
5.1、返回說明

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

5.2、刷新 access_token

access_token 過期後,可用 refresh_token 換取新的:

https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=APPID&grant_type=refresh_token&refresh_token=REFRESH_TOKEN


6、第三步:用 access_token 獲取個人信息

6.1、接口說明

此接口用於獲取用戶個人信息,開發者可通過 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、拉取用戶信息、生成自家會話憑證等一系列操作。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved