Аутентификация с помощью входа в Google на платформах Apple

Вы можете разрешить своим пользователям проходить аутентификацию в Firebase с использованием своих учетных записей Google, интегрировав функцию входа в Google в свое приложение.

Прежде чем начать

Используйте Swift Package Manager для установки и управления зависимостями Firebase.

  1. В Xcode откройте проект приложения и перейдите в меню Файл > Добавить пакеты .
  2. При появлении соответствующего запроса добавьте репозиторий Firebase Apple platform SDK:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Выберите библиотеку Firebase Authentication .
  5. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей цели.
  6. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Добавьте Google Sign-In SDK в свой проект

  1. В Xcode откройте проект приложения и перейдите в меню Файл > Добавить пакеты .

  2. При появлении соответствующего запроса добавьте репозиторий Google Sign-In SDK:

    https://github.com/google/GoogleSignIn-iOS
    
  3. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Включите вход через Google для вашего проекта Firebase

Чтобы разрешить пользователям входить в систему с помощью Google Sign-In, необходимо сначала включить провайдера Google Sign-In для вашего проекта Firebase:

  1. В консоли Firebase откройте раздел «Аутентификация» .
  2. На вкладке «Способ входа» включите поставщика Google .
  3. Нажмите «Сохранить» .

  4. Загрузите новую копию файла GoogleService-Info.plist вашего проекта и скопируйте его в ваш проект Xcode. Перезапишите все существующие версии новой. (См. Добавление Firebase в ваш проект iOS .)

Импортируйте необходимые заголовочные файлы

Сначала необходимо импортировать заголовочные файлы Firebase SDK и Google Sign-In SDK в ваше приложение.

Быстрый

import FirebaseCore
import FirebaseAuth
import GoogleSignIn

Objective-C

@import FirebaseCore;
@import GoogleSignIn;

Внедрите вход через Google

Реализуйте Google Sign-In, выполнив следующие шаги. Подробную информацию об использовании Google Sign-In с iOS см. в документации разработчика Google Sign-In.

  1. Добавьте пользовательские схемы URL в свой проект Xcode:
    1. Откройте конфигурацию вашего проекта: щелкните имя проекта в левом дереве. Выберите свое приложение из раздела TARGETS , затем выберите вкладку Info и разверните раздел URL Types .
    2. Нажмите кнопку + и добавьте схему URL для обратного идентификатора клиента. Чтобы найти это значение, откройте файл конфигурации GoogleService-Info.plist и найдите ключ REVERSED_CLIENT_ID . Скопируйте значение этого ключа и вставьте его в поле Схемы URL на странице конфигурации. Оставьте остальные поля нетронутыми.

      После завершения ваша конфигурация должна выглядеть примерно так (но со значениями, специфичными для вашего приложения):

  2. В методе делегата приложения application:didFinishLaunchingWithOptions: настройте объект FirebaseApp .

    Быстрый

    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Реализуйте application:openURL:options: вашего делегата приложения. Метод должен вызывать метод handleURL экземпляра GIDSignIn , который будет правильно обрабатывать URL, который ваше приложение получает в конце процесса аутентификации.

    Быстрый

    func application(_ app: UIApplication,
                     open url: URL,
                     options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
      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 и создайте учетные данные аутентификации 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)
    
      // ...
    }

    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. Необязательно : если вы хотите настроить кнопку, выполните следующие действия:

    Быстрый

    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, используя учетные данные, созданные на предыдущем шаге.

Быстрый

Auth.auth().signIn(with: credential) { result, error in

  // 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:

Быстрый

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;
}

Вы также можете захотеть добавить код обработки ошибок для всего диапазона ошибок аутентификации. См. Обработка ошибок .

,

Вы можете разрешить своим пользователям проходить аутентификацию в Firebase с использованием своих учетных записей Google, интегрировав функцию входа в Google в свое приложение.

Прежде чем начать

Используйте Swift Package Manager для установки и управления зависимостями Firebase.

  1. В Xcode откройте проект приложения и перейдите в меню Файл > Добавить пакеты .
  2. При появлении соответствующего запроса добавьте репозиторий Firebase Apple platform SDK:
  3.   https://github.com/firebase/firebase-ios-sdk.git
  4. Выберите библиотеку Firebase Authentication .
  5. Добавьте флаг -ObjC в раздел «Другие флаги компоновщика» настроек сборки вашей цели.
  6. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Добавьте Google Sign-In SDK в свой проект

  1. В Xcode откройте проект приложения и перейдите в меню Файл > Добавить пакеты .

  2. При появлении соответствующего запроса добавьте репозиторий Google Sign-In SDK:

    https://github.com/google/GoogleSignIn-iOS
    
  3. По завершении Xcode автоматически начнет разрешать и загружать ваши зависимости в фоновом режиме.

Включите вход через Google для вашего проекта Firebase

Чтобы разрешить пользователям входить в систему с помощью Google Sign-In, необходимо сначала включить провайдера Google Sign-In для вашего проекта Firebase:

  1. В консоли Firebase откройте раздел «Аутентификация» .
  2. На вкладке «Способ входа» включите поставщика Google .
  3. Нажмите «Сохранить» .

  4. Загрузите новую копию файла GoogleService-Info.plist вашего проекта и скопируйте его в ваш проект Xcode. Перезапишите все существующие версии новой. (См. Добавление Firebase в ваш проект iOS .)

Импортируйте необходимые заголовочные файлы

Сначала необходимо импортировать заголовочные файлы Firebase SDK и Google Sign-In SDK в ваше приложение.

Быстрый

import FirebaseCore
import FirebaseAuth
import GoogleSignIn

Objective-C

@import FirebaseCore;
@import GoogleSignIn;

Внедрите вход через Google

Реализуйте Google Sign-In, выполнив следующие шаги. Подробную информацию об использовании Google Sign-In с iOS см. в документации разработчика Google Sign-In.

  1. Добавьте пользовательские схемы URL в свой проект Xcode:
    1. Откройте конфигурацию вашего проекта: щелкните имя проекта в левом дереве. Выберите свое приложение из раздела TARGETS , затем выберите вкладку Info и разверните раздел URL Types .
    2. Нажмите кнопку + и добавьте схему URL для обратного идентификатора клиента. Чтобы найти это значение, откройте файл конфигурации GoogleService-Info.plist и найдите ключ REVERSED_CLIENT_ID . Скопируйте значение этого ключа и вставьте его в поле Схемы URL на странице конфигурации. Оставьте остальные поля нетронутыми.

      После завершения ваша конфигурация должна выглядеть примерно так (но со значениями, специфичными для вашего приложения):

  2. В методе делегата приложения application:didFinishLaunchingWithOptions: настройте объект FirebaseApp .

    Быстрый

    FirebaseApp.configure()

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
  3. Реализуйте application:openURL:options: вашего делегата приложения. Метод должен вызывать метод handleURL экземпляра GIDSignIn , который будет правильно обрабатывать URL, который ваше приложение получает в конце процесса аутентификации.

    Быстрый

    func application(_ app: UIApplication,
                     open url: URL,
                     options: [UIApplication.OpenURLOptionsKey: Any] = [:]) -> Bool {
      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 и создайте учетные данные аутентификации 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)
    
      // ...
    }

    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. Необязательно : если вы хотите настроить кнопку, выполните следующие действия:

    Быстрый

    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, используя учетные данные, созданные на предыдущем шаге.

Быстрый

Auth.auth().signIn(with: credential) { result, error in

  // 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:

Быстрый

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;
}

Вы также можете захотеть добавить код обработки ошибок для всего диапазона ошибок аутентификации. См. Обработка ошибок .