SDK pour iOS / Authentification par custom ID
  Retour à la documentation

SDK pour iOS

Authentification par custom ID

Vous pouvez authentifier les utilisateurs côté Xsolla par custom ID (un identifiant utilisateur généré sur votre serveur).

Cette option d’authentification permet de :

Pour authentifier un utilisateur par custom ID, vous devez implémenter l’appel API Auth by custom ID côté serveur dans votre application. L’appel renvoie le JSON Web Token (JWT) de l’utilisateur, qui est utilisé comme jeton d’autorisation dans les méthodes SDK pour effectuer un paiement et gérer l’inventaire.

Note
Un nouveau compte est créé automatiquement côté Xsolla lorsque l’utilisateur s’authentifie avec son ID pour la première fois.
Pour mettre fin à une session utilisateur active, utilisez la méthode SDK logUserOut.

Instructions

Pour en savoir plus sur les configurations avancées, consultez nos instructions.

Comment utiliser votre propre système d'autorisation

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.

Note
Si vous utilisez le système d’autorisation PlayFab ou Firebase, obtenez le JWT de l’utilisateur en utilisant les extensions prêtes à l’emploi Xsolla pour BaaS.

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 :

Note
La durée de vie d’un JWT de serveur est de 59 minutes.

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.

Note
La durée de vie d’un JWT d’utilisateur est de 24 heures. Pour la modifier, contactez votre responsable de la réussite client ou envoyez un e-mail à integration@xsolla.com.

Utiliser un JWT d'utilisateur

Passez le JWT de l’utilisateur aux méthodes SDK en tant que jeton d’autorisation.

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.

Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Masquer

Liens utiles

Dernière mise à jour: 22 Janvier 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !