Mappage JSON des noms de clés au profil utilisateur

Comment ça marche

Vous pouvez faire correspondre les champs de l’objet JSON que vous renvoyez en réponse aux webhooks Xsolla Login aux propriétés de profil utilisateur suivantes dans le système Xsolla :

• date de naissance (birthday) ;
• pseudo (nickname) ;
• prénom (first_name) ;
• nom (last_name) ;
• genre (gender) ;
• ID utilisateur sur votre serveur (server_custom_id).

• synchroniser les données avec Web Shop ;
• appliquer les balises de fusion Mailchimp ;
• implémenter des intégrations avec d’autres systèmes externes.

Qui peut l'utiliser

Les partenaires qui utilisent le stockage personnalisé des données utilisateur et souhaitent exploiter ces données dans Xsolla Login.

Comment configurer

1. Dans votre projet, dans le Compte éditeur, accédez à la section Login.
2. Sélectionnez l'option de connexion, puis accédez à la section User database.
3. Accédez à la section Storage.
4. Sélectionnez Custom storage.
5. Choisissez le webhook pour lequel vous souhaitez configurer le mappage des clés :
   • user verification ;
   • user creation ;
   • social login.
6. Dans le bloc Key name map, entrez les noms des champs qui doivent être mappés avec les propriétés du profil utilisateur correspondantes.

7. Activez l'option Enable user account linking pour permettre à notre système d'identifier tous les comptes ayant le même server_custom_id comme appartenant au même utilisateur (facultatif).

8. Cliquez sur Save Changes.

Exemples d'utilisation du mappage des noms de clés

Passage des données utilisateur depuis la réponse webhook vers le JWT et les propriétés du profil utilisateur

1. En réponse au webhook de vérification utilisateur, envoyez l'objet JSON suivant (il peut contenir n'importe quels champs) :

 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. Dans le Compte éditeur, vous avez associé des clés aux propriétés nickname et server_custom_id.

3. En réponse à la requête Lire les informations utilisateur, vous recevrez le JSON suivant :

 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}

Utilisation du mappage des noms de clés et de la liaison des comptes lors de l'authentification dans Web Shop

1. L'utilisateur se connecte au Web Shop en utilisant son ID d'utilisateur. L'ID utilisateur est enregistré dans le champ server_custom_id du JWT.
2. Web Shop envoie un webhook Validation utilisateur dans Web Shop à votre serveur.
3. Votre serveur répond au webhook avec un code HTTP 200 si l'utilisateur existe, ou 404 s'il n'existe pas.
4. Web Shop authentifie l'utilisateur.
5. L'utilisateur se connecte à nouveau au Web Shop en utilisant une autre méthode, par exemple, la connexion via un réseau social.
6. Web Shop redirige l'utilisateur vers la page de connexion du réseau social.
7. L'utilisateur se connecte au réseau social.
8. Le réseau social renvoie les données du profil utilisateur à Web Shop.
9. Web Shop envoie un webhook à votre URL de connexion via les réseaux sociaux.
10. Votre serveur identifie l'utilisateur à partir des données du profil social et lui attribue le même ID utilisateur que celui utilisé lors de l'authentification par ID utilisateur.
11. Votre serveur répond avec un code 2xx et inclut un corps JSON contenant l'ID utilisateur.
12. Web Shop enregistre les attributs utilisateur et ajoute les données reçues de la réponse webhook dans le champ partner_data du JWT.
13. Si le mappage des noms de clés contient une clé pour server_custom_id et la liaison de comptes est activé, Web Shop associe les données utilisateur reçues aux propriétés du profil en fonction du mappage des noms de clés et lie les comptes.
14. Web Shop authentifie l'utilisateur dans le même compte utilisé lors de la connexion par ID utilisateur.

Poursuivre la lecture