Establecer la autenticación mediante vínculo profundo

Los vínculos profundos permiten que el usuario se autentique en la Web Shop a través del juego con un solo clic, en lugar de pasar por el proceso de autenticación mediante ID de usuario o mediante Xsolla Login.

Si el juego está instalado en el dispositivo móvil del usuario, a este se le redirigirá al juego mediante un vínculo profundo para obtener un token de autorización.

Flujo del usuario

En la 'app' móvil

1. Un usuario no autorizado de la Web Shop pulsa en el botón de inicio de sesión o en el botón de compra. Se abre una ventana modal para introducir el ID de usuario o iniciar sesión mediante el juego móvil.

2. El usuario pulsa en el botón de inicio de sesión a través del juego.
3. Al usuario se le redirige al juego desde donde se le redirige automáticamente a Web Shop como un usuario autorizado.

En la versión de escritorio

1. Un usuario no autorizado de la Web Shop pulsa en el botón de inicio de sesión o en el botón de compra. Se abre una ventana modal para introducir el ID de usuario o al iniciar sesión en la versión móvil del juego utilizando un código QR.

2. El usuario escanea el código QR con su dispositivo móvil, tras lo cual se abre la Web Shop en su dispositivo móvil.
3. La versión móvil del juego se abre en el dispositivo móvil del usuario
4. Al usuario se le redirige automáticamente a la Web Shop como usuario autorizado.

Flujo de interacción de servicios

Cómo se establece

En el lado del juego

1. En la configuración de la aplicación móvil de su juego, registre un esquema de URL para abrir el juego a través de un vínculo profundo:
   • en aplicaciones de Android, en el archivo AndroidManifest.xml
   • en aplicaciones de iOS, en el archivo Info.plist

• gamename: el nombre de su juego que debe abrirse en un dispositivo móvil para la autenticación del usuario.
• authorize: un ejemplo de un nombre de acción que debe ejecutarse después de que se abra el juego gamename. Use el nombre de acción que coincida con las acciones del sistema operativo de su aplicación.

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

Ejemplo de registro de un esquema URL en aplicaciones de 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. Implemente la generación de un token de autorización en formato JWT empleando el ID de usuario del juego.

Ejemplo de llamada al método API de generación de token de usuario a través 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"
 }
}'

Obtendrá una respuesta del tipo {token=“JWT_TOKEN”}.

3. Agregue una ventana emergente con una notificación de autorización correcta (opcional).
4. Implemente la apertura de Web Shop en el navegador mediante el token de usuario obtenido.

Ejemplo de creación de una URL para abrir Web Shop en el navegador para un usuario autorizado:

• https:​//example.com/?token={token}, si utiliza un dominio personalizado
• https:​//example.xsollasitebuilder.com/?token={token}, si utiliza un dominio de Xsolla

Dentro de Site Builder

1. Abra el proyecto en la Cuenta del editor.
2. En el menú lateral, haga clic en Site Builder (Creador de sitios web).
3. Haga clic en Configure en la ficha del sitio de su Web Shop con autenticación mediante ID de usuario.
4. Vaya a Login Settings y seleccione la sección User ID.
5. Establezca el conmutador Deeplink authorization en la posición On.

6. En el campo Deeplink URL, introduzca el enlace para la autenticación del usuario.

7. Si está utilizando el bloque Fast Login en el sitio web:
   1. Vaya al bloque Fast Login.
   2. En la sección Layout, ponga el conmutador QR code en la posición On.

8. Para verificar la autenticación, haga clic en Preview.
9. Para publicar el sitio web, haga clic en Publish.