Asignación de nombres de claves JSON a propiedades del perfil de usuario

Cómo funciona

Puede asignar los campos del objeto JSON que usted devuelve en respuesta a los webhooks de Xsolla Login a las siguientes propiedades del perfil de usuario en el sistema de Xsolla:

• fecha de nacimiento (birthday)
• alias (nickname)
• nombre (first_name)
• apellidos (last_name)
• género (gender)
• ID de usuario en su servidor (server_custom_id)

• sincronizar datos con Web Shop
• para aplicar etiquetas merge de Mailchimp
• e implementar integraciones con otros sistemas externos

¿Quién puede utilizarlo?

Socios que utilizan almacenamiento personalizado de datos de usuario y desean usar esos datos en el contexto de Xsolla Login.

Cómo conseguirlo

1. En su proyecto de Cuenta del editor, vaya la sección de Login.
2. Seleccione la opción de inicio de sesión y vaya a la sección User database.
3. Vaya la sección de Storage.
4. Seleccione Custom storage.
5. Elija el webhook para el que desea configurar la asignación de claves:
   • verificación de usuario
   • creación de usuarios
   • inicio de sesión mediante red social
6. En el bloque Key name map, introduzca los nombres de los campos que deben asignarse a las propiedades correspondientes del perfil de usuario.

7. Active la opción Enable user account linking para permitir que nuestro sistema identifique todas las cuentas con el mismo server_custom_id como pertenecientes al mismo usuario (opcional).

8. Haga clic en Save changes.

Ejemplos de uso de la asignación de nombres de claves

Transmisión de datos de usuario desde la respuesta webhook al JWT y a las propiedades del perfil de usuario

1. Como respuesta al webhook de verificación del usuario, envíe el siguiente objeto JSON (puede contener cualquier conjunto de campos):

 1{
 2  "user": {
 3    "player_id": "12345678",
 4    "email": "user@example.com"
 5  },
 6  "user_info": {
 7    "username": "gamer123",
 8    "user_first_name": "John",
 9    "user_last_name": "Doe",
10    "gender": "male",
11    "birthday": "1990-05-15",
12    "country": "US",
13    "language": "en"
14  },
15  "subscription_status": "active",
16  "loyalty_level": "gold"
17}

2. En la cuenta de Cuenta del editor, asignó claves a las propiedades nickname y server_custom_id.

3. Como respuesta a la solicitud Obtener datos del usuario recibirá el siguiente objeto JSON:

 1{
 2  "birthday": null,
 3  "country": null,
 4  "devices": [
 5    {
 6      "device": null,
 7      "last_used_at": null,
 8      "type": null
 9    },
10    {
11      "device": null,
12      "last_used_at": null,
13      "type": null
14    }
15  ],
16  "email": null,
17  "external_id": null,
18  "first_name": null,
19  "gender": null,
20  "groups": [
21    {
22      "id": 1,
23      "is_default": false,
24      "name": "admin"
25    },
26    {
27      "id": 5,
28      "is_default": false,
29      "name": "user"
30    }
31  ],
32  "id": null,
33  "is_anonymous": false,
34  "last_login": null,
35  "last_name": null,
36  "nickname": "gamer123",
37  "phone": null,
38  "phone_auth": null,
39  "registered": null,
40  "tag": null,
41  "username": null
42}

Uso de la asignación de nombres de claves y la vinculación de cuentas durante la autenticación en Web Shop

1. El usuario inicia sesión en Web Shop con su ID de usuario. El ID de usuario se registra en el campo server_custom_id del JWT.
2. Web Shop envía un webhook Validación de usuarios en Web Shop a su servidor.
3. Su servidor responde al webhook con HTTP 200 si el usuario existe, o 404 en caso contrario.
4. Web Shop autentica al usuario.
5. El usuario vuelve a iniciar sesión en Web Shop utilizando otro método, como el inicio de sesión mediante red social.
6. Web Shop redirige al usuario a la página de inicio de sesión de la red social.
7. El usuario inicia sesión en la red social.
8. La red social devuelve los datos del perfil del usuario a Web Shop.
9. Web Shop envía un webhook a su URL de inicio de sesión mediante red social.
10. Su servidor identifica al usuario en función de los datos del perfil de la red social y le asigna el mismo ID de usuario que se utilizó durante la autenticación del ID de usuario.
11. Su servidor responde con un código 2xx e incluye un cuerpo JSON que contiene el ID de usuario.
12. Web Shop guarda los atributos del usuario y añade los datos de la respuesta del webhook al campo partner_data del JWT.
13. Si la asignación de nombres de claves incluye una clave para server_custom_id y la vinculación de cuentas está activada, Web Shop asigna los datos de usuario recibidos a las propiedades del perfil en función de la asignación de nombres de claves y vincula las cuentas.
14. Web Shop autentica al usuario en la misma cuenta utilizada durante el inicio de sesión de ID de usuario.

Seguir leyendo