Autentica con Firebase mediante cuentas con contraseña en plataformas de Apple

Puedes usar Firebase Authentication para permitir que los usuarios se autentiquen con Firebase mediante su dirección de correo electrónico y contraseña, y para administrar las cuentas con contraseña de tu app.

Antes de comenzar

Usa Swift Package Manager para instalar y administrar las dependencias de Firebase.

Consulta nuestra guía de instalación para descubrir las diferentes formas en que puedes agregar los SDK de Firebase a tu proyecto de Apple, como importar frameworks directamente y usar CocoaPods.

1. En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.
2. Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:

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

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

A continuación, debes realizar los siguientes pasos de configuración:

1. Si aún no conectaste la app al proyecto de Firebase, puedes hacerlo desde Firebase console.
2. Habilita el acceso con correo electrónico y contraseña:
   1. En Firebase console, abre la sección Auth.
   2. En la pestaña Método de acceso, habilita el método de acceso Correo electrónico/contraseña y haz clic en Guardar.

Crea una cuenta con contraseña

Para crear una cuenta de usuario nueva con una contraseña, sigue estos pasos en la actividad de acceso de la app:

1. Importa el módulo FirebaseCore en tu UIApplicationDelegate, así como cualquier otro módulo de Firebase que use el delegado de la app. Por ejemplo, para usar Cloud Firestore y Authentication:

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective‑C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configura una instancia compartida de FirebaseApp, generalmente en el inicializador de App o en el método application(_:didFinishLaunchingWithOptions:) del delegado de la app:

   Swift

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

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Cuando un usuario nuevo se registre mediante el formulario de registro de la app, realiza los pasos de validación de la cuenta nueva necesarios, como verificar que se haya escrito correctamente la contraseña y que cumpla con los requisitos de complejidad.
4. Para crear una cuenta nueva, pasa la dirección de correo electrónico y la contraseña del usuario nuevo a createUserWithEmail:email:password:completion:.

   Swift

   Auth.auth().createUser(withEmail: email, password: password) { authResult, error in
     // ...
   }

   Objective-C

   [[FIRAuth auth] createUserWithEmail:email
                              password:password
                            completion:^(FIRAuthDataResult * _Nullable authResult,
                                         NSError * _Nullable error) {
     // ...
   }];

   Si se creó una cuenta nueva con éxito, se inicia la sesión del usuario y puedes obtener los datos de su cuenta desde el objeto Resultado que se pasa al método de devolución de llamada.

Para proteger tu proyecto de abusos, Firebase limita la cantidad de registros de usuarios nuevos (ya sean anónimos o con correo electrónico y contraseña) que tu aplicación puede recibir desde una misma dirección IP en un período breve. Puedes solicitar y programar cambios temporales para esta cuota desde Firebase console.

Permite que un usuario acceda con una dirección de correo electrónico y una contraseña

Los pasos para que un usuario acceda con una contraseña son similares a los pasos para crear una cuenta nueva. En la actividad de acceso de tu app, haz lo siguiente:

1. Importa el módulo FirebaseCore en tu UIApplicationDelegate, así como cualquier otro módulo de Firebase que use el delegado de la app. Por ejemplo, para usar Cloud Firestore y Authentication:

   Swift

   import FirebaseCore
   import FirebaseFirestore
   import FirebaseAuth
   // ...
         

   Objective‑C

   @import FirebaseCore;
   @import FirebaseFirestore;
   @import FirebaseAuth;
   // ...
         

2. Configura una instancia compartida de FirebaseApp, generalmente en el inicializador de App o en el método application(_:didFinishLaunchingWithOptions:) del delegado de la app:

   Swift

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

   Objective-C

   // Use Firebase library to configure APIs
   [FIRApp configure];

3. Cuando un usuario acceda a tu app, pasa la dirección de correo electrónico y la contraseña a signInWithEmail:email:password:completion:.

   Swift

   Auth.auth().signIn(withEmail: email, password: password) { [weak self] authResult, error in
     guard let strongSelf = self else { return }
     // ...
   }

   Objective-C

   [[FIRAuth auth] signInWithEmail:self->_emailField.text
                          password:self->_passwordField.text
                        completion:^(FIRAuthDataResult * _Nullable authResult,
                                     NSError * _Nullable error) {
     // ...
   }];

   Si el usuario accede correctamente, puedes obtener los datos de la cuenta desde el objeto Resultado que se pasa al método de devolución de llamada.

Pasos siguientes

Cuando un usuario accede por primera vez, se crea una cuenta de usuario nueva y se la vincula con las credenciales (el nombre de usuario y la contraseña, el número de teléfono o la información del proveedor de autenticación) que el usuario utilizó para acceder. Esta cuenta nueva se almacena como parte de tu proyecto de Firebase y se puede usar para identificar a un usuario en todas las apps del proyecto, sin importar cómo acceda.

• En tus apps, puedes obtener la información básica de perfil del usuario a partir del objeto FIRUser. Consulta Administrar usuarios.

• En tus reglas de seguridad de Firebase Realtime Database y Cloud Storage, puedes obtener el ID del usuario único que accedió a partir de la variable auth y usarlo para controlar a qué datos podrá acceder.

Para permitir que los usuarios accedan a la app con varios proveedores de autenticación, puedes vincular las credenciales de estos proveedores con una cuenta de usuario existente.

Para salir de la sesión de un usuario, llama a 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;
}

Tal vez sea conveniente que agregues código de manejo de errores para todos los errores de autenticación. Consulta cómo solucionar errores.