Vous pouvez intégrer le SDK à votre propre système d’autorisation. Pour ce faire, implémentez l’identification utilisateur par custom ID (un identifiant utilisateur généré sur votre serveur) pour ouvrir le magasin en jeu, effectuer un paiement et gérer l’inventaire.

Flux d’interaction avec les serveurs Xsolla lorsque vous utilisez votre propre système d’autorisation :

1. Votre client envoie une requête d’authentification à votre serveur.
2. Votre serveur autorise l’utilisateur et envoie une requête au serveur Xsolla pour obtenir le JSON Web Token (JWT) de l’utilisateur, en passant son custom ID.
3. Le serveur Xsolla renvoie le JWT de l’utilisateur.
4. Votre serveur passe le JWT de l’utilisateur au client.
5. Les méthodes SDK utilisent le JWT de l’utilisateur obtenu au lieu d’un jeton d’autorisation pour ouvrir le magasin en jeu, effectuer un paiement et gérer l’inventaire.

Pour utiliser votre propre système d’autorisation avec les produits Xsolla :

1. Configurez le client OAuth 2.0 du serveur dans votre Compte éditeur.
2. Implémentez l’obtention du JWT du serveur.
3. Implémentez l’obtention du JWT de l’utilisateur.
4. Implémentez la logique de fonctionnement du magasin en jeu, des achats et de l’inventaire au moyen du JWT de l’utilisateur.

Configurer le client OAuth 2.0 du serveur

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Login.
2. Dans le volet du projet de connexion, cliquez sur Configure.
3. Accédez au bloc Security et sélectionnez la section OAuth 2.0.
4. Cliquez sur Add OAuth 2.0.
5. Spécifiez les OAuth 2.0 redirect URIs.
6. Cochez la case Server (server-to-server connection).
7. Cliquez sur Connect.
8. Copiez et enregistrez l'ID client et la clé secrète.

Obtenir un JWT de serveur

Côté serveur de votre application, implémentez une méthode pour obtenir le JWT du serveur en utilisant l’appel API Generate JWT. La requête doit contenir les paramètres suivants :

• grant_type — type de JWT, passez la valeur client_credentials ;
• client_secret — clé secrète obtenue lorsque vous configurez le client OAuth 2.0 du serveur ;
• client_id — ID client obtenu lorsque vous configurez le client OAuth 2.0 du serveur.

Obtenir un JWT d'utilisateur

Côté serveur de votre application, implémentez une méthode pour obtenir le JWT de l’utilisateur en utilisant l’appel API Auth by custom ID. La requête doit contenir l’en-tête X-Server-Authorization: <server_JWT>, où <server_JWT> est le JWT du serveur obtenu à l’étape précédente.

Utiliser un JWT d'utilisateur

Utilisez les méthodes SDK pour ouvrir le magasin en jeu, effectuer un paiement et gérer l’inventaire. Lorsque vous utilisez les méthodes SDK, passez le code JWT de l’utilisateur plutôt que le jeton d’autorisation.

Les tutoriels suivants contiennent des exemples d’utilisation du jeton :

• Vendre des objets virtuels contre des devises réelles.
• Vendre des objets virtuels contre de la monnaie virtuelle.
• Affichage des objets de l’inventaire.
• Affichage du solde de la monnaie virtuelle.

Implémentez la logique d’obtention d’un nouveau JWT utilisateur après son expiration. Nous vous recommandons d’effectuer cette opération en arrière-plan, afin que l’utilisateur n’ait pas à se reconnecter à l’application.