Authentifizierung über Deep-Links einrichten

Deep Links ermöglichen es dem Nutzer, sich mit einem Klick über das Spiel im Web Shop zu authentifizieren, anstatt den Authentifizierungsprozess mittels Benutzer-ID oder Xsolla Login zu durchlaufen.

Ist das Spiel auf dem Mobilgerät des Nutzers installiert, wird dieser über einen Deep Link zum Spiel weitergeleitet und ein Autorisierungstoken abgerufen.

Ablauf für den Nutzer

In der mobilen App

1. Ein nicht autorisierter Nutzer klickt im Web Shop auf die Anmelden- oder Kaufen-Schaltfläche. Daraufhin öffnet sich ein Modalfenster zur Eingabe der Benutzer-ID oder zur Anmeldung beim Handyspiel.

2. Der Nutzer klickt auf die Anmelden-Schaltfläche.
3. Der Nutzer wird erst zum Spiel und dann automatisch als autorisierter Nutzer zum Web Shop weitergeleitet.

In der Desktop-Version

1. Ein nicht autorisierter Nutzer klickt im Web Shop auf die Anmelden- oder Kaufen-Schaltfläche. Daraufhin öffnet sich ein Modalfenster zur Eingabe der Benutzer-ID oder zur Anmeldung bei der mobilen Version des Spiels per QR-Code.

2. Der Nutzer scannt den QR-Code mit seinem Mobilgerät, daraufhin öffnet sich der Web Shop auf seinem Mobilgerät.
3. Die mobile Version des Spiels öffnet sich auf dem Mobilgerät des Nutzers.
4. Der Nutzer wird automatisch auf dem Mobilgerät als autorisierter Nutzer zum Web Shop weitergeleitet.

Interaktionsablauf

Einrichtung

Aufseiten des Spiels

1. Registrieren Sie in den Einstellungen Ihrer Spiele-App ein URL-Schema, um das Spiel über einen Deep Link zu öffnen:
   • in Android-Anwendungen – in der Datei AndroidManifest.xml
   • in iOS-Anwendungen – in der Datei Info.plist

• gamename der Name Ihres Spiels ist, das sich zum Zweck der Benutzerauthentifizierung auf einem Mobilgerät öffnen soll,
• authorize der Name einer beispielhaften Aktion ist, die nach dem Öffnen des Spiels “gamename” ausgeführt werden soll. Der Aktionsname muss mit dem Namen der entsprechenden Aktionen im Betriebssystem Ihrer Anwendung übereinstimmen.

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

Registrierung eines URL-Schemas in Android-Anwendungen (Beispiel):

<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. Implementieren Sie, dass ein Autorisierungstoken im JWT-Format mithilfe der spielpezifischen Benutzer-ID generiert wird.

Aufruf der API-Methode mittels curl für die Generierung des Benutzertokens (Beispiel):

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"
 }
}'

Die Antwort sieht in etwa wie folgt aus: {token=“JWT_TOKEN”}.

3. Fügen Sie ein Pop-up-Fenster mit einer Benachrichtigung über die erfolgreiche Autorisierung hinzu (optional).
4. Implementieren Sie, dass der Web Shop im Browser unter Verwendung des abgerufenen Benutzertokens geöffnet wird.

Erstellen einer URL für das Öffnen des Web Shops im Browser für einen autorisierten Nutzer (Beispiel):

• https:​//example.com/?token={token}, wenn Sie eine eigene Domain verwenden,
• https:​//example.xsollasitebuilder.com/?token={token}, wenn Sie eine Xsolla-Domain verwenden,

Innerhalb von Site Builder

1. Öffnen Sie das Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Site Builder.
3. Klicken Sie bei der gewünschten Web-Shop-Seite, für die eine Authentifizierung über Benutzer-ID eingerichtet ist, auf Konfigurieren.
4. Wechseln Sie zu den Login-Einstellungen, und wählen Sie Benutzer-ID.
5. Stellen Sie den Schalter Deep-Link-Autorisierung auf Ein.

6. Geben Sie im Feld Deep-Link-URL den Link für die Benutzerauthentifizierung ein.

7. Wenn Sie einen Fast Login-Block auf der Website platziert haben:
   1. wechseln Sie zum Fast Login-Block.
   2. Stellen Sie im Abschnitt Layout den Schalter QR-Code auf Ein.

8. Klicken Sie auf Vorschau, um die Authentifizierung zu überprüfen.
9. Klicken Sie auf Veröffentlichen, um die Website zu veröffentlichen.