Un lien profond est une URL spéciale qui redirige l’utilisateur non seulement vers la page d’accueil d’une application ou d’un site Web, mais directement vers une section, une page ou une action précise.

Les liens profonds peuvent être utilisés comme méthode d’authentification supplémentaire lors de la connexion par ID utilisateur. 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 Log in via Mobile Game.
3. L'utilisateur est redirigé vers le jeu, puis automatiquement 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.
3. Le Web Shop s'ouvre sur l'appareil mobile de l'utilisateur.
4. L'utilisateur est automatiquement redirigé vers le jeu, puis automatiquement vers le Web Shop 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.

Après l'enregistrement du schéma, lorsque l'utilisateur s'authentifie dans le Web Shop via le jeu, le jeu s'ouvrira à l'adresse spécifiée.

Exemple de schéma d'URL pour enregistrer un jeu :
gamename://authorize?operationPayload=<VALUE>, où :
• 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 exécutée après l'ouverture du jeu. Utilisez un nom qui correspond aux actions du système d'exploitation de votre application ;
• operationPayload=<VALUE> — paramètre supplémentaire contenant les informations nécessaires à la génération du jeton lors de l'authentification.

Exemples :

• Enregistrement d'un schéma d'URL dans les applications iOS
• Enregistrement d'un schéma d'URL dans les applications Android

Copy

Full screen

Small screen

• xml

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

Copy

Full screen

Small screen

• xml

<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 -X 'POST' \
'https://sb-user-id-service.xsolla.com/api/v1/user-id/token' \
-H 'accept: /' \
-H 'Content-Type: application/json' \
-d '{
 "loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
 "settings": {
   "projectId": 123456,
   "merchantId": 123456
 },
 "user": {
   "id": "123",
   "country": "US"
 }
 "operationPayload": "kosarb2NyrtIWaegJAH1f6P7XrBYPXYDya5coc_ZzcfiS_5o4QTUAL-CcGRC_Kv4CAtg"
}'

Vous obtiendrez une réponse de 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.xsolla.site/?token={token}, si vous utilisez un domaine Xsolla.

Où {token} est le jeton d'autorisation utilisateur.

Dans Site Builder

1. Ouvrez votre projet dans le Compte éditeur et accédez à Site Builder.
2. Cliquez sur Configure sur la carte du site de votre Web Shop avec authentification par ID utilisateur.
3. Accédez à Login Settings et sélectionnez la section User ID.
4. Activez l’option Deeplink authorization.

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

6. Si vous utilisez le bloc Fast Login sur votre site :
   1. Accédez au bloc Fast Login ;
   2. Dans la section Layout, activez l’option QR code.

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

Un lien profond est une URL spéciale qui redirige l’utilisateur non seulement vers la page d’accueil d’une application ou d’un site Web, mais directement vers une section, une page ou une action précise.

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.

Lorsqu’un lien profond est utilisé comme méthode d’authentification principale, il permet d’enregistrer les informations de paiement, ce qui n’est pas possible avec l’authentification par ID utilisateur et lien profond. Dans ce cas, il sert uniquement à rendre l’authentification plus rapide, sans ajouter de nouvelles fonctionnalités.

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 se connecter via le jeu mobile s'affiche.

2. L'utilisateur clique sur le bouton Log in via Mobile Game.
3. L'utilisateur est redirigé vers le jeu, puis automatiquement 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 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.
3. Le Web Shop s'ouvre sur l'appareil mobile de l'utilisateur.
4. L'utilisateur est automatiquement redirigé vers le jeu, puis automatiquement vers le Web Shop 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.

Après l'enregistrement du schéma, lorsque l'utilisateur s'authentifie dans le Web Shop via le jeu, le jeu s'ouvrira à l'adresse spécifiée.

