Flujo del usuario

1. El usuario se dirige a Web Shop con la autenticación de ID de usuario establecida.
2. El usuario se autentica en Web Shop de una de las siguientes formas:
   • El usuario introduce su ID en el bloque de Fast Login y pulsa en el botón de inicio de sesión.
   • El usuario pulsa en el botón de compra del artículo seleccionado o en el botón de inicio de sesión de la barra superior:
     1. Se abre una ventana modal para introducir el ID de usuario o iniciar sesión a través de una red social.
     2. El usuario introduce su ID y pulsa en Continue o pulsa en el icono de redes sociales para elegir una red social y realiza la autenticación en la página de la red social.

3. El sistema verifica si existe un usuario en el juego. Si existe un usuario con este ID o cuenta de red social en el juego, el usuario es autenticado en Web Shop. En caso contrario, aparece un mensaje de error.

Cómo conseguirlo

1. En el lado de su aplicación, implemente el control del webhook de validación de usuarios.

Al recibir un webhook, la aplicación debe hacer lo siguiente:

• Buscar un usuario por su ID transmitido en el webhook.
• En función del resultado, enviar uno de los siguientes códigos de estado:
  • código HTTP 200 HTTP con una respuesta del webhook si se encuentra un usuario
  • código HTTP 404 si no se encuentra el ID de usuario
• Enviar atributos de usuario para la personalización.

2. Abra su proyecto en Cuenta del editor.
3. En la barra lateral haga clic en Site Builder.
4. Haga clic en Open Site Builder.
5. Inserte el siguiente código en el bloque Login Settings:

6. Seleccione la opción de User ID.

7. En la lista desplegable, seleccione New Login.

8. Introduzca la URL para recibir webhooks.

9. Establezca la autorización a través de redes sociales ya conectadas a su aplicación (opcional):
   1. Abra su proyecto en Cuenta del editor y vaya a la sección de Login.
   2. Haga clic en Configure en la barra de sitio web.
   3. Vaya al bloque Authentication y seleccione Social login.

1. 4. Para establecer una red social, vaya a la ficha de la red social, haga clic en el icono ⚙ situado a la derecha del título y seleccione Connect.

Flujo del usuario

1. El usuario se dirige a Web Shop con la autenticación de Xsolla Login configurada.
2. El usuario hace clic en el botón de compra del artículo seleccionado, el botón de inicio de sesión de la barra superior o el botón de inicio de sesión del bloque de Fast Login (inicio de sesión rápido).
3. Se abre una ventana modal con los métodos de autorización establecidos en Xsolla Login.

4. El usuario procede a la autorización e introduce datos adicionales si es necesario.
5. El sistema verifica si el usuario existe en el juego. Si el usuario existe en el juego, el usuario es autorizado en Web Shop. En caso contrario, aparece un mensaje de error.

Cómo conseguirlo

1. En el Builder de su sitio web, vaya al bloque Login settings.

2. Seleccione la opción de autorización de Xsolla Login.
3. En la lista desplegable, seleccione New Login.

4. Vaya a la configuración del proyecto de Login desde la ventana modal o haga clic en Set up authentication method en el bloque Xsolla Login.

5. Conecte el almacenamiento de datos de usuarios.

En función del método de almacenamiento de los datos de usuarios, tendrá a su disposición diferentes funcionalidades del producto (consulte Comparación de las opciones de almacenamiento de datos de usuario).

Almacenamiento de Xsolla

Si desea que el producto Login procese toda la lógica de autenticación, conéctese al almacenamiento de Xsolla. Dispondrá de una configuración más flexible.

Cuando crea un proyecto de Login, el almacenamiento de Xsolla está conectado por defecto, no se requieren pasos adicionales para configurarlo. Si ha cambiado el tipo de almacenamiento por defecto y necesita volver a conectarse al almacenamiento de Xsolla, sigue estos pasos:

1. En la página de navegación, vaya al bloque User database y seleccione la sección Storage.
2. Seleccione Xsolla storage y haga clic en Save change.

Almacenamiento de PlayFab

Si desea utilizar la funcionalidad de PlayFab para operar con usuarios, conéctese al almacenamiento de PlayFab. Este almacenamiento guarda los siguientes datos de usuario:

• nombre de usuario
• dirección de correo electrónico del usuario
• contraseña del usuario
• de un formulario de registro ampliado si el formulario está establecido

El almacenamiento de PlayFab le da acceso a las siguientes funciones:

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

Para conectar el almacenamiento:

1. Vaya al bloque User database y seleccione la sección Storage.
2. Seleccione PlayFab.
3. En el campo Title ID, introduzca el valor del mismo campo de su cuenta de PlayFab.
4. Haga clic en Save changes.

Firebase Storage

Si desea utilizar la funcionalidad de Firebase para operar con usuarios, conéctese al almacenamiento de Firebase. Este almacenamiento guarda los siguientes datos de usuario:

• nombre de usuario
• dirección de correo electrónico del usuario
• contraseña del usuario
• de un formulario de registro ampliado si el formulario está establecido

1. Vaya al bloque User database y seleccione la sección Storage.
2. Seleccione Firebase.
3. En el campo API key, introduzca el valor del mismo campo de su cuenta de Firebase.
4. Haga clic en Save changes.

Almacenamiento personalizado

Si utiliza su propio sistema de autorización y almacena los datos de usuario en el lado de su aplicación, conéctelo al almacenamiento personalizado.

El almacenamiento personalizado le da acceso a las siguientes funciones:

• registro de usuario
• autenticación mediante dirección de correo electrónico o nombre de usuario y contraseña
• autenticación sin contraseña mediante número de teléfono
• autenticación mediante redes sociales
• restablecimiento de contraseña de usuario

1. Conecte el almacenamiento personalizado.
2. Establezca el procesamiento de solicitudes del servidor de Xsolla Login.

Conectar almacenamiento personalizado

1. Vaya al bloque User database y seleccione la sección Storage.
2. Seleccione Custom storage.
3. Introduzca las URL a las que enviar las solicitudes API:
   • URL de verificación de usuario
   • URL de nuevo usuario
   • URL de restablecimiento de contraseña
   • URL de inicio de sesión sin contraseña vía teléfono
   • URL de inicio de sesión mediante redes sociales
4. Haga clic en Save changes.
5. Para las URL que ha establecido, implemente una API que responda de la siguiente manera:
   • HTTP 200/HTTP 204 para las solicitudes aceptadas. Si es necesario, se puede colocar en el cuerpo de la respuesta un JSON que contenga datos adicionales del usuario. Los datos transmitidos se escriben en un JWT (el parámetro partner_data).
   • Otros códigos de estado HTTP para solicitudes fallidas.

Establecer el procesamiento de solicitudes del servidor de Xsolla Login

Las solicitudes del servidor de Xsolla Login se envían a las URL, que especificó en Cuenta del editor, con el encabezado Authorization: Bearer <JWT>. El JWT se firma con la clave secreta de su proyecto.

Para procesar una solicitud:

1. Valide un JWT recibido.
2. Si la validación es correcta, descodifique el JWT y asegúrese de que incluye las reclamaciones de la tabla siguiente. Busque y utilice una biblioteca para la descodificación.

{
  "exp": 1573635020,
  "iat": 1573634600,
  "iss": "https://login.xsolla.com",
  "request_type": "gateway_request",
  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000"
}