Authentification silencieuse

Comment ça marche

L’authentification silencieuse vous permet d’authentifier automatiquement les utilisateurs de votre jeu via une plateforme de publication. Actuellement, les plateformes Steam, Xbox Live et Epic Games sont prises en charge. Si vous avez besoin d’une assistance pour les plateformes Stone ou Mail.ru, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.

Flux d’interaction :

1. L’utilisateur lance le jeu.
2. Le jeu reçoit les données d’autorisation de la plateforme via le SDK de la plateforme.
3. Votre jeu génère et envoie une requête au serveur Xsolla Login pour obtenir un JWT.
4. Le serveur Xsolla Login authentifie l’utilisateur et envoie le JWT.

Qui peut l'utiliser

Les partenaires qui ont déjà intégré Login et qui possèdent un compte sur une plateforme de publication.

Comment configurer

1. Configurez l'authentification silencieuse dans le Compte éditeur.
2. Complétez les étapes d'intégration du côté de votre application.

Configurer l'authentification silencieuse

Dans le produit Login, deux approches sont implémentées pour activer l’authentification silencieuse :

• en configurant l’option de connexion classique (voir les instructions ci-dessous) ;
• en créant un projet de connexion fantôme (voir Comment configurer un projet de connexion fantôme).

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Login.
2. Dans le panneau de l’option de connexion classique, cliquez sur Configure.
3. Accédez au bloc Authentication et sélectionnez la section Publishing platforms.

4. Pour connecter une plateforme de publication, cliquez sur l'icône ⚙ à côté de son nom et sélectionnez Settings.

5. Dans la fenêtre modale, spécifiez les paramètres de la plateforme sélectionnée :
   • Steam :
     • Application ID — AppID de votre compte sur la plateforme ;
     • Application secret key — clé API Web.
   • Epic Games :
     • Application ID — Client ID du client de votre jeu sur la plateforme ;
     • Application secret key — Secret key du client de votre jeu sur la plateforme.
   • Xbox Live :
     • Application ID — ID d'application/ID client de votre jeu sur la plateforme ;
     • Application secret key — secret de l’application généré lors de l'enregistrement de votre jeu sur la plateforme.

6. Cliquez sur Connect.
7. Répétez les étapes 4 à 6 pour les autres plateformes de publication, si nécessaire.

Intégration côté application

Utilisez les instructions relatives à la plateforme de publication qui héberge votre application :

• Steam
• Xbox Live
• Epic Games

Steam

1. Obtenez le ticket de session.
2. Passez-le à la requête d’authentification silencieuse (JWT ou OAuth 2.0) en tant que paramètre session_ticket.

Xbox Live

1. Formez un ticket de session (paramètre session_ticket) sur la base des données de la plateforme après l'authentification de l'utilisateur. Le paramètre est formé sur la base du modèle <xid>-<uhs>;<XSTSToken> où :
   • <xid> — Xbox User ID ;
   • <uhs> — user hash ;
   • <XSTSToken> — Xbox Secure Token Service.
2. Passez le paramètre session_ticket à la requête d'authentification silencieuse (JWT ou OAuth 2.0).

Epic Games

1. Obtenez le code d'autorisation exchangecode de la plateforme, qui est généré après l'authentification de l'utilisateur.
2. Passez le code exchangecode reçu à la requête d'authentification silencieuse (JWT ou OAuth 2.0) en tant que paramètre session_ticket.