اصالت‌سنجی بااستفاده از «ورود به سیستم با Google» در پلاتفرم‌های Apple

با ادغام «ورود به سیستم با Google» در برنامه‌تان، می‌توانید به کاربرانتان اجازه دهید بااستفاده از «حساب Google» خودشان در Firebase اصالت‌سنجی کنند.

برای کمک هوش مصنوعی، پیام‌واره زیر را در عامل کدنویسی هوش مصنوعی خود (مانند Antigravity، Claude Code،‏ Codex، و Cursor) کپی کنید. می‌توانید پیام‌واره را سفارشی‌سازی کنید و با عاملتان تکرار کنید. برای اطلاعات دقیق نصب، به مهارت‌های عامل Firebase مراجعه کنید.

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up and use Firebase Authentication with Google Sign-In in my app.

قبل از شروع

از Swift Package Manager برای نصب و مدیریت وابستگی‌های Firebase استفاده کنید.

  1. در Xcode، درحالی‌که پروژه برنامه‌تان باز است، به File (فایل) > Add Packages (افزودن بسته‌ها) بروید.
  2. وقتی خواسته شد، مخزن کیت توسعه نرم‌افزار Firebase Apple platforms را اضافه کنید:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. کتابخانه Firebase Authentication را انتخاب کنید.
  5. پرچم -ObjC را به بخش Other Linker Flags (سایر پرچم‌های پیونددهنده) در تنظیمات ساخت هدف اضافه کنید.
  6. وقتی تمام شد، Xcode به‌طور خودکار شروع به حل و بارگیری وابستگی‌های شما در پس‌زمینه می‌کند.

افزودن کیت توسعه نرم‌افزار «ورود به سیستم با Google» به پروژه

  1. در Xcode، درحالی‌که پروژه برنامه‌تان باز است، به File (فایل) > Add Packages (افزودن بسته‌ها) بروید.

  2. وقتی درخواست شد، مخزن Google Sign-In SDK را اضافه کنید:

    https://github.com/google/GoogleSignIn-iOS
    
  3. وقتی تمام شد، Xcode به‌طور خودکار شروع به حل و بارگیری وابستگی‌های شما در پس‌زمینه می‌کند.

فعال کردن «ورود به سیستم با Google» برای پروژه Firebase

برای اینکه کاربران بتوانند بااستفاده از «ورود به سیستم با Google» به سیستم وارد شوند، ابتدا باید ارائه‌دهنده «ورود به سیستم با Google» را برای پروژه Firebase خود فعال کنید:

  1. در کنسول Firebase، به امنیت > اصالت‌سنجی بروید.

  2. در برگه روش ورود به سیستم، ارائه‌دهنده Google را فعال کنید.

  3. روی ذخیره کردن کلیک کنید.

  4. نسخه جدیدی از فایل GoogleService-Info.plist پروژه‌تان را بارگیری کنید و آن را در پروژه Xcode خود کپی کنید. نسخه جدید را روی نسخه‌های موجود رونویسی کنید. (به افزودن Firebase به پروژه iOS مراجعه کنید.)

وارد کردن فایل‌های سرایند موردنیاز

ابتدا باید فایل‌های سرایند «کیت توسعه نرم‌افزار Firebase» و «کیت توسعه نرم‌افزار ورود به سیستم با Google» را به برنامه‌تان وارد کنید.

Swift

import FirebaseAuth
import GoogleSignIn

Objective-C

@import FirebaseCore;
@import GoogleSignIn;

پیاده‌سازی «ورود به سیستم با Google»

