Almacenamiento de PlayFab

Si utiliza el almacenamiento de PlayFab, tendrá acceso a:

• registro de usuario
• autenticación mediante dirección de correo electrónico y contraseña de usuario
• autenticación mediante Twitch
• restablecimiento de contraseña de usuario
• bloqueo de usuarios

Flujo de interacción

Puede utilizar el widget de Login o su aplicación como un cliente. El flujo de interacción entre el cliente y el servidor de Xsolla Login es el siguiente:

1. El cliente envía solicitudes al servidor de Xsolla Login. El formato de las solicitudes se describe en los puntos finales JWT, OAuth 2.0 y Password.
2. El servidor de Xsolla Login envía solicitudes a PlayFab.
3. El servidor de Xsolla Login procesa una respuesta de PlayFab y devuelve los resultados al cliente.
4. El cliente procesa la respuesta.

Registro de usuarios en PlayFab

El registro de usuarios sigue este flujo. Puede establecer el correo electrónico de confirmación de cuenta que sus usuarios reciben al finalizar su registro.

Flujo de registro de usuarios

1. El cliente envía la solicitud Register new user al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía una solicitud de registro.
3. Los datos del usuario se escriben en la base de datos de Xsolla.
4. El servidor de Xsolla Login envía una solicitud a PlayFab para cambiar los datos del usuario.
5. Si ha establecido la confirmación de cuenta:
   • Cuando utilice las llamadas API de Login para integrar la solución, el registro se considera realizado.
   • Cuando utiliza el widget de Login para integrar la solución, el usuario es redirigido a una página con el siguiente mensaje: El correo electrónico de confirmación de cuenta se envía a {email address}.
   Si no ha establecido la confirmación de cuenta, el usuario inicia sesión automáticamente tras el registro.

Confirmación de cuentas de usuario en PlayFab

1. Siga las instrucciones para establecer su proyecto en PlayFab.
2. Asegúrese de haber completado los pasos Crear una plantilla de correo electrónico y Crear una regla para enviar un correo electrónico cuando se actualice el correo electrónico de un contacto del módulo Requirements.
3. Contacto con su gestor del éxito del cliente o envíe un correo electrónico a csm@xsolla.com.

Autenticación mediante dirección de correo electrónico y contraseña del usuario

Existen dos tipos de autenticación mediante dirección de correo electrónico y contraseña del usuario: autenticación basada en el estándar JWT y autenticación basada en el protocolo OAuth 2.0.

Flujo de autenticación basado en el estándar JWT

1. El cliente envía la solicitud Auth by username and password al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía la solicitud de autenticación a PlayFab.
3. El servidor de Xsolla Login genera un JWT de usuario, mientras que:
   • El valor PlayFabId de la respuesta a la solicitud de PlayFab está escrito en la solicitud external_account_id.
   • El valor SessionTicket de la respuesta a la solicitud de PlayFab está escrito en la notificación session_ticket.
   • Los valores EntityToken de la respuesta a la solicitud de PlayFab están escritos en las notificaciones entity_token, entity_id, entity_type.
4. Al usuario se le redirige a login_url con un parámetro de consulta token. El JWT de usuario está escrito en el parámetro token.

Flujo de autenticación basado en el protocolo OAuth 2.0

1. El cliente envía la solicitud Auth by username and password con el parámetro redirect_uri al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía la solicitud de autenticación a PlayFab.
3. El servidor de Xsolla Login devuelve login_url junto con code en el parámetro de consulta y el parámetro redirect_uri transmitido.
4. El usuario es redirigido a redirect_uri con el parámetro de consulta code.
5. El cliente envía la solicitud Generate JWT al servidor de Xsolla Login para intercambiar el code recibido por un JWT de usuario.
6. El servidor de Xsolla Login genera un JWT de usuario, mientras que:
   • El valor PlayFabId de la respuesta a la solicitud PlayFab se escribe en la solicitud external_account_id.
   • El valor SessionTicket de la respuesta a la solicitud de PlayFab se escribe en la notificación session_ticket si se ha transmitido scope=playfab a la solicitud Auth by username and password.
   • Los valores EntityToken de la respuesta a la solicitud de PlayFab se escriben en las notificaciones entity_token, entity_id, entity_type.

