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.
- En Xcode, con tu proyecto de app abierto, navega a File > Add Packages.
- Cuando se te solicite, agrega el repositorio del SDK de Firebase para plataformas de Apple:
- Elige la biblioteca de Firebase Authentication.
- Cuando termines, Xcode comenzará a resolver y descargar automáticamente tus dependencias en segundo plano.
https://github.com/firebase/firebase-ios-sdk
A continuación, debes realizar los siguientes pasos de configuración:
- 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:
- En Firebase console, abre la sección Auth.
- En la pestaña Sign in method, 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:
- Importa el módulo
FirebaseCore
en tuUIApplicationDelegate
, 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; // ...
- Configura una
instancia compartida
de
FirebaseApp
, generalmente en el inicializador deApp
o en el métodoapplication(_: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];
- 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.
- 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) { // ... }];
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:
- Importa el módulo
FirebaseCore
en tuUIApplicationDelegate
, 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; // ...
- Configura una
instancia compartida
de
FirebaseApp
, generalmente en el inicializador deApp
o en el métodoapplication(_: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];
- 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) { // ... }];
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 administración de errores para todos los errores de autenticación. Consulta cómo solucionar errores.