با دنبال کردن این مراحل، «ورود به سیستم با Google» را پیاده‌سازی کنید. برای جزئیات مربوط به استفاده از «ورود به سیستم با Google» در iOS، به مستندات توسعه‌دهنده «ورود به سیستم با Google» مراجعه کنید.

  1. طرح‌واره‌های نشانی وب سفارشی را به پروژه Xcode خود اضافه کنید:
    1. پیکربندی پروژه را باز کنید: روی نام پروژه در نمای درختی سمت راست کلیک کنید. برنامه‌تان را از بخش TARGETS انتخاب کنید، سپس برگه Info را انتخاب کنید و بخش URL Types را ازهم باز کنید.
    2. روی دکمه + کلیک کنید و طرح‌واره نشانی وب را برای شناسه کارخواه معکوس‌شده‌تان اضافه کنید. برای پیدا کردن این مقدار، فایل پیکربندی GoogleService-Info.plist را باز کنید و به‌دنبال کلید REVERSED_CLIENT_ID بگردید. مقدار آن کلید را کپی کنید، و آن را در چارگوش طرح‌واره‌های نشانی وب در صفحه پیکربندی جای‌گذاری کنید. بقیه فیلدها را بدون تغییر باقی بگذارید.

      پس‌از تکمیل، پیکربندی شما باید چیزی شبیه به موارد زیر باشد (اما با مقادیر مختص برنامه‌تان):

  2. در روش application:didFinishLaunchingWithOptions: نماینده برنامه‌تان، شیء FirebaseApp را پیکربندی کنید.

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. روش application:openURL:options: را در نماینده برنامه‌تان پیاده‌سازی کنید. این روش باید روش handleURL از نمونه GIDSignIn را فراخوانی کند، که به‌درستی نشانی وبی را که برنامه شما در پایان فرایند اصالت‌سنجی دریافت می‌کند مدیریت خواهد کرد.

    Swift

    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
      // ...
    }
      return GIDSignIn.sharedInstance.handle(url)
    }

    Objective-C

    - (BOOL)application:(nonnull UIApplication *)application
                openURL:(nonnull NSURL *)url
                options:(nonnull NSDictionary<NSString *, id> *)options {
      return [[GIDSignIn sharedInstance] handleURL:url];
    }
  4. کنترل‌کننده نمای ارائه‌دهنده و شناسه مشتری را برای برنامه‌تان به روش signIn ارائه‌دهنده «ورود به سیستم با Google» ارسال کنید و از شناسه اصالت‌سنجی Google حاصل، اعتبارنامه «اصالت‌سنجی Firebase» ایجاد کنید:

    Swift

    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: viewController) { result, error in
      guard error == nil else {
        // ...
        return
      }
    
      guard let user = result?.user,
            let idToken = user.idToken?.tokenString
      else {
        // ...
        return
      }
    
      let credential = GoogleAuthProvider.credential(withIDToken: idToken,
                                                     accessToken: user.accessToken.tokenString)
      self.signIn(with: credential)
    }

    Objective-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 {
        // ...
      }
    }];
  5. GIDSignInButton را به فیلم‌نامه مصور، فایل XIB، یا نمونه‌سازی برنامه‌ای آن اضافه کنید. برای افزودن دکمه به استوری‌برد یا فایل XIB، یک View اضافه کنید و کلاس سفارشی آن را روی GIDSignInButton تنظیم کنید.
  6. اختیاری: اگر می‌خواهید دکمه را سفارشی‌سازی کنید، کارهای زیر را انجام دهید:

    Swift

    1. در کنترل‌کننده نمای خود، دکمه ورود به سیستم را به‌عنوان یک ویژگی اعلام کنید.
      @IBOutlet weak var signInButton: GIDSignInButton!
    2. دکمه را به دارایی signInButton که به‌تازگی اعلام کردید متصل کنید.
    3. دکمه را با تنظیم کردن ویژگی‌های شیء GIDSignInButton سفارشی‌سازی کنید.

    Objective-C

    1. در فایل سرایند کنترل‌کننده نمای خود، دکمه ورود به سیستم را به‌عنوان یک ویژگی اعلام کنید.
      @property(weak, nonatomic) IBOutlet GIDSignInButton *signInButton;
    2. دکمه را به دارایی signInButton که به‌تازگی اعلام کردید متصل کنید.
    3. دکمه را با تنظیم کردن ویژگی‌های شیء GIDSignInButton سفارشی‌سازی کنید.

اصالت‌سنجی با Firebase

درنهایت، فرایند ورود به سیستم Firebase را با اطلاعات اعتباری اصالت‌سنجی ایجادشده در مرحله قبل تکمیل کنید.

Swift

Auth.auth().signIn(with: credential) { result, error in
  guard error == nil else {
    // ...
    return
  }

  // At this point, our user is signed in
}
    

Objective-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 Realtime Database و Cloud Storage قوانین امنیتی، می‌توانید شناسه کاربر منحصربه‌فرد کاربر واردشده به سیستم را از متغیر auth دریافت کنید، و از آن برای کنترل داده‌هایی که کاربر می‌تواند به آن‌ها دسترسی داشته باشد استفاده کنید.

می‌توانید به کاربران اجازه دهید بااستفاده از چند ارائه‌دهنده اصالت‌سنجی به سیستم برنامه‌تان وارد شوند. برای این کار، اعتبارنامه‌های ارائه‌دهنده اصالت‌سنجی را به حساب کاربری موجود پیوند دهید.

برای خارج کردن کاربر از سیستم، signOut: را فراخوانی کنید.

Swift

let firebaseAuth = Auth.auth()
do {
  try firebaseAuth.signOut()
} catch let signOutError as NSError {
  print("Error signing out: %@", signOutError)
}

Objective-C

NSError *signOutError;
BOOL status = [[FIRAuth auth] signOut:&signOutError];
if (!status) {
  NSLog(@"Error signing out: %@", signOutError);
  return;
}

همچنین ممکن است بخواهید کد رسیدگی به خطا را برای طیف کامل خطاهای اصالت‌سنجی اضافه کنید. رسیدگی به خطاها را ببینید.