iOS Swift Facebook Google Apple 第三方登入

Swift實作Facebook、Google、Apple ID第三方登入功能

林怡瑄 2021/07/07 21:34:17
11535

現今APP的用途很廣泛，無論是生活還是娛樂用，很多APP採用了會員系統，讓使用者必須使用一組帳號密碼來做登入，使用者方面可以記錄自己的喜好，而開發者也能保存使用者的資料。但我們都知道要多記住一組帳密其實是很麻煩的事情，如果可以選擇使用Facebook、Google，或是iOS使用者必備的Apple帳號來作為會員登入，相信對諸多使用者來說都是很方便的，而開發者也能夠藉此取得更多資訊，真是一舉數得可喜可賀（？）。

這篇文章將會以這三個平台為例子，介紹開發者如何串接第三方登入，以及可以從中得到哪些使用者資料。

 

一、使用Facebook作為第三方登入平台

 

以下會介紹詳細的使用步驟，亦可直接參閱官方說明文件：

https://developers.facebook.com/docs/facebook-login/ios

我們先建立一個XCODE專案，接著至FB的開發者平台（https://developers.facebook.com/）

在註冊為開發者後，進入開發者首頁，點擊右上「我的應用程式」，並建立一個應用程式。

 

選擇消費者。

 

填入應用程式顯示名稱，注意不能直接使用FB、Facebook等包含官方名稱的文字，然後點擊建立應用程式。

 


之後在左邊的側邊欄選取設定>基本資料，拉到最底下新增平台。

 

選擇iOS。

 


套件組和編號即為專案中的Bundle ID，以及記得把單一登入改為「是」，然後點擊右下方的「儲存變更」。

接著回到XCODE專案裡。跟著官方文件在 File> Swift Packages> Add Package Dependency中，輸入框填入：https://github.com/facebook/facebook-ios-sdk

預設已為Up to Next Major。

 

選擇FacebookLogin後，點擊Finish，接著就可以看到左邊多了一欄。

接著我們設定專案，按照說明，在專案的Info.plist選擇以原始碼開啟（右鍵>Open As>Source Code），在<dict>...</dict>中貼上代碼。

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>fb2963XXXXXXXXXXX</string>
        </array>
    </dict>
</array>
<key>FacebookAppID</key>
<string>2963XXXXXXXXXXX</string>
<key>FacebookDisplayName</key>
<string>SocialLoginDemo</string>
<key>LSApplicationQueriesSchemes</key>
<array>
    <string>fbapi</string>
    <string>fbapi20130214</string>
    <string>fbapi20130410</string>
    <string>fbapi20130702</string>
    <string>fbapi20131010</string>
    <string>fbapi20131219</string>
    <string>fbapi20140410</string>
    <string>fbapi20140116</string>
    <string>fbapi20150313</string>
    <string>fbapi20150629</string>
    <string>fbapi20160328</string>
    <string>fbauth</string>
    <string>fb-messenger-share-api</string>
    <string>fbauth2</string>
    <string>fbshareextension</string>
</array>

2963開頭的那串數字請換成自己的應用程式編號，在FB的開發者頁面上方可以找到。

SocialLoginDemo也要換成自己在FB建立的應用程式名稱（非XCODE專案名稱）。

 

再來到AppDelegate.swift裡，把裡面的程式碼直接改為下面這段：

import UIKit
import FacebookLogin

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        ApplicationDelegate.shared.application(application, didFinishLaunchingWithOptions: launchOptions)
        return true
    }
    
    func application(_ app:UIApplication, open url:URL, options: [UIApplication.OpenURLOptionsKey :Any] = [:]) -> Bool {
        ApplicationDelegate.shared.application(app, open: url, sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String, annotation: options[UIApplication.OpenURLOptionsKey.annotation])
    }
    
}

 

這段的作用，讓我借用一下官方文件說明：

『此程式碼會在應用程式啟動時初始化 SDK，並在執行「登入」或「分享」動作時，讓 SDK 處理原生 Facebook 應用程式的結果。』

 

另外在SceneDelegate.swift中，先import FBSDKCoreKit後，加入以下程式碼：

func scene(_ scene:UIScene, openURLContexts URLContexts:Set<UIOpenURLContext>) {
        guard let url = URLContexts.first?.url else { return }
        ApplicationDelegate.shared.application( UIApplication.shared, open: url, sourceApplication: nil, annotation: [UIApplication.OpenURLOptionsKey.annotation] )      
    }

這段程式碼將處理開啟網址的功能。

 

