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

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

1. Créez votre compte Twitch et obtenez un Twitch Client ID.
2. Accédez au Compte éditeur et ouvrez votre projet > Login.
3. Cliquez sur Configure dans le panneau du projet de connexion requis.
4. Accédez au bloc Authentication et sélectionnez la section Social login.
5. Accédez au panneau du réseau social Twitch, cliquez sur l'icône ⚙ et sélectionnez Settings.
6. Entrez votre Twitch Client ID dans le champ Application ID.
7. Si nécessaire, modifiez d'autres paramètres.
8. Cliquez sur Connect.
9. Configurez Twitch dans votre compte PlayFab.
10. Si vous avez intégré le produit Login via les appels Login API :
    1. Obtenez un lien pour l'authentification via Twitch. Pour ce faire, utilisez l'appel d'authentification via un réseau social (JWT ou OAuth 2.0) ;
    2. Placez le lien reçu dans l'interface de votre application.

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

Vous pouvez bloquer des utilisateurs dans le Compte éditeur. Les utilisateurs bloqués ne peuvent pas s’authentifier. Le blocage est enregistré et stocké côté Xsolla uniquement.

Poursuivre la lecture