Autenticarse con Firebase usando cuentas basadas en contraseña en plataformas Apple

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.

Visite nuestra guía de instalación para conocer las diferentes formas en que puede agregar SDK de Firebase a su proyecto de Apple, incluida la importación de marcos directamente y el uso de CocoaPods.

1. En Xcode, con su proyecto de aplicación abierto, vaya a Archivo > Agregar paquetes .
2. Cuando se le solicite, agregue el repositorio del SDK de las plataformas Apple de Firebase:

  https://github.com/firebase/firebase-ios-sdk

Nota: Los nuevos proyectos deben usar la versión SDK predeterminada (más reciente), pero puede elegir una versión anterior si es necesario.
3. Elija la biblioteca de autenticación de Firebase.
4. Cuando termine, Xcode comenzará a resolver y descargar automáticamente sus dependencias en segundo plano.

A continuación, realice algunos pasos de configuración:

1. Si aún no ha conectado su aplicación a su proyecto de Firebase, hágalo desde la consola de Firebase .
2. Habilitar inicio de sesión con correo electrónico/contraseña:
   1. En Firebase console , abra la sección Auth .
   2. 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:

1. Importe el módulo FirebaseCore en su UIApplicationDelegate , 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;
   // ...
         

2. Configure una instancia compartida de FirebaseApp en el método application(_: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];

3. Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de App a través UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . 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()
         }
       }
     }
   }
         

4. 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.
5. Cree una nueva cuenta pasando la dirección de correo electrónico y la contraseña del nuevo usuario a createUser .

   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) {
     // ...
   }];

   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.

Para proteger su proyecto de abusos, Firebase limita la cantidad de nuevos correos electrónicos/contraseñas y registros anónimos que su aplicación puede tener desde la misma dirección IP en un período corto de tiempo. Puede solicitar y programar cambios temporales en esta cuota desde Firebase console .

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:

1. Importe el módulo FirebaseCore en su UIApplicationDelegate , 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;
   // ...
         

2. Configure una instancia compartida de FirebaseApp en el método application(_: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];

3. Si usa SwiftUI, debe crear un delegado de aplicación y adjuntarlo a su estructura de App a través UIApplicationDelegateAdaptor o NSApplicationDelegateAdaptor . 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()
         }
       }
     }
   }
         

4. 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 .

   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) {
     // ...
   }];

   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.

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 .