Autentica con Firebase mediante cuentas basadas en contraseña en iOS

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

Antes de comenzar

Agrega Firebase al proyecto de iOS. Incluye los siguientes pods en tu Podfile:
```
pod 'Firebase/Auth'
```
Si aún no conectaste la app al proyecto de Firebase, puedes hacerlo desde Firebase console.
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 basada en contraseña

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

Importa el módulo de Firebase en tu UIApplicationDelegate:
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de tu aplicación:
Swift
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Objective-C
```
// Use Firebase library to configure APIs
[FIRApp configure];
```
Cuando un usuario nuevo se registre mediante el formulario de registro de tu app, completa todos los pasos de validación de cuentas nuevas que necesite tu app (como verificar que la contraseña esté escrita correctamente y cumpla con los requisitos de complejidad).

Pasa la dirección de correo electrónico y la contraseña del usuario nuevo a createUserWithEmail:email:password:completion: para crear la cuenta nueva:

Swift

Auth.auth().createUser(withEmail: email, password: password) { (authResult, error) in
  // ...
  guard let user = authResult?.user else { return }
}

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.

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

Importa el módulo de Firebase en tu UIApplicationDelegate:
Swift
```
import Firebase
```
Objective-C
```
@import Firebase;
```
Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de tu aplicación:
Swift
```
// Use Firebase library to configure APIs
FirebaseApp.configure()
```
Objective-C
```
// Use Firebase library to configure APIs
[FIRApp configure];
```

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

Swift

Auth.auth().signIn(withEmail: email, password: password) { (user, error) in
  // ...
}

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.

Próximos pasos

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) con las que accedió el usuario. Esta cuenta nueva se almacena como parte del proyecto de Firebase y puede usarse para identificar a un usuario en todas las apps del proyecto, sin importar el método de acceso que se use.

En las apps, puedes obtener la información básica de perfil del usuario a partir del objeto FIRUser. Consulta Cómo administrar usuarios.
En las reglas de seguridad de Firebase Realtime Database y Cloud Storage, puedes obtener el ID único del usuario que accedió a partir de la variable auth, y usarlo para controlar los datos a los que tiene acceso.

Para permitir que los usuarios accedan a tu app con varios proveedores de autenticación, puedes vincular las credenciales de proveedores de autenticación 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 administración de errores para todos los errores de autenticación. Consulta Maneja errores.