Exemple de schéma d'URL pour enregistrer un jeu :
gamename://authorize?operationPayload=<VALUE>, où :
• 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 exécutée après l'ouverture du jeu. Utilisez un nom qui correspond aux actions du système d'exploitation de votre application ;
• operationPayload=<VALUE> — paramètre supplémentaire contenant les informations nécessaires à la génération du jeton lors de l'authentification.

Exemples :

• Enregistrement d'un schéma d'URL dans les applications iOS
• Enregistrement d'un schéma d'URL dans les applications Android

Copy

Full screen

Small screen

• xml

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

Copy

Full screen

Small screen

• xml

<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.

L'API Xsolla utilise l'authentification de base. Toutes les demandes API doivent inclure l'en-tête suivant :Authorization: Basic , où your_authorization_basic_key est une paire client_id:client_secret encodée selon la norme Base64.

La configuration d'un client OAuth 2.0 pour l'authentification serveur se fait via le Compte éditeur. Pour connaître les étapes détaillées, reportez-vous à la documentation.

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

curl -X 'POST' \
'https://sb-user-id-service.xsolla.com/api/v1/user-id/token' \
-H 'Accept: /' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic <Base64Encoded(client_id:client_secret)>' \
-d '{
 "loginId": "000001aa-001a-0ab0-00001-01a01a01a01a",
 "settings": {
   "projectId": 123456,
   "merchantId": 123456
 },
 "user": {
   "id": "123",
   "country": "US"
 }
 "operationPayload": "kosarb2NyrtIWaegJAH1f6P7XrBYPXYDya5coc_ZzcfiS_5o4QTUAL-CcGRC_Kv4CAtg"
}'

Vous obtiendrez une réponse de 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.xsolla.site/?token={token}, si vous utilisez un domaine Xsolla.

Où {token} est le jeton d'autorisation utilisateur.

Dans Site Builder

1. Ouvrez votre projet dans le Compte éditeur et accédez à Site Builder.
2. Cliquez sur Configurer sur la carte de votre site Web Shop.
3. Accédez à Login Settings et sélectionnez la section Deep link.

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

5. Si vous utilisez le bloc Fast Login sur votre site :
   1. Accédez au bloc Fast Login ;
   2. Dans la section Block Settings, ajustez le style d’affichage du bouton de connexion par code QR.

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

Flux utilisateur

1. L’utilisateur accède à Web Shop avec l’authentification Xsolla Login configurée.
2. L’utilisateur clique sur le bouton d’achat de l’objet sélectionné, sur le bouton de connexion de la barre supérieure ou sur le bouton de connexion du bloc de Fast Login.
3. Une fenêtre modale s’affiche avec les méthodes d’autorisation configurées dans Xsolla Login.

4. L'utilisateur s'authentifie et saisit des données supplémentaires si nécessaire.
5. Le système vérifie l'existence de l'utilisateur. S'il existe, l'utilisateur est autorisé dans Web Shop. Sinon, un message d'erreur s'affiche.

Comment configurer

1. Dans le constructeur de votre site, accédez au bloc Login settings.

2. Sélectionnez l'option d'autorisation Xsolla Login.
3. Dans la liste déroulante, sélectionnez New Login.

4. Accédez aux paramètres du projet de connexion depuis la fenêtre modale ou cliquez sur Set up authentication method dans le bloc Xsolla Login.

5. Connectez le stockage des données utilisateur.

Selon la méthode de stockage des données utilisateur, différentes fonctionnalités du produit sont à votre disposition (voir Comparaison des options de stockage des données utilisateur).

Stockage Xsolla

Si vous souhaitez que le produit Login traite toute la logique d’authentification, connectez le stockage Xsolla. Vous aurez à votre disposition des paramètres plus flexibles.

Lorsque vous créez un projet de connexion, le stockage Xsolla est connecté par défaut, aucune étape supplémentaire n’est requise pour le configurer. Si vous avez modifié le type de stockage par défaut et que vous devez reconnecter le stockage Xsolla, procédez comme suit :

