Stockage PlayFab

Si vous utilisez le stockage PlayFab, vous avez accès aux fonctionnalités suivantes :

• enregistrement utilisateur
• authentification par adresse e-mail et mot de passe utilisateur
• authentification via Twitch
• réinitialisation du mot de passe utilisateur
• blocage de l’utilisateur

Flux d'interaction

Vous pouvez utiliser le widget Login ou votre application comme client. Le flux d’interaction entre le client et le serveur Xsolla Login est le suivant :

1. Le client envoie des requêtes au serveur Xsolla Login. Le format des requêtes est décrit dans les endpoints JWT, OAuth 2.0 et Password.
2. Le serveur Xsolla Login envoie des requêtes à PlayFab.
3. Le serveur Xsolla Login traite la réponse de PlayFab et renvoie les résultats au client.
4. Le client traite la réponse.

Enregistrement utilisateur dans PlayFab

L’enregistrement utilisateur suit ce flux. Vous pouvez configurer l’e-mail de confirmation de compte que vos utilisateurs reçoivent à la fin de leur enregistrement.

Flux d'enregistrement utilisateur

1. Le client envoie la requête Register new user au serveur Xsolla Login.
2. Le serveur Xsolla Login envoie une requête d'enregistrement.
3. Les données utilisateur sont écrites dans la base de données Xsolla.
4. Le serveur Xsolla Login envoie une requête de modification de données utilisateur à PlayFab.
5. Si vous avez configuré la confirmation de compte :
   • Lorsque vous utilisez les appels Login API pour intégrer la solution, l'enregistrement est considéré comme terminé ;
   • Lorsque vous utilisez le widget Login pour intégrer la solution, l'utilisateur est redirigé vers une page avec le message suivant : L'e-mail de confirmation de compte est envoyé à {adresse e-mail}.
   Si vous n'avez pas configuré la confirmation de compte, l'utilisateur est automatiquement connecté après l'enregistrement.

Confirmation du compte utilisateur dans PlayFab

Pour configurer l’envoi d’e-mail de confirmation de compte, suivez les étapes suivantes :

1. Suivez les instructions pour configurer votre projet dans PlayFab.
2. Assurez-vous d’avoir terminé les étapes Create an email template et Create a rule to send an email when a contact email is updated du module Requirements.
3. Contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.

Authentification par adresse e-mail et mot de passe utilisateur

Il existe deux types d’authentification par adresse e-mail et mot de passe utilisateur : l’authentification basée sur le standard JWT et l’authentification basée sur le protocole OAuth 2.0.

Flux d'authentification basée sur le standard JWT

1. Le client envoie la requête Auth by username and password au serveur Xsolla Login.
2. Le serveur Xsolla Login envoie la requête d'authentification à PlayFab.
3. Le serveur Xsolla Login génère un JWT utilisateur. Pendant cette étape :
   • La valeur PlayFabId de la réponse à la requête à PlayFab est écrite dans la revendication external_account_id ;
   • La valeur SessionTicket de la réponse à la requête à PlayFab est écrite dans la revendication session_ticket ;
   • Les valeurs EntityToken de la réponse à la requête à PlayFab sont écrites dans les revendications entity_token, entity_id, entity_type.
4. L'utilisateur est redirigé vers login_url avec le paramètre de requête token. Le JWT utilisateur est écrit dans le paramètre token.

Flux d'authentification basée sur le protocole OAuth 2.0

1. Le client envoie la requête Auth by username and password avec le paramètre redirect_uri au serveur Xsolla Login.
2. Le serveur Xsolla Login envoie la requête d'authentification à PlayFab.
3. Le serveur Xsolla Login renvoie login_url avec code dans le paramètre de requête ainsi que le paramètre redirect_uri passé.
4. L'utilisateur est redirigé vers redirect_uri avec le paramètre de requête code.
5. Le client envoie la requête Generate JWT au serveur Xsolla Login pour échanger le code reçu contre un JWT utilisateur.
6. Le serveur Xsolla Login génère un JWT utilisateur. Pendant cette étape :
   • La valeur PlayFabId de la réponse à la requête à PlayFab est écrite dans la revendication external_account_id ;
   • La valeur SessionTicket de la réponse à la requête à PlayFab est écrite dans la revendication session_ticket si vous avez passéscope=playfab à la requête Auth by username and password ;
   • Les valeurs EntityToken de la réponse à la requête à PlayFab sont écrites dans les revendications entity_token, entity_id, entity_type.

Authentification via Twitch

Vous devez configurer un réseau social dans PlayFab pour authentifier les utilisateurs via Twitch. Il existe deux types d’authentification via Twitch : l’authentification basée sur le standard JWT et l’authentification basée sur le protocole OAuth 2.0.

Flux d'authentification basée sur le standard JWT

1. Le client envoie la requête Auth via social network au serveur Xsolla Login.
2. Le serveur Xsolla Login envoie la requête d'authentification à PlayFab.
3. Les données utilisateur sont écrites dans le stockage Xsolla.
4. Le serveur Xsolla Login génère un JWT utilisateur. Pendant cette étape :
   • La valeur PlayFabId de la réponse à la requête à PlayFab est écrite dans la revendication external_account_id ;
   • La valeur SessionTicket de la réponse à la requête à PlayFab est écrite dans la revendication session_ticket ;
   • Les valeurs EntityToken de la réponse à la requête à PlayFab sont écrites dans les revendications entity_token, entity_id, entity_type.
5. L'utilisateur est redirigé vers login_url avec le paramètre de requête token. Le JWT utilisateur est écrit dans le paramètre token.

Flux d'authentification basée sur le protocole OAuth 2.0

1. Le client envoie la requête Auth via social network avec le paramètre redirect_uri au serveur Xsolla Login.
2. Le serveur Xsolla Login envoie la requête d'authentification à PlayFab.
3. Les données utilisateur sont écrites dans le stockage Xsolla.
4. Le serveur Xsolla Login envoie la requête de modification des données dans PlayFab.
5. L'utilisateur est redirigé vers redirect_uri avec le paramètre de requête code.
6. Le client envoie la requête Generate JWT au serveur Xsolla Login pour échanger le code reçu contre un JWT utilisateur.
7. Le serveur Xsolla Login génère un JWT utilisateur. Pendant cette étape :
   • La valeur PlayFabId de la réponse à la requête à PlayFab est écrite dans la revendication external_account_id ;
   • La valeur SessionTicket de la réponse à la requête à PlayFab est écrite dans la revendication session_ticket si vous avez passéscope=playfab à la requête d'authentification via Twitch ;
   • Les valeurs EntityToken de la réponse à la requête à PlayFab sont écrites dans les revendications entity_token, entity_id, entity_type.

Configurer l'authentification via Twitch

Réinitialisation du mot de passe utilisateur

Le flux de réinitialisation du mot de passe utilisateur est le suivant :

1. Le client envoie la requête Reset password au serveur Xsolla Login.
2. Le serveur Xsolla Login envoie la requête de réinitialisation du mot de passe à PlayFab.
3. Le mot de passe mis à jour est écrit dans PlayFab.

Blocage de l'utilisateur

Poursuivre la lecture