再來是置入按鈕的部分，官方有提供按鈕的圖示，如果要直接使用的話，在ViewController裡，先import FacebookLogin，並在viewDidLoad裡放進程式碼：

let loginButton = FBLoginButton()
loginButton.center = view.convert(CGPoint(x: view.center.x, y: 300), from: self.view)
view.addSubview(loginButton)

 

不過我這次自己做了三個按鈕。

所以我在按鈕裡放入：

let loginManager = LoginManager()

loginManager.logIn(permissions: [.publicProfile, .email], viewController : nil) { loginResult in
    switch loginResult {
    case .failed(let error):
         print(error)
    case .cancelled:
         print("-------User cancelled login")
    case .success(granted: _, declined: _, token: _):
         print("-------Logged in")
        }
 }

 

點擊按鈕即會出現：

 

在登入帳號後，會提醒使用者這個APP要求的權限，即為程式碼中permissions: [.publicProfile, .email]的部分，隨著要求權限的不同也會有不同提醒。

 

需注意的地方是，目前可以直接取得的使用者資料只有公開檔案與電子信箱這兩種，其餘都需要經由FB官方審查，開發者可從使用者的帳號裡獲得的資訊可以參考官方網頁：

https://developers.facebook.com/docs/permissions/reference

如果程式碼中有尚未審查的權限，會出現像這樣的警告。

FB的登入審查相關請見官方文件：

https://developers.facebook.com/docs/facebook-login/permissions/review

官方會檢驗APP中是否真的需要使用到這些涉及隱私的權限，文件中有較詳細的說明可以參考。

 

此外，我們需要檢查使用者的登入狀態，可以從AccessToken.current 

是否有值來確認登入狀態，並且取得userID，例如加上這樣的程式碼：

if let accessToken = AccessToken.current {
                
    print("-----------userID: \(accessToken.userID)")
    print("-----------tokenString: \(accessToken.tokenString)")
    } else {
            print("not login")
    }

 

因此我現在可以從log裡看到這樣的結果：

 

以及再加上這幾行，這樣就能看到已登入的使用者資訊：

let request = GraphRequest.init(graphPath: "me", parameters: ["fields":"name, email"]).start { connection, result, error in
   let result = result as! NSDictionary
   print(result)
}

 

 

log印出結果：

 

如果需要登出的話，在登出的地方加上loginManager.logout()就可以了，這樣就完成使用Facebook第三方登入的功能啦，這邊僅列出最基本的流程，其餘的操作請至FB的開發者平台研究囉。

 

 

二、使用Google作為第三方登入平台

 

FB的部分結束了，接著來實作Google的第三方登入，他的官方文件在這邊：https://developers.google.com/identity/sign-in/ios/start-integrating

下面也會每個步驟逐一截圖說明。

 

取得Google Sign-in SDK的方式，官方建議使用CocoaPods安裝（pod 'GoogleSignIn'）

，雖然也可以直接下載，不過我這邊就照著建議的方式吧，使用CocoaPods的過程就先省略了，網路上有很多的教學。

 

安裝完後，改開.xcworkspace結尾的檔案，按照說明我們需要取得OAuth客戶端ID。


記得先複製一下Client ID，然後貼到專案裡TARGETS-Info，新增一項URL Types。

 

這邊要注意的是，我們剛剛複製的Client ID在URL Schemes前後是反過來的，需要調換順序，前面是com.googleusercontent.apps，後面就直接貼上即可。

 

 

