您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 微信第三方登錄完整實現:從 SDK 接入到 UnionID 用戶體系

編輯:iOS 開發綜合

「用微信登錄」幾乎成了國內 App 的標配。它背後走的是 OAuth 2.0 授權流程,但真正落地時,卡住開發者的往往不是協議本身,而是配置、ATS、token 續期這些工程細節。本文按接入順序把整個過程走一遍。

一、接入前的準備

移動應用微信登錄建立在 OAuth 2.0 標準之上。正式動工前需要完成三件事:在微信開放平台註冊開發者帳號、讓你的移動應用通過審核、拿到對應的 AppID 與 AppSecret,並單獨申請「微信登錄」能力。這一步沒走完,後面寫什麼都是白費。

1. 下載並導入 SDK

從微信開放平台下載 iOS 版 SDK。

把 SDK 放到工程目錄中,建議單獨建一個文件夾管理。

2. 補齊依賴庫

SDK 依賴一批系統框架,逐一加入即可。

3. 配置 URL Types

微信回跳靠 URL Scheme 完成,這裡要填寫你在開放平台註冊時的 AppID。

4. 聲明 iOS 9 的 URL Schemes 白名單

這一步最容易被跳過,跳過之後運行時就會看到:

-canOpenURL: failed for URL: "weixin://app/wx9**********dfd30/"
- error: "This app is not allowed to query for scheme weixin"

5. 處理 App Transport Security

iOS 9 引入 ATS,預設要求所有網路請求走 TLS 1.2 以上。需要在 Info.plist 中顯式聲明例外:

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

若不做這項配置,直接發起 HTTP 請求會被系統攔截:

App Transport Security has blocked a cleartext HTTP (https://) resource load
since it is insecure. Temporary exceptions can be configured via your app's
Info.plist file.

二、向微信註冊你的 App 並接收回跳

在 AppDelegate.m 引入 WXApi.h,完成兩件事:啟動時註冊 App,以及攔截從微信返回的 URL。

#import "AppDelegate.h"
#import "LoginViewController.h"
#import "WXApi.h"

- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
    [WXApi registerApp:@"wxd1931d4a0e46****" withDescription:@"Wechat"];
    return YES;
}

// 從微信返回第三方 App
- (BOOL)application:(UIApplication *)application
            handleOpenURL:(NSURL *)url
{
    [WXApi handleOpenURL:url delegate:self];
    return YES;
}

三、發起授權,拿回臨時 code

SDK 接入正確並取得相應 scope 權限後,App 會在本地喚起微信完成授權;用戶確認,微信再帶著一次性 code 跳回你的 App。

這裡有個審核相關的硬性要求:微信登錄是用戶必須先安裝微信才能用。因此點擊前應先用 isWXAppInstalled 判斷,未安裝就把入口藏起來,只留其他登錄方式。

- (IBAction)wechatLoginClick:(id)sender
{
    if ([WXApi isWXAppInstalled]) {
        SendAuthReq *req = [[SendAuthReq alloc] init];
        req.scope = @"snsapi_userinfo";
        req.state = @"App";
        [WXApi sendReq:req];
    } else {
        [self setupAlertController];
    }
}

- (void)setupAlertController
{
    UIAlertController *alert = [UIAlertController
        alertControllerWithTitle:@"溫馨提示"
                         message:@"請先安裝微信客戶端"
                  preferredStyle:UIAlertControllerStyleAlert];
    [alert addAction:[UIAlertAction actionWithTitle:@"確定"
                                             style:UIAlertActionStyleDefault
                                           handler:nil]];
    [self presentViewController:alert animated:YES completion:nil];
}

四、token 續期:別讓用戶重複授權

access_token 只有 2 小時壽命,refresh_token 則有 30 天。合理的策略是:本地存下 token,下次進來先用 refresh_token 換新的,換不到才走完整授權。

- (IBAction)wechatLoginClick:(id)sender
{
    NSString *accessToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_ACCESS_TOKEN];
    NSString *openID      = [[NSUserDefaults standardUserDefaults] objectForKey:WX_OPEN_ID];

    if (accessToken && openID) {
        AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
        NSString *refreshToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_REFRESH_TOKEN];
        NSString *refreshUrlStr = [NSString stringWithFormat:
            @"%@/oauth2/refresh_token?appid=%@&grant_type=refresh_token&refresh_token=%@",
            WX_BASE_URL, WXPatient_App_ID, refreshToken];

        [manager GET:refreshUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
            NSDictionary *refreshDict = [NSDictionary dictionaryWithDictionary:responseObject];
            NSString *reAccessToken = [refreshDict objectForKey:WX_ACCESS_TOKEN];

            if (reAccessToken) {
                // 續期成功,更新本地三件套
                [[NSUserDefaults standardUserDefaults] setObject:reAccessToken forKey:WX_ACCESS_TOKEN];
                [[NSUserDefaults standardUserDefaults] setObject:[refreshDict objectForKey:WX_OPEN_ID] forKey:WX_OPEN_ID];
                [[NSUserDefaults standardUserDefaults] setObject:[refreshDict objectForKey:WX_REFRESH_TOKEN] forKey:WX_REFRESH_TOKEN];
                [[NSUserDefaults standardUserDefaults] synchronize];

                !self.requestForUserInfoBlock ?: self.requestForUserInfoBlock();
            } else {
                [self wechatLogin];   // 連 refresh_token 也過期了
            }
        } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
            NSLog(@"刷新 accessToken 出錯 = %@", error);
        }];
    } else {
        [self wechatLogin];
    }
}

