Autentica usuarios con Yahoo y Unity

Puedes permitir que los usuarios se autentiquen con Firebase mediante proveedores de OAuth, como Yahoo, integrando un acceso genérico de OAuth basado en la Web en tu app. Para ello, deberás usar el SDK de Firebase para completar el flujo de acceso de extremo a extremo. Dado que este flujo requiere el uso de los SDK de Firebase para teléfonos, solo es compatible con plataformas Android y Apple.

Antes de comenzar

Para poder usar Firebase Authentication, debes realizar los siguientes pasos:

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 (en específico, 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;

Maneja el flujo de acceso con el SDK de Firebase

Para controlar el flujo de acceso con el SDK de Firebase, sigue estos pasos:

Crea una instancia de un FederatedOAuthProviderData configurado con el ID de proveedor adecuado para Yahoo.

Firebase.Auth.FederatedOAuthProviderData providerData =
  new Firebase.Auth.FederatedOAuthProviderData();
providerData.ProviderId = Firebase.Auth.YahooAuthProvider.ProviderId;

Opcional: Especifica otros parámetros de OAuth personalizados que quieras enviar con la solicitud de OAuth.
```
providerData.CustomParameters = new Dictionary<string,string>;

// Prompt user to re-authenticate to Yahoo.
providerData.CustomParameters.Add("prompt", "login");

// Localize to French.
providerData.CustomParameters.Add("language", "fr");
```
Para conocer los parámetros que admite Yahoo, consulta la documentación de OAuth de Yahoo. Ten en cuenta que no puedes pasar los parámetros obligatorios de Firebase con custom_parameters(). Estos parámetros son client_id, redirect_uri, response_type, scope y state.
Opcional: Especifica permisos de OAuth 2.0 adicionales aparte de profile y email que desees solicitar al proveedor de autenticación. Si tu aplicación requiere acceso a los datos privados del usuario desde las APIs de Yahoo, deberás solicitar permisos a estas últimas en la sección API Permissions de la consola para desarrolladores de Yahoo. Los permisos de OAuth solicitados deben coincidir exactamente con los preconfigurados en los permisos de API de la app. Por ejemplo, si se solicita acceso de lectura y escritura a los contactos del usuario, y se preconfigura en los permisos de API de la app, debes pasar sdct-w en vez del permiso de OAuth de solo lectura sdct-r. De lo contrario, el flujo fallará y se mostrará un error al usuario final.
```
providerData.Scopes = new List<string>();

// Request access to Yahoo Mail API.
providerData.Scopes.Add("mail-r");
// This must be preconfigured in the app's API permissions.
providerData.Scopes.Add("sdct-w");
```
Para obtener más información, consulta la documentación de alcances de Yahoo.

Una vez que se hayan configurado los datos de tu proveedor, úsalos para crear un FederatedOAuthProvider.

// Construct a FederatedOAuthProvider for use in Auth methods.
Firebase.Auth.FederatedOAuthProvider provider =
    new Firebase.Auth.FederatedOAuthProvider();
provider.SetProviderData(providerData);

Autentica con Firebase mediante el objeto del proveedor de Auth. Ten en cuenta que, a diferencia de otras operaciones de FirebaseAuth, esta mostrará una vista web en la que el usuario puede ingresar sus credenciales y tomará el control de tu IU.

Para iniciar el flujo de acceso, llama a SignInAndRetrieveDataWithCredentialAsync:

<<../_includes/_sign_in_with_provider_unity.md>>>

Si bien los ejemplos anteriores se enfocan en los flujos de acceso, también puedes vincular un proveedor de Yahoo con un usuario existente mediante LinkWithProviderAsync. Por ejemplo, puedes vincular varios proveedores con el mismo usuario para permitirles acceder con cualquiera de estos.

user.LinkWithProviderAsync(provider).ContinueOnMainThread(task => {
    if (task.IsCanceled) {
        Debug.LogError("LinkWithProviderAsync was canceled.");
        return;
    }
    if (task.IsFaulted) {
        Debug.LogError("LinkWithProviderAsync encountered an error: "
          + task.Exception);
        return;
    }

    Firebase.Auth.AuthResult authResult = task.Result;
    Firebase.Auth.FirebaseUser user = authResult.User;
    Debug.LogFormat("User linked successfully: {0} ({1})",
        user.DisplayName, user.UserId);
});

Se puede utilizar el mismo patrón con ReauthenticateWithProviderAsync, que se puede usar a fin de recuperar credenciales nuevas para operaciones sensibles que requieren un acceso reciente.

user.ReauthenticateWithProviderAsync(provider).ContinueOnMainThread(task => {
    if (task.IsCanceled) {
        Debug.LogError("ReauthenticateWithProviderAsync was canceled.");
        return;
    }
    if (task.IsFaulted) {
        Debug.LogError(
        "ReauthenticateWithProviderAsync encountered an error: " +
            task.Exception);
        return;
    }

    Firebase.Auth.AuthResult authResult = task.Result;
    Firebase.Auth.FirebaseUser user = authResult.User;
    Debug.LogFormat("User reauthenticated successfully: {0} ({1})",
        user.DisplayName, user.UserId);
});

A diferencia de los proveedores de OAuth que admiten Firebase, como Google, Facebook y Twitter, en los que se puede lograr el acceso con credenciales de OAuth basadas en un token, Firebase Auth no admite la misma capacidad para los proveedores como Yahoo debido a la incapacidad del servidor de Firebase Auth para verificar el público de los tokens de acceso de OAuth de Yahoo. Este es un requisito de seguridad fundamental y podría exponer las aplicaciones y los sitios web a volver a reproducir ataques en los que el token de acceso de OAuth de Yahoo que se obtuvo para un proyecto (atacante) se puede usar para acceder a otro proyecto (víctima). En su lugar, Firebase Auth ofrece la capacidad de manejar todo el flujo de OAuth y el intercambio de códigos de autorización con el ID y secreto del cliente de OAuth configurados en Firebase console. Como el código de autorización solo se puede usar junto con un ID/secreto de cliente específico, no se puede usar un código de autorización obtenido para un proyecto con otro.

Si es necesario usar estos proveedores en entornos no admitidos, se requerirían una biblioteca de OAuth de terceros y la autenticación personalizada de Firebase. La primera es necesaria para autenticarse con el proveedor y la última para intercambiar la credencial del proveedor por un token personalizado.

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 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() de la siguiente manera:

auth.SignOut();