接著寫一點程式碼，在AppDelegate.swift中import GoogleSignIn，並在AppDelegate的類別中加入GIDSignInDelegate。
class AppDelegate: UIResponder, UIApplicationDelegate, GIDSignInDelegate {

 

在application:didFinishLaunchingWithOptions:方法中加入：

GIDSignIn.sharedInstance().clientID = "你的Client ID"
GIDSignIn.sharedInstance().delegate = self

 

 

在application:openURL:options:方法中也加入：

return GIDSignIn.sharedInstance().handle(url)

 

此外，為了支援iOS 8以下版本，官方建議加入已棄用的application:openURL:sourceApplication:annotation:方法，但如果APP本身沒打算支援較低的版本，可以不用加入這一段。

func application(_ application: UIApplication,
                 open url: URL, sourceApplication: String?, annotation: Any) -> Bool {
  return GIDSignIn.sharedInstance().handle(url)
}

 

 

在剛剛加入GIDSignInDelegate時，XCODE應該會出現要求增加協議的警告，需要定義didSignInFor這個方法，所以在底下加入：

func sign(_ signIn: GIDSignIn!, didSignInFor user: GIDGoogleUser!, withError error: Error!) {
  if let error = error {
    if (error as NSError).code == GIDSignInErrorCode.hasNoAuthInKeychain.rawValue {
      print("The user has not signed in before or they have since signed out.")
    } else {
      print("\(error.localizedDescription)")
    }
    return
  }
  // Perform any operations on signed in user here.
  let userId = user.userID                  // For client-side use only!
  let idToken = user.authentication.idToken // Safe to send to the server
  let fullName = user.profile.name
  let givenName = user.profile.givenName
  let familyName = user.profile.familyName
  let email = user.profile.email
}

 

再來是ViewController的部分，一樣先import GoogleSignIn，在viewDidLoad加入：

GIDSignIn.sharedInstance()?.presentingViewController = self
GIDSignIn.sharedInstance()?.restorePreviousSignIn()

 

最後是按鈕，我在自定義的按鈕裡加入這一行：

GIDSignIn.sharedInstance().signIn()

上面是處理登入的部分，如果要登出的話就是：

GIDSignIn.sharedInstance().signOut()

 

來看一下結果。

到這邊，使用者已經完成了登入的過程，開發者若要取得使用者資訊，可以從GIDGoogleUser中獲得。官方的教學是把這段程式碼放在AppDelegate裡，如果需要呈現在畫面上，可以傳值到ViewController裡，或是直接在ViewController裡加入GIDSignInDelegate。

 

官方文件中列出了一些可能會使用到的基本資料，如使用者ID，ID Token、姓名、email等等，直接從log印出來看看，我把程式改成這樣：

if let userId = user.userID {
     print("---------\(userId)")
} // For client-side use only!
if let idToken = user.authentication.idToken {
     print("---------\(idToken)")
} // Safe to send to the server
if let fullName = user.profile.name {
     print("---------\(fullName)")
}
if let email = user.profile.email {
     print("---------\(email)")
}

 

印出來的結果：

以上到這邊是Google第三方登入的部分，更多的應用可以參考官方文件。

 

 

三、使用Apple ID作為第三方登入平台

 

對iOS使用者來說，使用Apple ID登入或許是目前最安全的方式，開發者只會得到使用者的名字以及email，在登入時若選擇「隱藏我的電子郵件」，則開發者只會看到Apple幫忙建立的一組對應的、由系統產生的專屬帳號（網域為privaterelay.appleid.com），在保護隱私上更為徹底。

 

接著來著手操作吧，首先至Signing & Capacilities中，新增Capability。

（附註說明，如果不是有加入開發者計劃或是企業的Apple帳號的話，Capability裡是不會有Sign in with Apple這個選項的喔）

接著回到ViewController，先import AuthenticationServices，然後在自定義的按鈕裡加上：

let provider = ASAuthorizationAppleIDProvider()
let request = provider.createRequest()
request.requestedScopes = [.fullName, .email]
let authorizationController = ASAuthorizationController(authorizationRequests: [request])
authorizationController.delegate = self
authorizationController.performRequests()

到這邊會出現一個錯誤提示，要求加入ASAuthorizationControllerDelegate，所以要加一個extension，連帶放入這些程式：
extension ViewController: ASAuthorizationControllerDelegate {
    
    func authorizationController(controller: ASAuthorizationController, didCompleteWithAuthorization authorization: ASAuthorization) {
        if let credential = authorization.credential as? ASAuthorizationAppleIDCredential {
            let userId = credential.user
            let fullname = credential.fullName
            let email = credential.email
            let idToken = credential.identityToken
            print("---------\(userId)")
            print("---------\(fullname)")
            print("---------\(email)")
            print("---------\(idToken)")
        }
    }
    
