Comment configurer un projet de connexion fantôme

1. Créez un projet de connexion fantôme s'il n'a pas encore été créé (voir Guide d'intégration, étapes 1–5).
2. Configurez votre projet de connexion fantôme dans le Compte éditeur.
3. Intégrez la solution du côté de votre application.

Configuration dans le Compte éditeur

1. Ouvrez votre projet dans le Compte éditeur et accédez à la section Login.
2. Dans le panneau du projet de connexion fantôme, 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. Accédez à l'onglet Callback URLs et spécifiez les paramètres suivants :
   • Callback URL — URL ou chemin dans l'application vers lequel l'utilisateur est redirigé après une authentification, une confirmation d'adresse e-mail ou une réinitialisation de mot de passe. Vous pouvez spécifier plusieurs URL valides.
   • Error callback URL — URL ou chemin dans l'application vers lequel l'utilisateur est redirigé en cas d'erreur d'authentification. Si aucune valeur n'est spécifiée, la valeur Callback URL est utilisée.

8. Cliquez sur Save Changes.

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.