Configuration de l’authentification par lien profond

Les liens profonds permettent à l’utilisateur de s’authentifier dans le Web Shop via le jeu en un seul clic, contournant ainsi le processus d’authentification par ID utilisateur ou via Xsolla Login.

Si le jeu est déjà installé sur l’appareil mobile de l’utilisateur, il sera automatiquement redirigé vers le jeu via un lien profond pour obtenir un jeton d’autorisation.

Flux utilisateur

Dans l'application mobile

1. Un utilisateur non autorisé du Web Shop clique sur le bouton de connexion ou sur le bouton d'achat. Une fenêtre modale permettant de saisir l'ID utilisateur ou de se connecter via le jeu mobile s'affiche.

2. L'utilisateur clique sur le bouton de connexion via le jeu.
3. L'utilisateur est redirigé vers le jeu où, il est automatiquement redirigé vers le Web Shop en tant qu'utilisateur autorisé.

Dans la version de bureau

1. Un utilisateur non autorisé du Web Shop clique sur le bouton de connexion ou sur le bouton d'achat. Une fenêtre modale permettant de saisir l'ID utilisateur ou de se connecter à la version mobile du jeu à l'aide d'un code QR s'affiche.

2. L'utilisateur scanne le code QR à l'aide de son appareil mobile, après quoi le Web Shop s'ouvre sur celui-ci.
3. La version mobile du jeu s'ouvre sur l'appareil de l'utilisateur.
4. L'utilisateur est automatiquement redirigé vers le Web Shop sur son appareil mobile en tant qu'utilisateur autorisé.

Flux d'interaction des services

Comment configurer

Côté jeu

1. Dans les paramètres de l'application mobile de votre jeu, enregistrez un schéma d'URL pour ouvrir le jeu via un lien profond :
   • dans les applications Android — dans le fichier AndroidManifest.xml ;
   • dans les applications iOS — dans le fichier Info.plist.

• gamename — nom de votre jeu qui doit s’ouvrir sur un appareil mobile pour l’authentification de l’utilisateur ;
• authorize — exemple de nom d’action à effectuer après l’ouverture du jeu gamename. Utilisez le nom d’action qui correspond aux actions du système d’exploitation de votre application.

<key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>gamename</string>
      </array>
    </dict>
  </array>

Exemple d’enregistrement d’un schéma d’URL dans les applications Android :

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="gamename" android:host="authorize" />
</intent-filter>

2. Implémentez la génération d'un jeton d'autorisation au format JWT en utilisant l'ID utilisateur dans le jeu.

Exemple d’appel à la méthode API de génération de jeton utilisateur à l’aide de curl :

curl --location 'https://sb-user-id-service.xsolla.com/api/v1/user-id' \
--header 'Content-Type: application/json' \
--data '{
 "loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
 "webhookUrl": "https://nowebhook.com",
 "settings": {
   "projectId": 123456,
   "merchantId": 123456
 },
 "user": {
   "id": "123",
   "name": "a-user-name"
 }
}'

Vous obtiendrez une réponse du type {token=“JWT_TOKEN”}.

3. Ajoutez une fenêtre contextuelle avec une notification d'autorisation réussie (facultatif).
4. Implémentez l'ouverture du Web Shop dans le navigateur à l'aide du jeton utilisateur obtenu.

Exemple de création d’une URL pour ouvrir le Web Shop dans le navigateur d’un utilisateur autorisé :

• https:​//example.com/?token={token}, si vous utilisez un domaine personnalisé
• https:​//example.xsollasitebuilder.com/?token={token}, si vous utilisez un domaine Xsolla

Dans Site Builder

1. Ouvrez le projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Site Builder.
3. Cliquez sur Configure sur la carte du site de votre Web Shop avec authentification par ID utilisateur.
4. Accédez à Login Settings et sélectionnez la section User ID.
5. Réglez la bascule Deeplink authorization sur On.

6. Dans le champ Deeplink URL, entrez le lien pour l’authentification utilisateur.

7. Si vous utilisez le bloc Fast Login sur votre site :
   1. Accédez au bloc Fast Login ;
   2. Dans la section Layout, réglez la bascule QR code sur On.

8. Pour vérifier l’authentification, cliquez sur Preview.
9. Pour publier le site Web, cliquez sur Publish.