Puedes usar Firebase Authentication para permitir que tus usuarios se autentiquen con Firebase mediante sus direcciones de correo electrónico y contraseñas, y para administrar las contraseñas y cuentas con contraseña de tu app.
Antes de comenzar
Antes de poder usar Firebase Authentication, tendrás que hacer lo siguiente:
Registra tu proyecto de Unity y configúralo para usar Firebase.
Si tu proyecto de Unity ya usa Firebase, significa que ya está registrado y configurado para Firebase.
Si aún no tienes un proyecto de Unity, puedes descargar una app de ejemplo.
Agrega el SDK de Firebase Unity (específicamente,
FirebaseAuth.unitypackage) a tu proyecto de Unity.
Ten en cuenta que agregar Firebase a tu proyecto de Unity implica realizar tareas en Firebase console y en tu proyecto abierto de Unity (por ejemplo, descargar archivos de configuración de Firebase desde la consola y moverlos a tu proyecto de Unity).
Accede a la clase Firebase.Auth.FirebaseAuth
La clase FirebaseAuth es la puerta de enlace para todas las llamadas a la API.
Se puede acceder a ella a través de FirebaseAuth.DefaultInstance.
Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
Crea una cuenta con contraseña
Para crear una cuenta de usuario nueva con una contraseña, sigue estos pasos en el código de acceso de la app:
- 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
FirebaseAuth.CreateUserWithEmailAndPassword:auth.CreateUserWithEmailAndPasswordAsync(email, password).ContinueWith(task => { if (task.IsCanceled) { Debug.LogError("CreateUserWithEmailAndPasswordAsync was canceled."); return; } if (task.IsFaulted) { Debug.LogError("CreateUserWithEmailAndPasswordAsync encountered an error: " + task.Exception); return; } // Firebase user has been created. Firebase.Auth.AuthResult result = task.Result; Debug.LogFormat("Firebase user created successfully: {0} ({1})", result.User.DisplayName, result.User.UserId); });
Haz que los usuarios accedan 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 función de acceso de tu app, haz lo siguiente:
- Cuando un usuario acceda a tu app, pasa la dirección de correo electrónico y la contraseña a
FirebaseAuth.SignInWithEmailAndPassword:auth.SignInWithEmailAndPasswordAsync(email, password).ContinueWith(task => { if (task.IsCanceled) { Debug.LogError("SignInWithEmailAndPasswordAsync was canceled."); return; } if (task.IsFaulted) { Debug.LogError("SignInWithEmailAndPasswordAsync encountered an error: " + task.Exception); return; } Firebase.Auth.AuthResult result = task.Result; Debug.LogFormat("User signed in successfully: {0} ({1})", result.User.DisplayName, result.User.UserId); }); - También puedes crear la credencial y acceder como en los otros flujos de trabajo:
Firebase.Auth.Credential credential = Firebase.Auth.EmailAuthProvider.GetCredential(email, password); auth.SignInAndRetrieveDataWithCredentialAsync(credential).ContinueWith(task => { if (task.IsCanceled) { Debug.LogError("SignInAndRetrieveDataWithCredentialAsync was canceled."); return; } if (task.IsFaulted) { Debug.LogError("SignInAndRetrieveDataWithCredentialAsync encountered an error: " + task.Exception); return; } Firebase.Auth.AuthResult result = task.Result; Debug.LogFormat("User signed in successfully: {0} ({1})", result.User.DisplayName, result.User.UserId); });
Recomendado: Establece una política de contraseñas
Puedes mejorar la seguridad de las cuentas aplicando requisitos de complejidad para las contraseñas.
Para configurar una política de contraseñas para tu proyecto, abre la pestaña Política de contraseñas en la página Configuración de autenticación de la consola de Firebase:
Configuración de autenticación
Las políticas de contraseñas de Firebase Authentication admiten los siguientes requisitos:
Se requiere un carácter en minúscula.
Se requiere un carácter en mayúscula.
Se requiere un carácter numérico.
Se requiere un carácter que no sea alfanumérico.
Los siguientes caracteres cumplen con el requisito de caracteres no alfanuméricos:
^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~Longitud mínima de la contraseña (oscila entre 6 y 30 caracteres; el valor predeterminado es 6)
Longitud máxima de la contraseña (longitud máxima de 4,096 caracteres)
Puedes habilitar la aplicación forzosa de la política de contraseñas en dos modos:
Obligatorio: Los intentos de registro fallarán hasta que el usuario actualice su contraseña de acuerdo con tu política.
Notificación: Los usuarios pueden registrarse con una contraseña que no cumple con los requisitos. Cuando uses este modo, debes verificar si la contraseña del usuario cumple con la política del cliente y pedirle de alguna manera que la actualice si no es así.
Los usuarios nuevos siempre deben elegir una contraseña que cumpla con tu política.
Si tienes usuarios activos, te recomendamos que no habilites la actualización forzosa en el acceso, a menos que pretendas bloquear el acceso a los usuarios cuyas contraseñas no satisfagan tu política. En su lugar, usa el modo de notificación, que permite a los usuarios acceder con sus contraseñas actuales y les informa los requisitos que no cumple su contraseña.
Recomendado: Habilita la protección de enumeración de correo electrónico
Algunos métodos de Firebase Authentication que toman direcciones de correo electrónico como parámetros producen errores específicos si la dirección de correo electrónico no está registrada cuando debe estarlo (por ejemplo, cuando se accede con una dirección de correo electrónico y una contraseña) o si está registrada cuando no debe estar en uso (por ejemplo, cuando se cambia la dirección de correo electrónico de un usuario). Si bien esto puede ser útil para sugerir soluciones específicas a los usuarios, también puede usarse de forma inadecuada por actores maliciosos que quieren descubrir las direcciones de correo electrónico registradas por tus usuarios.
Para mitigar este riesgo, te recomendamos habilitar la protección de enumeración de correo electrónico
para tu proyecto con la herramienta gcloud de Google Cloud. Ten en cuenta que habilitar esta
función cambia el comportamiento de los informes de errores de Firebase Authentication, así que asegúrate de que tu app
no dependa de los errores más específicos.
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) 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
Firebase.Auth.FirebaseUser.Firebase.Auth.FirebaseUser user = auth.CurrentUser; if (user != null) { string name = user.DisplayName; string email = user.Email; System.Uri photo_url = user.PhotoUrl; // The user's Id, unique to the Firebase project. // Do NOT use this value to authenticate with your backend server, if you // have one; use User.TokenAsync() instead. string uid = user.UserId; } 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
authy usarlo para controlar a qué datos podrá acceder.
Para permitir que los usuarios accedan a tu app mediante 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() de la siguiente manera:
auth.SignOut();