1. Accédez au bloc User database et sélectionnez la section Storage.
2. Sélectionnez Xsolla storage et cliquez sur Save changes.

Stockage PlayFab

Si vous souhaitez utiliser les fonctionnalités PlayFab pour interagir avec les utilisateurs, connectez le stockage PlayFab. Ce stockage enregistre les données utilisateur suivantes :

• nom d’utilisateur ;
• adresse e-mail utilisateur ;
• mot de passe utilisateur ;
• champs d’un formulaire d’inscription étendu, si le formulaire est configuré.

Le stockage PlayFab vous donne accès aux fonctionnalités suivantes :

• inscription utilisateur ;
• authentification par adresse e-mail ou nom d’utilisateur et mot de passe ;
• authentification via Twitch ;
• réinitialisation du mot de passe utilisateur ;
• blocage des utilisateurs.

Pour connecter le stockage :

1. Accédez au bloc User database et sélectionnez la section Storage.
2. Sélectionnez PlayFab.
3. Dans le champ Title ID, entrez la même valeur que celle dans votre compte PlayFab.
4. Cliquez sur Save changes.

Stockage Firebase

Si vous souhaitez utiliser les fonctionnalités Firebase pour interagir avec les utilisateurs, connectez le stockage Firebase. Ce stockage enregistre les données utilisateur suivantes :

• nom d’utilisateur ;
• adresse e-mail utilisateur ;
• mot de passe utilisateur ;
• champs du formulaire d’inscription étendu, si le formulaire est configuré.

1. Accédez au bloc User database et sélectionnez la section Storage.
2. Sélectionnez Firebase.
3. Dans le champ API key, entrez la même valeur que celle dans votre compte Firebase.
4. Cliquez sur Save changes.

Stockage personnalisé

Si vous utilisez votre propre système d’autorisation et que vous stockez les données utilisateur côté application, connectez votre propre stockage.

Le stockage personnalisé vous donne accès aux fonctionnalités suivantes :

• inscription utilisateur ;
• authentification par adresse e-mail ou nom d’utilisateur et mot de passe ;
• authentification sans mot de passe par numéro de téléphone ;
• authentification via les réseaux sociaux ;
• réinitialisation du mot de passe utilisateur.

1. Connectez le stockage personnalisé.
2. Configurez le traitement des requêtes depuis le serveur de connexion Xsolla.

Connecter un stockage personnalisé

1. Accédez au bloc User database et sélectionnez la section Storage.
2. Sélectionnez Custom storage.
3. Entrez les URL vers lesquelles envoyer les requêtes API :
   • URL de vérification utilisateur ;
   • URL de nouvel utilisateur ;
   • URL de réinitialisation de mot de passe ;
   • URL de connexion sans mot de passe par téléphone ;
   • URL de connexion via les réseaux sociaux.
4. Cliquez sur Save changes.
5. Pour les URL que vous avez définies, implémentez un appel API qui renverra ce qui suit :
   • Un code HTTP 200 ou 204 en cas de requête réussie. Si nécessaire, un JSON contenant des données utilisateur supplémentaires peut être placé dans le corps de la réponse. Les données passées sont écrites dans un JWT (le paramètre partner_data) ;
   • Autres codes HTTP d'état en cas de requête infructueuse.

Configurer le traitement des requêtes depuis le serveur Xsolla Login

Les requêtes du serveur Xsolla Login sont envoyées aux URL que vous avez spécifiées dans le Compte éditeur, avec l’en-tête Authorization: Bearer <JWT>. Le JWT est signé avec la clé secrète de votre projet.

Pour traiter une demande :

1. Validez le JWT reçu.
2. Si la validation est réussie, décodez le JWT et assurez-vous qu’il inclut les revendications du tableau ci-dessous. Trouvez et utilisez une bibliothèque pour le décodage.

{
  "exp": 1573635020,
  "iat": 1573634600,
  "iss": "https://login.xsolla.com",
  "request_type": "gateway_request",
  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000"
}