refresh_token 的兩種行為值得記住:

  • access_token 已過期:換回一組全新的 access_token 與新的有效時間。
  • access_token 未過期:access_token 本身不變,但有效期被刷新,等同續期。

五、接收授權結果

讓 AppDelegate 遵守 <WXApiDelegate> 並實作 onResp:,在這裡接住 code。

- (void)onResp:(BaseResp *)resp
{
    if ([resp isKindOfClass:[SendAuthResp class]]) {
        SendAuthResp *temp = (SendAuthResp *)resp;

        // ErrCode == 0 表示用戶同意,此時 code 才有效
        AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
        NSString *accessUrlStr = [NSString stringWithFormat:
            @"%@/oauth2/access_token?appid=%@&secret=%@&code=%@&grant_type=authorization_code",
            WX_BASE_URL, WXPatient_App_ID, WXPatient_App_Secret, temp.code];

        [manager GET:accessUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
            NSDictionary *accessDict = [NSDictionary dictionaryWithDictionary:responseObject];
            NSString *accessToken  = [accessDict objectForKey:WX_ACCESS_TOKEN];
            NSString *openID       = [accessDict objectForKey:WX_OPEN_ID];
            NSString *refreshToken = [accessDict objectForKey:WX_REFRESH_TOKEN];

            if (accessToken.length && openID.length) {
                [[NSUserDefaults standardUserDefaults] setObject:accessToken forKey:WX_ACCESS_TOKEN];
                [[NSUserDefaults standardUserDefaults] setObject:openID forKey:WX_OPEN_ID];
                [[NSUserDefaults standardUserDefaults] setObject:refreshToken forKey:WX_REFRESH_TOKEN];
                [[NSUserDefaults standardUserDefaults] synchronize];   // 立即落盤,避免資料丟失
            }

            [self wechatLoginByRequestForUserInfo];
        } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
            NSLog(@"獲取 access_token 出錯 = %@", error);
        }];
    }
}

回調中幾個欄位的含義:

  • ErrCode:0 为用户同意、-4 拒絕、-2 取消。
  • code:換取 access_token 的一次性票據,僅在 ErrCode 為 0 時有效。
  • state:請求唯一標識,由 sendReq 傳入並原樣回傳,長度上限 1K。

六、用 code 換 access_token

GET https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

四個參數均為必填:appid 與 secret 來自開放平台,code 是上一步拿到的臨時票據,grant_type 固定填 authorization_code。

成功時的響應結構:

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

失敗則是 {"errcode":40029,"errmsg":"invalid code"},通常意味著 code 已被使用或已過期。

七、拉取用戶資料與 UnionID

GET https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID
- (void)wechatLoginByRequestForUserInfo
{
    AFHTTPRequestOperationManager *manager = [AFHTTPRequestOperationManager manager];
    NSString *accessToken = [[NSUserDefaults standardUserDefaults] objectForKey:WX_ACCESS_TOKEN];
    NSString *openID      = [[NSUserDefaults standardUserDefaults] objectForKey:WX_OPEN_ID];
    NSString *userUrlStr  = [NSString stringWithFormat:@"%@/userinfo?access_token=%@&openid=%@",
                             WX_BASE_URL, accessToken, openID];

    [manager GET:userUrlStr parameters:nil success:^(AFHTTPRequestOperation *operation, id responseObject) {
        NSLog(@"用戶信息 = %@", responseObject);
        // 在這裡把 nickname / headimgurl 等寫入自己的帳號體系
    } failure:^(AFHTTPRequestOperation *operation, NSError *error) {
        NSLog(@"獲取用戶信息出錯 = %@", error);
    }];
}

返回的 JSON 包含 openid、nickname、sex、province、city、country、headimgurl、privilege 與 unionid。其中 unionid 只有在把公眾號綁定到微信開放平台帳號後才會出現,它是跨應用識別同一用戶的關鍵。

八、常量集中管理

把散落的字串收攏成宏,後續維護會輕鬃很多:

#define WXDoctor_App_ID      @"wxd1931d4a0e462***"
#define WXDoctor_App_Secret  @"d0dd6b58da42cbc4f4b715c70e65c***"
#define WXPatient_App_ID     @"wxbd02bfeea4292***"
#define WXPatient_App_Secret @"4a788217f363358276309ab655707***"

#define WX_ACCESS_TOKEN   @"access_token"
#define WX_OPEN_ID        @"openid"
#define WX_REFRESH_TOKEN  @"refresh_token"
#define WX_UNION_ID       @"unionid"
#define WX_BASE_URL       @"https://api.weixin.qq.com/sns"

注意:AppSecret 屬於敏感憑證,正式項目中不要硬編碼在用戶端,也不建議提交進版本庫。

九、業務層的最後一哩

拿到微信身份只是完成了一半,真正要做的是把它接到自己的帳號體系上。一種常見的落地流程:

  1. 取得微信 openID,後台查該 openID 是否已綁定手機號。
  2. 未綁定:先把頭像、暱稱等資料入庫,再走簡訊驗證碼流程完成手機綁定,然後登入。
  3. 已綁定:後台直接回傳手機號,用手機完成登入。

這樣設計的好處是,微信只是「身份來源」,帳號歸屬仍舊掌握在自己的手機號體系裡,後續換第三方登錄方式也不會傷筋動骨。

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