    func authorizationController(controller: ASAuthorizationController, didCompleteWithError error: Error) {
        print(error.localizedDescription)
    }
    
}

 

Error的部分也可以用switch去細分為不同的case，在ASAuthorizationError裡面可以看到failed、canceled等等的狀態，可以個別判斷為何種錯誤。

 

之後來試跑看看，我是使用模擬器，前面的步驟沒有問題：

就沒有然後了，點下Contunue以後進入無止盡的轉圈圈。

後來搜尋了一下，在一年前也有人抱怨過這個問題，關於在iOS 14版本的模擬器會出現無法登入Apple ID的狀況：
https://developer.apple.com/forums/thread/651533

不過底下有人提供解法，先去下載13.7版本的模擬器，並把APP的支援版本改成13.6或以下。





再運行一次看看。






成功了！並且可以看到，在我選擇了Hide My Email之後，我log接收到的就是一組專屬的英數字帳號。

 

最後稍微說一下那個836 bytes，他的格式是個有時效性的JWT（JSON Web Token），寫成base64的編碼，我把程式改成：
guard let idToken = credential.identityToken else { return }
print("---------\(String(data: idToken, encoding: .utf8))")
 
會得到



這一大串是由Header、Payload、Signature所組成。有了IdentityToken可以向server驗證token是否過期，流程是這樣：



至於驗證token的方法請參考官方文件：

https://developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_rest_api/authenticating_users_with_sign_in_with_apple

https://developer.apple.com/documentation/sign_in_with_apple/sign_in_with_apple_rest_api/verifying_a_user


四、實際應用

在討論實際應用之前，先回顧一下開發者可以從這三個平台獲取的資料。

 

Google和Apple能獲取的資料較為基本，前者能拿到的是姓名、頭像，以及電子信箱；Apple能拿到的東西是姓名與電子信箱（使用者可以選擇顯示為中介mail）。Facebook能拿的東西就很多了，除了基本的名稱、頭像、電子信箱外，還可能取得使用者的眾多個人資料，例如性別、年齡、居住地、教育狀況，甚至是朋友名單（限使用同APP）、點過讚的粉絲專頁、貼文、影片等，畢竟比起其他兩者，FB是社群網站，能掌握的東西多得多。

 

不過綜合上述三種平台來看，開發者提供讓使用者以第三方平台作為快速註冊及登入，最方便的就是能快速取得使用者的名字或電子信箱，可以直接拿來作為使用者的代稱，例如在登入以後可以直接從第三方平台拿到的名字稱呼使用者，然後再提供一個可以修改的地方；也可以收集到使用者信箱，作為行銷推廣使用等等。

 

或者最常見的，是利用分享的功能，在取得貼文的權限以後貼到使用者的公開頁面，藉以達到宣傳的效果，或是列出同樣有使用同個APP的朋友等，這兩點我們在很多的手遊APP裡應該都能看到有類似的機制，比如說請朋友送體力之類的，雖然要求這些權限需要通過FB的審核，但只要附上完整的說明，我想有那麼多前輩APP在先了，應該不會被特別刁難（大概吧）（欸）。

 

不過有個重要的事情，根據文件：https://developer.apple.com/app-store/review/guidelines/#sign-in-with-apple

APP中如果提供第三方登入，除非是教育類，或者是企業內部使用的情形，否則一定要加入Sign in with Apple的部分，所以如果要在iOS的APP中加入任何的第三方平台作為登入，勢必也得加上Apple登入。

 

但以我個人經驗，如果是打算以第三方登入所取得的信箱資料作為ID的話，最好不要讓使用者在其他地方有需要填ID的時候，一律在APP內作業，因為在選擇了隱藏信箱後ID就會變成了那一串亂碼般的英數字，然而一些遊戲的獎勵是在網頁上操作，我根本不記得我的代理mail是什麼最後只好重新註冊一個，還好還沒玩多久⋯⋯（扯遠了）。不過整體來說Apple ID是很方便，還可以用Touch ID或Face ID快速登入，如果只是單純作為APP註冊的話，我覺得對iOS使用者來說是最好的選擇了。

 

總之，以上就是目前最普遍使用的三種第三方登入的說明，這邊都只列出基本使用的方法，如果有興趣想活用在更多方面，請至各官方文件進行探索囉。
 
參考資料：
https://developers.facebook.com/docs/facebook-login/ios
https://developers.google.com/identity/sign-in/ios/start-integrating
https://developer.apple.com/documentation/authenticationservices/implementing_user_authentication_with_sign_in_with_apple
https://developer.apple.com/forums/thread/651533
 
林怡瑄
相關文章
iOS - 幾個處理陣列刪除元素的實用技巧
大話 Clean Swift - 觀念篇
Swift實作Facebook、Google、Apple ID第三方登入功能
第一次使用Core Data就上手
TableView實現畫線、自動捲軸、取得座標位置
串接第三方 API，解析 JSON 資料，轉換成自訂型別顯示
最新文章
5步驟教你自動產出WORD文章目錄及圖表目錄
Unit testing LLM models - Lessons from Vertex AI
IntelliJ IDEA 配置 Maven 內網開發環境
Mermaid 語法匯出圖檔格式操作說明 - Mermaid Live Editor, Notion, Draw IO
Project IDX 線上IDE開發程式
使用 Bootify 快速生成 Spring Boot 程式架構