Puede usar Firebase Authentication para permitir que sus usuarios se autentiquen con Firebase usando sus direcciones de correo electrónico y contraseñas, y para administrar las cuentas basadas en contraseñas de su aplicación.
Antes de que empieces
Use Swift Package Manager para instalar y administrar las dependencias de Firebase.
- En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
- Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:
- Elija la biblioteca de autenticación de Firebase.
- Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.
https://github.com/firebase/firebase-ios-sdk
A continuación, realice algunos pasos de configuración:
- Si aún no ha conectado su aplicación a su proyecto de Firebase, hágalo desde la consola de Firebase .
- Habilitar inicio de sesión con correo electrónico/contraseña:
- En Firebase console , abra la sección Auth .
- En la pestaña Método de inicio de sesión, habilite el método de inicio de sesión con correo electrónico/contraseña y haga clic en Guardar .
Crear una cuenta basada en contraseña
Para crear una nueva cuenta de usuario con una contraseña, complete los siguientes pasos en la actividad de inicio de sesión de su aplicación:
- Importe el módulo
FirebaseCore
en suUIApplicationDelegate
, así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rápido
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
C objetivo
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure una instancia compartida de
FirebaseApp
en el métodoapplication(_:didFinishLaunchingWithOptions:)
del delegado de su aplicación:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Rápido
// Use Firebase library to configure APIs FirebaseApp.configure()
C objetivo
// Use Firebase library to configure APIs [FIRApp configure];
- Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de
App
a travésUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Cuando un nuevo usuario se registre mediante el formulario de registro de su aplicación, complete todos los pasos de validación de la nueva cuenta que requiera su aplicación, como verificar que la contraseña de la nueva cuenta se haya ingresado correctamente y cumpla con sus requisitos de complejidad.
- Cree una nueva cuenta pasando la dirección de correo electrónico y la contraseña del nuevo usuario a
createUser
.Si la nueva cuenta se creó correctamente, el usuario inicia sesión y puede obtener los datos de la cuenta del usuario del objeto de resultado que se pasa al método de devolución de llamada.Rápido
Auth.auth().createUser(withEmail: email, password: password) { authResult, error in // ... }
C objetivo
[[FIRAuth auth] createUserWithEmail:email password:password completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { // ... }];
Inicie sesión como usuario con una dirección de correo electrónico y una contraseña
Los pasos para iniciar sesión como usuario con contraseña son similares a los pasos para crear una cuenta nueva. En la actividad de inicio de sesión de su aplicación, haga lo siguiente:
- Importe el módulo
FirebaseCore
en suUIApplicationDelegate
, así como cualquier otro módulo de Firebase que use el delegado de su aplicación. Por ejemplo, para usar Cloud Firestore y autenticación:SwiftUI
import SwiftUI import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
Rápido
import FirebaseCore import FirebaseFirestore import FirebaseAuth // ...
C objetivo
@import FirebaseCore; @import FirebaseFirestore; @import FirebaseAuth; // ...
- Configure una instancia compartida de
FirebaseApp
en el métodoapplication(_:didFinishLaunchingWithOptions:)
del delegado de su aplicación:SwiftUI
// Use Firebase library to configure APIs FirebaseApp.configure()
Rápido
// Use Firebase library to configure APIs FirebaseApp.configure()
C objetivo
// Use Firebase library to configure APIs [FIRApp configure];
- Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de
App
a travésUIApplicationDelegateAdaptor
oNSApplicationDelegateAdaptor
. También debe deshabilitar el intercambio de delegados de aplicaciones. Para obtener más información, consulte las instrucciones de SwiftUI .SwiftUI
@main struct YourApp: App { // register app delegate for Firebase setup @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate var body: some Scene { WindowGroup { NavigationView { ContentView() } } } }
- Cuando un usuario inicie sesión en su aplicación, pase la dirección de correo electrónico y la contraseña del usuario para
signIn
.Si el usuario inicia sesión correctamente, puede obtener los datos de la cuenta del usuario del objeto de resultado que se pasa al método de devolución de llamada.Rápido
Auth.auth().signIn(withEmail: email, password: password) { [weak self] authResult, error in guard let strongSelf = self else { return } // ... }
C objetivo
[[FIRAuth auth] signInWithEmail:self->_emailField.text password:self->_passwordField.text completion:^(FIRAuthDataResult * _Nullable authResult, NSError * _Nullable error) { // ... }];
Recomendado: habilite la protección de enumeración de correo electrónico
Algunos métodos de autenticación de Firebase que toman direcciones de correo electrónico como parámetros arrojan errores específicos si la dirección de correo electrónico no está registrada cuando debe estar registrada (por ejemplo, al iniciar sesión con una dirección de correo electrónico y contraseña) o registrada cuando no debe usarse (por ejemplo, al cambiar la dirección de correo electrónico de un usuario). Si bien esto puede ser útil para sugerir remedios específicos a los usuarios, los actores maliciosos también pueden abusar de él para descubrir las direcciones de correo electrónico registradas por sus usuarios.
Para mitigar este riesgo, le recomendamos que habilite la protección de enumeración de correo electrónico para su proyecto mediante la herramienta gcloud
de Google Cloud. Tenga en cuenta que habilitar esta función cambia el comportamiento de informe de errores de Firebase Authentication: asegúrese de que su aplicación no dependa de los errores más específicos.
Próximos pasos
Después de que un usuario inicia sesión por primera vez, se crea una nueva cuenta de usuario y se vincula a las credenciales (es decir, el nombre de usuario y la contraseña, el número de teléfono o la información del proveedor de autenticación) con las que el usuario inició sesión. Esta nueva cuenta se almacena como parte de su proyecto de Firebase y se puede usar para identificar a un usuario en cada aplicación de su proyecto, independientemente de cómo inicie sesión el usuario.
En sus aplicaciones, puede obtener la información básica del perfil del
User
del objeto Usuario. Consulte Administrar usuarios .En sus Reglas de seguridad de Firebase Realtime Database y Cloud Storage, puede obtener el ID de usuario único del usuario que inició sesión de la variable
auth
y usarlo para controlar a qué datos puede acceder un usuario.
Puede permitir que los usuarios inicien sesión en su aplicación utilizando varios proveedores de autenticación vinculando las credenciales del proveedor de autenticación a una cuenta de usuario existente.
Para cerrar la sesión de un usuario, llame signOut:
.
Rápido
let firebaseAuth = Auth.auth() do { try firebaseAuth.signOut() } catch let signOutError as NSError { print("Error signing out: %@", signOutError) }
C objetivo
NSError *signOutError; BOOL status = [[FIRAuth auth] signOut:&signOutError]; if (!status) { NSLog(@"Error signing out: %@", signOutError); return; }
También es posible que desee agregar un código de manejo de errores para la gama completa de errores de autenticación. Consulte Manejo de errores .