Если вы перешли на Firebase Authentication with Identity Platform, то можете выполнять аутентификацию пользователей в Firebase с помощью поставщика, совместимого с OpenID Connect (OIDC). Это позволяет использовать поставщиков идентификационной информации, которые не поддерживаются Firebase.
Подготовка
Чтобы пользователи могли входить в систему с помощью поставщика OIDC, сначала необходимо получить от него следующую информацию:
Идентификатор клиента. Уникальная строка, которая идентифицирует ваше приложение. Поставщик может назначить вам разные идентификаторы клиента для каждой поддерживаемой платформы. Это одно из значений утверждения
audв токенах идентификации, выпущенных вашим поставщиком.Секретный код клиента. Секретная строка, которую поставщик использует для подтверждения права собственности на идентификатор клиента. Для каждого идентификатора клиента потребуется соответствующий секретный код клиента. Это значение требуется, только если вы используете обработку кода авторизации (настоятельно рекомендуется).
Issuer (Эмитент). Строка, идентифицирующая вашего поставщика. Это значение должно быть URL, который при добавлении
/.well-known/openid-configurationуказывает на местоположение discovery-документа OIDC поставщика. Например, если издатель –https://auth.example.com, то discovery-документ должен быть доступен по адресуhttps://auth.example.com/.well-known/openid-configuration.
Получив указанную выше информацию, включите OpenID Connect в качестве поставщика идентификационной информации для входа в проект Firebase:
Если вы ещё не перешли на Firebase Authentication with Identity Platform, сделайте это. Аутентификация OpenID Connect доступна только в обновленных проектах.
В консоли Firebase выберите Безопасность > Аутентификация.
На вкладке Sign-in method (Способ входа) нажмите Add new provider (Добавить поставщика), а затем выберите OpenID Connect.
Выберите, что вы будете использовать: обработку кода авторизации или неявное предоставление разрешения.
Если ваш поставщик поддерживает обработку кода, всегда используйте ее. Неявное предоставление доступа менее безопасно, и использовать его настоятельно не рекомендуется.
Укажите название поставщика. Запишите сгенерированный идентификатор поставщика, например
oidc.example-provider. Он понадобится вам, когда вы будете добавлять в приложение код для входа.Укажите идентификатор и секретный код клиента, а также строку издателя поставщика. Эти значения должны точно совпадать со значениями, назначенными вам поставщиком.
Сохраните изменения.
Как настроить процесс входа с помощью Firebase SDK
Проще всего аутентифицировать пользователей в Firebase с помощью поставщика OIDC, если весь процесс входа будет выполняться через Firebase SDK.
Чтобы настроить процесс входа с помощью Firebase SDK для платформ Apple, выполните следующие действия:
Добавьте специальные схемы URL в проект Xcode:
- Откройте конфигурацию проекта, дважды нажав на его название в дереве аккаунта слева. Выберите приложение в разделе TARGETS (ЦЕЛИ), откройте вкладку Info (Информация) и разверните раздел URL Types (Типы URL).
-
Нажмите кнопку + и добавьте закодированный идентификатор приложения в качестве схемы URL.
Остальные поля оставьте пустыми.
Закодированный идентификатор приложения можно найти в консоли Firebase. Для этого перейдите в раздел
Settings (Настройки) > General (Общие) и прокрутите страницу вниз до раздела Your apps (Ваши приложения), чтобы посмотреть информацию о приложении для iOS.После этого конфигурация должна выглядеть примерно так (но со значениями, относящимися к вашему приложению):
Создайте экземпляр
OAuthProvider, используя идентификатор поставщика, полученный в консоли Firebase.Swift
var provider = OAuthProvider(providerID: "oidc.example-provider")Objective-C
FIROAuthProvider *provider = [FIROAuthProvider providerWithProviderID:@"oidc.example-provider"];Необязательно. Укажите дополнительные специальные параметры OAuth, которые нужно отправлять с запросом OAuth.
Swift
provider.customParameters = [ "login_hint": "user@example.com" ]Objective-C
[provider setCustomParameters:@{@"login_hint": @"user@example.com"}];Узнайте у своего поставщика, какие параметры он поддерживает. Обратите внимание, что с помощью
setCustomParametersнельзя передавать обязательные параметры Firebase. К ним относятсяclient_id,response_type,redirect_uri,state,scopeиresponse_mode.Необязательно. Укажите дополнительные области действия OAuth 2.0, помимо основного профиля, которые вы хотите запросить у поставщика аутентификации.
Swift
provider.scopes = ["mail.read", "calendars.read"]Objective-C
[provider setScopes:@[@"mail.read", @"calendars.read"]];Узнайте у поставщика, какие области доступа он поддерживает.
Необязательно. Если вы хотите настроить способ представления
SFSafariViewControllerилиUIWebViewв приложении при показе reCAPTCHA пользователю, создайте пользовательский класс, соответствующий протоколуAuthUIDelegate.Выполните аутентификацию в Firebase с помощью объекта поставщика OAuth.
Swift
// If you created a custom class that conforms to AuthUIDelegate, // pass it instead of nil: provider.getCredentialWith(nil) { credential, error in if error != nil { // Handle error. } if credential != nil { Auth().signIn(with: credential) { authResult, error in if error != nil { // Handle error. } // User is signed in. // IdP data available in authResult.additionalUserInfo.profile. // OAuth access token can also be retrieved: // (authResult.credential as? OAuthCredential)?.accessToken // OAuth ID token can also be retrieved: // (authResult.credential as? OAuthCredential)?.idToken } } }Objective-C
// If you created a custom class that conforms to AuthUIDelegate, // pass it instead of nil: [provider getCredentialWithUIDelegate:nil completion:^(FIRAuthCredential *_Nullable credential, NSError *_Nullable error) { if (error) { // Handle error. } if (credential) { [[FIRAuth auth] signInWithCredential:credential completion:^(FIRAuthDataResult *_Nullable authResult, NSError *_Nullable error) { if (error) { // Handle error. } // User is signed in. // IdP data available in authResult.additionalUserInfo.profile. // OAuth access token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).accessToken // OAuth ID token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).idToken }]; } }];Хотя в примерах выше рассматриваются процессы входа, вы также можете связать поставщика OIDC с существующим пользователем с помощью
linkWithCredential. Например, вы можете связать несколько поставщиков с одним пользователем, чтобы он мог входить в систему с помощью любого из них.Swift
Auth().currentUser.link(withCredential: credential) { authResult, error in if error != nil { // Handle error. } // OIDC credential is linked to the current user. // IdP data available in authResult.additionalUserInfo.profile. // OAuth access token can also be retrieved: // (authResult.credential as? OAuthCredential)?.accessToken // OAuth ID token can also be retrieved: // (authResult.credential as? OAuthCredential)?.idToken }Objective-C
[[FIRAuth auth].currentUser linkWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error) { // Handle error. } // OIDC credential is linked to the current user. // IdP data available in authResult.additionalUserInfo.profile. // OAuth access token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).accessToken // OAuth ID token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).idToken }];Тот же шаблон можно использовать с
reauthenticateWithCredential, чтобы получить новые учетные данные для конфиденциальных операций, требующих недавнего входа.Swift
Auth().currentUser.reauthenticateWithCredential(withCredential: credential) { authResult, error in if error != nil { // Handle error. } // User is re-authenticated with fresh tokens minted and // should be able to perform sensitive operations like account // deletion and email or password update. // IdP data available in result.additionalUserInfo.profile. // Additional OAuth access token can also be retrieved: // (authResult.credential as? OAuthCredential)?.accessToken // OAuth ID token can also be retrieved: // (authResult.credential as? OAuthCredential)?.idToken }Objective-C
[[FIRAuth auth].currentUser reauthenticateWithCredential:credential completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { if (error) { // Handle error. } // User is re-authenticated with fresh tokens minted and // should be able to perform sensitive operations like account // deletion and email or password update. // IdP data available in result.additionalUserInfo.profile. // Additional OAuth access token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).accessToken // OAuth ID token can also be retrieved: // ((FIROAuthCredential *)authResult.credential).idToken }];
Как вручную управлять процессом входа
Если вы уже реализовали в приложении процесс входа с помощью OpenID Connect, то можете использовать токен идентификатора непосредственно для аутентификации в Firebase.
Swift
let credential = OAuthProvider.credential(
withProviderID: "oidc.example-provider", // As registered in Firebase console.
idToken: idToken, // ID token from OpenID Connect flow.
rawNonce: nil
)
Auth.auth().signIn(with: credential) { authResult, error in
if error {
// Handle error.
return
}
// User is signed in.
// IdP data available in authResult?.additionalUserInfo?.profile
}
Objective-C
FIROAuthCredential *credential =
[FIROAuthProvider credentialWithProviderID:@"oidc.example-provider" // As registered in Firebase console.
IDToken:idToken // ID token from OpenID Connect flow.
rawNonce:nil];
[[FIRAuth auth] signInWithCredential:credential
completion:^(FIRAuthDataResult * _Nullable authResult,
NSError * _Nullable error) {
if (error != nil) {
// Handle error.
return;
}
// User is signed in.
// IdP data available in authResult.additionalUserInfo.profile
}];
Дальнейшие действия
После первого входа пользователя создается новый аккаунт, который связывается с учетными данными, то есть именем пользователя и паролем, номером телефона или информацией от поставщика аутентификации, с помощью которых пользователь вошел в систему. Этот новый аккаунт сохраняется в проекте 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; }
Вы также можете добавить код обработки ошибок для всего диапазона ошибок аутентификации. Подробнее об обработке ошибок…