Autenticación mediante Twitch

Debe establecer una red social en PlayFab para autenticar usuarios a través de Twitch. Hay dos tipos de autenticación mediante Twitch: autenticación basada en el estándar JWT y otra basada en el protocolo OAuth 2.0.

Flujo de autenticación basado en el estándar JWT

1. El cliente envía la solicitud Auth by username and password al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía la solicitud de autenticación a PlayFab.
3. Los datos de usuario se escriben en la base de datos de Xsolla.
4. El servidor de Xsolla Login genera un JWT de usuario, mientras que:
   • El valor PlayFabId de la respuesta a la solicitud de PlayFab se escribe en la solicitud external_account_id.
   • El valor SessionTicket de la respuesta a la solicitud de PlayFab está escrito en la notificación session_ticket.
   • Los valores EntityToken de la respuesta a la solicitud de PlayFab se escriben en las notificaciones entity_token, entity_id, entity_type.
5. Al usuario se le redirige a login_url con un parámetro de consulta token. El JWT de usuario se escribe en el parámetro token.

Flujo de autenticación basado en el protocolo OAuth 2.0

1. El cliente envía la solicitud Auth by username and password con el parámetro redirect_uri al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía la solicitud de autenticación a PlayFab.
3. Los datos de usuario se escriben en la base de datos de Xsolla.
4. El servidor de Xsolla Login envía la solicitud para cambiar los datos en Playfab.
5. Al usuario se le redirige a redirect_uri con el parámetro de consulta code. El usuario es redirigido a redirect_uri con el parámetro de consulta code.
6. El cliente envía la solicitud Generate JWT al servidor de Xsolla Login para cambiar el code recibido por un JWT de usuario.
7. El servidor de Xsolla Login genera un JWT de usuario, mientras que:
   • El valor PlayFabId de la respuesta a la solicitud PlayFab se escribe en la notificación external_account_id.
   • El valor SessionTicket de la respuesta a la solicitud de PlayFab se escribe en la notificación session_ticket si ha transmitido scope=playfab a la solicitud Twitch authentication request.
   • Los valores EntityToken de la respuesta a la solicitud de PlayFab se escriben en las notificaciones entity_token, entity_id, entity_type.

Establecer la autenticación mediante Twitch

1. Cree su cuenta de Twitch y obtenga un ID de cliente de Twitch.
2. Vaya a Cuenta del editor y abra your project > Login.
3. Haga clic en Configure en el panel del proyecto de Login requerido.
4. Vaya al bloque Authentication y seleccione la sección Social login.
5. Vaya al panel de la red social Twitch, haga clic en el icono ⚙ y seleccione Configuración.
6. Introduzca su ID de cliente de Twitch en el campo ID de aplicación.
7. Si es necesario, cambie otros ajustes.
8. Haga clic en Conectar.
9. Configure Twitch en su cuenta de PlayFab.
10. Si ha integrado el producto Login a través de las llamadas de Login API:
    1. Obtenga un enlace para la autenticación a través de Twitch. Para ello, utilice la llamada de autenticación de la red social (JWT o OAuth 2.0).
    2. Coloque el enlace recibido en la interfaz de su aplicación.

Restablecimiento de contraseña de usuario

El flujo de restablecimiento de contraseña de usuario es el siguiente:

1. El cliente envía la solicitud Reset password al servidor de Xsolla Login.
2. El servidor de Xsolla Login envía la solicitud de restablecimiento de contraseña a PlayFab.
3. La contraseña actualizada se escribe en PlayFab.

Bloqueo de usuarios

Puede bloquear usuarios a través de Cuenta del editor. Los usuarios bloqueados no pueden autenticarse. El bloqueo se registrará y guardará solo en el lado de Xsolla.

Seguir leyendo