คุณสามารถอนุญาตให้ผู้ใช้ตรวจสอบสิทธิ์กับ Firebase โดยใช้บัญชี Google ของตนได้โดยการผสานรวม Google Sign-In เข้ากับแอปของคุณ
ก่อนที่คุณจะเริ่ม
ใช้ Swift Package Manager เพื่อติดตั้งและจัดการการพึ่งพา Firebase
- ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Package
- เมื่อได้รับแจ้ง ให้เพิ่มพื้นที่เก็บข้อมูล SDK แพลตฟอร์ม Firebase Apple:
- เลือกไลบรารี Firebase Authentication
- เพิ่มแฟล็ก
-ObjC
ไปยังส่วน Other Linker Flags ของการตั้งค่า build ของเป้าหมายของคุณ - เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง
https://github.com/firebase/firebase-ios-sdk.git
เพิ่ม Google Sign-In SDK ในโครงการของคุณ
ใน Xcode เมื่อโปรเจ็กต์แอปของคุณเปิดอยู่ ให้ไปที่ File > Add Package
เมื่อได้รับแจ้ง ให้เพิ่มที่เก็บ Google Sign-In SDK:
https://github.com/google/GoogleSignIn-iOS
เมื่อเสร็จแล้ว Xcode จะเริ่มแก้ไขและดาวน์โหลดการอ้างอิงของคุณโดยอัตโนมัติในเบื้องหลัง
เปิดใช้งาน Google Sign-In สำหรับโปรเจ็กต์ Firebase ของคุณ
หากต้องการอนุญาตให้ผู้ใช้ลงชื่อเข้าใช้ด้วย Google Sign-In คุณต้องเปิดใช้งานผู้ให้บริการ Google Sign-In สำหรับโปรเจ็กต์ Firebase ของคุณก่อน:
- ใน คอนโซล Firebase ให้เปิดส่วน การตรวจสอบสิทธิ์
- บนแท็บ วิธีการลงชื่อเข้า ใช้ ให้เปิดใช้งานผู้ให้บริการ Google
คลิก บันทึก
ดาวน์โหลดสำเนาใหม่ของไฟล์
GoogleService-Info.plist
ของโปรเจ็กต์ของคุณ และคัดลอกไปยังโปรเจ็กต์ Xcode ของคุณ เขียนทับเวอร์ชันที่มีอยู่ด้วยเวอร์ชันใหม่ (ดู เพิ่ม Firebase ให้กับโปรเจ็กต์ iOS ของคุณ )
นำเข้าไฟล์ส่วนหัวที่จำเป็น
ขั้นแรก คุณต้องนำเข้าไฟล์ส่วนหัว Firebase SDK และ Google Sign-In SDK ลงในแอปของคุณ
สวิฟท์
import FirebaseCore import FirebaseAuth import GoogleSignIn
วัตถุประสงค์-C
@import FirebaseCore; @import GoogleSignIn;
ใช้การลงชื่อเข้าใช้ Google
ใช้ Google Sign-In โดยทำตามขั้นตอนเหล่านี้ ดู เอกสารสำหรับนักพัฒนา Google Sign-In สำหรับรายละเอียดเกี่ยวกับการใช้ Google Sign-In กับ iOS
- เพิ่มโครงร่าง URL ที่กำหนดเองให้กับโปรเจ็กต์ Xcode ของคุณ:
- เปิดการกำหนดค่าโครงการของคุณ: คลิกชื่อโครงการในมุมมองต้นไม้ด้านซ้าย เลือกแอปของคุณจากส่วน เป้าหมาย จากนั้นเลือกแท็บ ข้อมูล และขยายส่วน ประเภท URL
- คลิกปุ่ม + และเพิ่มรูปแบบ URL สำหรับรหัสไคลเอ็นต์ที่กลับรายการของคุณ หากต้องการค้นหาค่านี้ ให้เปิดไฟล์การกำหนดค่า
และมองหาคีย์GoogleService-Info.plist REVERSED_CLIENT_ID
คัดลอกค่าของคีย์นั้น และวางลงในกล่อง URL Schemes บนหน้าการกำหนดค่า ปล่อยให้ช่องอื่นๆ ไม่ถูกแตะต้องเมื่อเสร็จแล้ว การกำหนดค่าของคุณควรมีลักษณะคล้ายกับตัวอย่างต่อไปนี้ (แต่ด้วยค่าเฉพาะแอปพลิเคชันของคุณ):
- ในเมธอด
application:didFinishLaunchingWithOptions:
ของผู้รับมอบสิทธิ์แอปของคุณ ให้กำหนดค่าออบเจ็กต์FirebaseApp
สวิฟท์
FirebaseApp.configure()
วัตถุประสงค์-C
// Use Firebase library to configure APIs [FIRApp configure];
- ใช้งาน
application:openURL:options:
วิธีการของตัวแทนแอปของคุณ วิธีการนี้ควรเรียกใช้วิธีhandleURL
ของอินสแตนซ์GIDSignIn
ซึ่งจะจัดการ URL ที่แอปพลิเคชันของคุณได้รับอย่างเหมาะสมเมื่อสิ้นสุดกระบวนการตรวจสอบสิทธิ์สวิฟท์
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool { return GIDSignIn.sharedInstance.handle(url) }
วัตถุประสงค์-C
- (BOOL)application:(nonnull UIApplication *)application openURL:(nonnull NSURL *)url options:(nonnull NSDictionary<NSString *, id> *)options { return [[GIDSignIn sharedInstance] handleURL:url]; }
- ส่งตัวควบคุมมุมมองการนำเสนอและรหัสไคลเอ็นต์สำหรับแอปของคุณไปยังวิธี
signIn
ใช้ของผู้ให้บริการลงชื่อเข้าใช้ Google และสร้างข้อมูลรับรองการตรวจสอบสิทธิ์ Firebase จากโทเค็นการตรวจสอบสิทธิ์ของ Google ที่เป็นผลลัพธ์:สวิฟท์
guard let clientID = FirebaseApp.app()?.options.clientID else { return } // Create Google Sign In configuration object. let config = GIDConfiguration(clientID: clientID) GIDSignIn.sharedInstance.configuration = config // Start the sign in flow! GIDSignIn.sharedInstance.signIn(withPresenting: self) { [unowned self] result, error in guard error == nil else { // ... } guard let user = result?.user, let idToken = user.idToken?.tokenString else { // ... } let credential = GoogleAuthProvider.credential(withIDToken: idToken, accessToken: user.accessToken.tokenString) // ... }
วัตถุประสงค์-C
GIDConfiguration *config = [[GIDConfiguration alloc] initWithClientID:[FIRApp defaultApp].options.clientID]; [GIDSignIn.sharedInstance setConfiguration:config]; __weak __auto_type weakSelf = self; [GIDSignIn.sharedInstance signInWithPresentingViewController:self completion:^(GIDSignInResult * _Nullable result, NSError * _Nullable error) { __auto_type strongSelf = weakSelf; if (strongSelf == nil) { return; } if (error == nil) { FIRAuthCredential *credential = [FIRGoogleAuthProvider credentialWithIDToken:result.user.idToken.tokenString accessToken:result.user.accessToken.tokenString]; // ... } else { // ... } }];
- เพิ่ม
GIDSignInButton
ลงในกระดานเรื่องราว ไฟล์ XIB หรือสร้างอินสแตนซ์โดยทางโปรแกรม หากต้องการเพิ่มปุ่มลงในกระดานเรื่องราวหรือไฟล์ XIB ให้เพิ่มมุมมองและตั้งค่าคลาสที่กำหนดเองเป็นGIDSignInButton
- ทางเลือก : หากคุณต้องการปรับแต่งปุ่ม ให้ทำดังต่อไปนี้:
สวิฟท์
- ในตัวควบคุมมุมมองของคุณ ให้ประกาศปุ่มลงชื่อเข้าใช้เป็นคุณสมบัติ
@IBOutlet weak var signInButton: GIDSignInButton!
- เชื่อมต่อปุ่มกับคุณสมบัติ
signInButton
ที่คุณเพิ่งประกาศ - ปรับแต่งปุ่มโดยการตั้งค่าคุณสมบัติของวัตถุ GIDSignInButton
วัตถุประสงค์-C
- ในไฟล์ส่วนหัวของตัวควบคุมมุมมองของคุณ ให้ประกาศปุ่มลงชื่อเข้าใช้เป็นคุณสมบัติ
@property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
- เชื่อมต่อปุ่มกับคุณสมบัติ
signInButton
ที่คุณเพิ่งประกาศ - ปรับแต่งปุ่มโดยการตั้งค่าคุณสมบัติของวัตถุ GIDSignInButton
- ในตัวควบคุมมุมมองของคุณ ให้ประกาศปุ่มลงชื่อเข้าใช้เป็นคุณสมบัติ
ตรวจสอบสิทธิ์กับ Firebase
สุดท้าย ดำเนินกระบวนการเข้าสู่ระบบ Firebase ให้เสร็จสิ้นด้วยข้อมูลรับรองการตรวจสอบที่สร้างขึ้นในขั้นตอนก่อนหน้า
สวิฟท์
Auth.auth().signIn(with: credential) { result, error in // At this point, our user is signed in }
วัตถุประสงค์-C
[[FIRAuth auth] signInWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (isMFAEnabled && error && error.code == FIRAuthErrorCodeSecondFactorRequired) { FIRMultiFactorResolver *resolver = error.userInfo[FIRAuthErrorUserInfoMultiFactorResolverKey]; NSMutableString *displayNameString = [NSMutableString string]; for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) { [displayNameString appendString:tmpFactorInfo.displayName]; [displayNameString appendString:@" "]; } [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Select factor to sign in\n%@", displayNameString] completionBlock:^(BOOL userPressedOK, NSString *_Nullable displayName) { FIRPhoneMultiFactorInfo* selectedHint; for (FIRMultiFactorInfo *tmpFactorInfo in resolver.hints) { if ([displayName isEqualToString:tmpFactorInfo.displayName]) { selectedHint = (FIRPhoneMultiFactorInfo *)tmpFactorInfo; } } [FIRPhoneAuthProvider.provider verifyPhoneNumberWithMultiFactorInfo:selectedHint UIDelegate:nil multiFactorSession:resolver.session completion:^(NSString * _Nullable verificationID, NSError * _Nullable error) { if (error) { [self showMessagePrompt:error.localizedDescription]; } else { [self showTextInputPromptWithMessage:[NSString stringWithFormat:@"Verification code for %@", selectedHint.displayName] completionBlock:^(BOOL userPressedOK, NSString *_Nullable verificationCode) { FIRPhoneAuthCredential *credential = [[FIRPhoneAuthProvider provider] credentialWithVerificationID:verificationID verificationCode:verificationCode]; FIRMultiFactorAssertion *assertion = [FIRPhoneMultiFactorGenerator assertionWithCredential:credential]; [resolver resolveSignInWithAssertion:assertion completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error) { [self showMessagePrompt:error.localizedDescription]; } else { NSLog(@"Multi factor finanlize sign in succeeded."); } }]; }]; } }]; }]; } else if (error) { // ... return; } // User successfully signed in. Get user data from the FIRUser object if (authResult == nil) { return; } FIRUser *user = authResult.user; // ... }];
ขั้นตอนถัดไป
หลังจากที่ผู้ใช้ลงชื่อเข้าใช้เป็นครั้งแรก บัญชีผู้ใช้ใหม่จะถูกสร้างขึ้นและเชื่อมโยงกับข้อมูลประจำตัว ซึ่งได้แก่ ชื่อผู้ใช้และรหัสผ่าน หมายเลขโทรศัพท์ หรือข้อมูลผู้ให้บริการรับรองความถูกต้อง ซึ่งผู้ใช้ลงชื่อเข้าใช้ด้วย บัญชีใหม่นี้จัดเก็บไว้เป็นส่วนหนึ่งของโปรเจ็กต์ Firebase ของคุณ และสามารถใช้เพื่อระบุผู้ใช้ในทุกแอปในโปรเจ็กต์ของคุณ ไม่ว่าผู้ใช้จะลงชื่อเข้าใช้ด้วยวิธีใดก็ตาม
ในแอปของคุณ คุณสามารถรับข้อมูลโปรไฟล์พื้นฐานของผู้ใช้ได้จากออบเจ็กต์
User
ดู จัดการผู้ใช้ในฐานข้อมูลเรียลไทม์ Firebase และ กฎความปลอดภัยของ พื้นที่เก็บข้อมูลบนคลาวด์ คุณสามารถรับ ID ผู้ใช้เฉพาะของผู้ใช้ที่ลงชื่อเข้าใช้จากตัวแปร
auth
และใช้เพื่อควบคุมข้อมูลที่ผู้ใช้สามารถเข้าถึงได้
คุณสามารถอนุญาตให้ผู้ใช้ลงชื่อเข้าใช้แอปของคุณโดยใช้ผู้ให้บริการตรวจสอบสิทธิ์หลายรายได้โดย การเชื่อมโยงข้อมูลประจำตัวของผู้ให้บริการตรวจสอบสิทธิ์กับบัญชีผู้ใช้ที่มีอยู่
หากต้องการออกจากระบบผู้ใช้ ให้โทร signOut:
สวิฟท์
let firebaseAuth = Auth.auth() do { try firebaseAuth.signOut() } catch let signOutError as NSError { print("Error signing out: %@", signOutError) }
วัตถุประสงค์-C
NSError *signOutError; BOOL status = [[FIRAuth auth] signOut:&signOutError]; if (!status) { NSLog(@"Error signing out: %@", signOutError); return; }
คุณอาจต้องการเพิ่มรหัสการจัดการข้อผิดพลาดสำหรับข้อผิดพลาดในการรับรองความถูกต้องทั้งหมด ดู การจัดการข้อผิดพลาด