Autentica 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 tu servidor de autenticación para que genere tokens firmados personalizados cuando un usuario acceda de forma correcta. Tu 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 a tu 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 7.0 o una versión más reciente

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

    Configura tu app en Firebase console

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

    Crea un proyecto en Firebase console si no lo hiciste antes. Si ya tienes un proyecto de Google asociado con tu app para dispositivos móviles, haz clic en Importar proyecto de Google. De lo contrario, haz clic en Agregar proyecto.

    Android

    1. Haz clic en Agrega Firebase a tu app para Android y sigue los pasos de la configuración. Si estás importando un proyecto de Google existente, es posible que esto suceda 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 del paquete que usa tu app. Esto solo se puede configurar cuando agregas una app a tu proyecto de Firebase.
    3. Descarga un archivo google-services.json cuando se te indique. Puedes volver a descargar este archivo en cualquier momento.
    4. Copia este archivo en cualquier ubicación de la carpeta de elementos de tu proyecto.

    iOS

    1. Haz clic en Agrega Firebase a tu app para iOS y sigue los pasos para ajustar la configuración. Si estás importando un proyecto de Google existente, es posible que esto suceda 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 tu app. Esto solo se puede configurar cuando agregas una app a tu proyecto de Firebase.
    3. Descarga un archivo GoogleService-Info.plist cuando se te indique. Puedes volver a descargar este archivo en cualquier momento.
    4. Agrega el archivo GoogleService-Info.plist al proyecto.

    5. Arrastra el GoogleService-Info.plist que descargaste de Firebase console a cualquier carpeta del proyecto de Unity.

    Agrega el SDK de Firebase Unity a tu app

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

    Compila tu app

    Android

    1. Selecciona la opción de menú File > Build Settings.
    2. Selecciona Android en la lista Platform.
    3. Haz clic en Switch Platform para elegir Android como plataforma seleccionada.
    4. Espera hasta 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 Build and Run.

    iOS

    1. Selecciona la opción de menú File > Build Settings.
    2. Selecciona iOS en la lista Platform.
    3. Haz clic en Switch Platform para elegir iOS como plataforma seleccionada.
    4. Espera hasta 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 Build and Run.

  1. Obtén las claves del servidor de tu proyecto:
    1. Ve a la página Cuentas de servicio en la configuración de tu proyecto.
    2. Haz clic en Generar nueva clave privada en la parte inferior de la sección SDK de administrador de Firebase 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 tu computadora. Copia este archivo en tu servidor de autenticación.

Autentica con Firebase

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

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

  1. Cuando los usuarios acceden a tu app, envía sus credenciales de acceso (por ejemplo, el nombre de usuario y la contraseña) a tu servidor de autenticación. Tu servidor verifica las credenciales y devuelve un token personalizado si son válidas.
  2. Después de recibir el token personalizado de tu 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);
    });
    

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) con las que el usuario accedió. 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 de tu 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 las reglas de seguridad de Firebase Realtime Database y de 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 la 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.