Cómo autenticar con Firebase mediante un sistema de autenticación personalizado y Unity

Puedes integrar Firebase Authentication con un sistema de autenticación personalizado. Para ello, cambia el servidor de autenticación para que genere tokens firmados personalizados cuando un usuario acceda de forma correcta. La app recibe este token y lo usa para realizar la autenticación en Firebase.

Antes de comenzar

    Para poder usar Firebase Authentication, debes crear un proyecto de Firebase y agregar los paquetes del SDK de Firebase Unity al proyecto de Unity.

    Configuración:

    Requisitos previos

    Android

    • Unity 5.0 o una versión más reciente
    • NDK de Android 10d o una versión más reciente

    iOS

    • Unity 5.0 o una versión más reciente
    • Xcode 8.0 o una versión más reciente

    Si todavía no tienes un proyecto de Unity, puedes descargar uno de los ejemplos de inicio rápido para probar una función de Firebase específica. Si usas un ejemplo de inicio rápido, recuerda consultar el identificador de paquete en la configuración del proyecto, ya que lo necesitarás en el próximo paso.

    Configura la app en Firebase console

    Para agregar Firebase a la app, debes tener un proyecto y un archivo de configuración de Firebase.

    Para crear un proyecto de Firebase:

    1. Crea un proyecto en Firebase console si no lo hiciste anteriormente. Haz clic en Agregar proyecto. Si ya tienes un proyecto de Google asociado con la app para dispositivos móviles, selecciónalo en el menú desplegable Nombre del proyecto. De lo contrario, escribe un nombre para crear un proyecto nuevo.
    2. Opcional: Edita el ID del proyecto. De manera automática se asigna un ID único al proyecto, que se usa públicamente en funciones visibles de Firebase, como las URL de bases de datos y tu subdominio de Firebase Hosting. Puedes cambiarlo en este momento si deseas usar un subdominio específico.
    3. Sigue los pasos de configuración restantes y haz clic en Crear proyecto (o Agregar Firebase si usas un proyecto existente) a fin de aprovisionar recursos para el proyecto. Este proceso suele tardar algunos minutos. Cuando finalice, verás la descripción general del proyecto.

    Android

    1. Haz clic en Agrega Firebase a tu app para Android y sigue los pasos de la configuración. Si importas un proyecto de Google existente, es posible que esto ocurra de forma automática y solo tengas que descargar el archivo de configuración.
    2. Ingresa el nombre del paquete de la app cuando se te solicite. Es importante que ingreses el nombre de paquete que usa la app. Esta configuración solo puede hacerse al agregar una app al proyecto de Firebase.
    3. Durante el proceso, descargarás un archivo google-services.json. Puedes volver a descargarlo en cualquier momento.
    4. Después de agregar el código de inicialización, ejecuta la app para verificar con Firebase console que instalaste Firebase correctamente.

    iOS

    1. Haz clic en Agrega Firebase a la app para iOS y sigue los pasos de configuración. Si importas un proyecto de Google existente, es posible que esto ocurra de forma automática y solo tengas que descargar el archivo de configuración.
    2. Ingresa el ID del paquete de la app cuando se te solicite. Es importante que ingreses el ID del paquete que usa la app. Esta configuración solo puede hacerse al agregar una app al proyecto de Firebase.
    3. Durante el proceso, descargarás un archivo GoogleService-Info.plist. Puedes volver a descargarlo en cualquier momento.
    4. Después de agregar el código de inicialización, ejecuta la app para verificar con Firebase console que instalaste Firebase correctamente.
    5. Arrastra el archivo GoogleService-Info.plist que se descargó de Firebase console a cualquier carpeta del proyecto de Unity.

    Agrega el SDK de Firebase Unity a la app

    1. Descarga el SDK de Firebase Unity.
    2. Selecciona el elemento de menú Recursos > Importar paquete > Paquete personalizado.
    3. Importa el paquete FirebaseAuth.unitypackage del SDK de Firebase Unity que descargaste previamente.
    4. Cuando aparezca la ventana Importar paquete de Unity, haz clic en el botón Importar.

    Inicializa el SDK

    El SDK de Firebase Unity en Android requiere los Servicios de Google Play actualizados. Se debe agregar el siguiente código al inicio de la aplicación para buscar y, de forma opcional, actualizar los Servicios de Google Play a la versión que requiera el SDK de Firebase Unity a fin de que sea posible llamar a otros métodos en el SDK.

    Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
      var dependencyStatus = task.Result;
      if (dependencyStatus == Firebase.DependencyStatus.Available) {
        // Create and hold a reference to your FirebaseApp, i.e.
        //   app = Firebase.FirebaseApp.DefaultInstance;
        // where app is a Firebase.FirebaseApp property of your application class.
    
        // Set a flag here indicating that Firebase is ready to use by your
        // application.
      } else {
        UnityEngine.Debug.LogError(System.String.Format(
          "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
        // Firebase Unity SDK is not safe to use here.
      }
    });
    

    Compila la app

    Android

    1. Selecciona la opción de menú Archivo > Configuración de compilación.
    2. Selecciona Android en la lista Plataforma.
    3. Haz clic en Cambiar plataforma para establecer Android como plataforma seleccionada.
    4. Espera a que se detenga el ícono giratorio (de compilación en proceso) que se encuentra en la esquina inferior derecha de la barra de estado de Unity.
    5. Haz clic en Compilar y ejecutar.

    iOS

    1. Selecciona la opción de menú Archivo > Configuración de compilación.
    2. Selecciona iOS en la lista Plataforma.
    3. Haz clic en Cambiar plataforma para establecer iOS como plataforma seleccionada.
    4. Espera a que se detenga el ícono giratorio (de compilación en proceso) que se encuentra en la esquina inferior derecha de la barra de estado de Unity.
    5. Haz clic en Compilar y ejecutar.

  • Obtén las claves del servidor del proyecto:
    1. Ve a la página Cuentas de servicio en la configuración del proyecto.
    2. Haz clic en Generar nueva clave privada en la parte inferior de la sección SDK de Firebase Admin de la página Cuentas de servicio.
    3. El par de claves públicas o privadas de la cuenta de servicio nueva se guarda de manera automática en la computadora. Copia este archivo en el servidor de autenticación.
  • Autentica con Firebase

    La clase FirebaseAuth es la puerta de enlace a todas las llamadas a la API. Se puede acceder a través de FirebaseAuth.DefaultInstance.
    Firebase.Auth.FirebaseAuth auth = Firebase.Auth.FirebaseAuth.DefaultInstance;
    

    Llama a Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync con el token del servidor de autenticación.

    1. Cuando los usuarios accedan a la app, envía sus credenciales de acceso (por ejemplo, el nombre de usuario y la contraseña) al servidor de autenticación. El servidor verificará las credenciales y mostrará un token personalizado siempre que sean válidas.
    2. Después de recibir el token personalizado del servidor de autenticación, pásalo a Firebase.Auth.FirebaseAuth.SignInWithCustomTokenAsync para que acceda el usuario:
      auth.SignInWithCustomTokenAsync(custom_token).ContinueWith(task => {
        if (task.IsCanceled) {
          Debug.LogError("SignInWithCustomTokenAsync was canceled.");
          return;
        }
        if (task.IsFaulted) {
          Debug.LogError("SignInWithCustomTokenAsync encountered an error: " + task.Exception);
          return;
        }
      
        Firebase.Auth.FirebaseUser newUser = task.Result;
        Debug.LogFormat("User signed in successfully: {0} ({1})",
            newUser.DisplayName, newUser.UserId);
      });
      

    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 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 las 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 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():

    auth.SignOut();

    Enviar comentarios sobre…

    ¿Necesitas ayuda? Visita nuestra página de asistencia.