Ablauf für den Nutzer

1. Der Benutzer wechselt in den Webshop, wo bereits die Benutzer-ID-Authentifizierung eingerichtet ist.
2. Der Benutzer klickt unter dem gewünschten Artikel auf Jetzt kaufen oder in der oberen Leiste auf Anmelden.
3. Daraufhin erscheint ein Modalfenster. Dort wird der Benutzer gebeten, seine ID einzugeben oder ein soziales Netzwerk auszuwählen.

4. Der Benutzer gibt seine ID ein und klickt auf Weiter. Alternativ kann er auch auf das entsprechende Social-Media-Symbol klicken und die Authentifizierung auf der Seite des sozialen Netzwerks abschließen.
5. Das System prüft, ob der Benutzer im Spiel existiert. Wenn ein Benutzer mit dieser ID bzw. diesem Social-Media-Konto im Spiel vorhanden ist, wird er im Webshop autorisiert. Andernfalls wird eine Fehlermeldung angezeigt.

Wie komme ich dazu

1. Implementieren Sie aufseiten Ihrer Anwendung das Handling des Webhooks für die Benutzervalidierung.

Beim Empfang eines Webhooks sollte die Anwendung Folgendes tun:

• Nach einem Benutzer anhand seiner im Webhook übermittelten ID suchen.
• Je nach Ergebnis einen der folgenden HTTP-Statuscodes senden:
  • 200 inklusive einer Antwort vom Webhook, sofern ein Benutzer gefunden wurde
  • 404, sofern keine Benutzer-ID gefunden wurde
• Benutzerattribute zum Zwecke der Personalisierung senden.

2. Wechseln Sie im Kundenportal zum Abschnitt Website-Baukasten.
3. Klicken Sie auf Website-Baukasten öffnen.
4. Öffnen Sie den Block Login-Einstellungen.

5. Wählen Sie die Option Benutzer-ID aus.

6. Wählen Sie in der Drop-down-Liste Neuer Login aus.

7. Geben Sie die URL für den Empfang von Webhooks ein.

8. Konfigurieren Sie die Autorisierung über soziale Netzwerke, die bereits mit Ihrer Anwendung verknüpft sind (optional):
   1. Öffnen Sie Ihr Projekt im Kundenportal, und wechseln Sie zum Abschnitt Login.
   2. Klicken Sie auf Konfigurieren.
   3. Scrollen Sie zum Block Authentifizierung, und klicken Sie auf Anmeldung über soziale Netzwerke.

1. 4. Klicken Sie auf der Karte des gewünschten sozialen Netzwerks, rechts neben dem Titel, auf das ⚙-Symbol und dann auf Verknüpfen.

Wie komme ich dazu

1. Wechseln Sie im Baukasten Ihrer Website zum Block Login-Einstellungen.

2. Wählen Sie die Autorisierungsoption Xsolla-Login aus.
3. Wählen Sie in der Drop-down-Liste Neuer Login aus.

4. Wechseln Sie aus dem Modalfenster zu den Login-Projekteinstellungen oder klicken Sie im Block Xsolla-Login auf Konfigurieren Sie die Authentifizierungsmethoden.

5. Benutzerdatenspeicher verknüpfen.

Je nachdem, wo die Nutzerdaten gespeichert sind, sind verschiedene Produktfunktionen verfügbar (siehe Vergleich der Nutzerdatenspeicher-Möglichkeiten).

Xsolla-Speicher

Wenn Sie möchten, dass Login die gesamte Authentifizierungslogik verarbeitet, verknüpfen Sie den Xsolla-Speicher. Infolgedessen stehen Ihnen flexiblere Einstellungen zur Verfügung.

Wenn Sie ein Login-Projekt erstellen, wird standardmäßig der Xsolla-Speicher verknüpft, es sind keine weiteren Schritte zur Konfiguration erforderlich. Gehen Sie wie folgt vor, wenn Sie den standardmäßigen Speichertyp geändert haben und den Xsolla-Speicher erneut verknüpfen müssen:

1. Scrollen Sie auf der Navigationsseite zum Block Nutzerdatenbank, und klicken Sie auf Speicher.
2. Wählen Sie Xsolla-Speicher aus, und klicken Sie auf Speichern.

PlayFab-Speicher

Wenn Sie die PlayFab-Funktionen für die Arbeit mit Benutzern verwenden möchten, verknüpfen Sie den PlayFab-Speicher. Im Speicher werden folgende Nutzerdaten hinterlegt:

• Benutzername
• E-Mail-Adresse des Benutzers
• Benutzerpasswort
• Felder aus einem erweiterten Registrierungsformular, sofern das Formular eingerichtet ist

Der PlayFab-Speicher ermöglicht Ihnen den Zugriff auf folgende Funktionen:

• Benutzerregistrierung
• Authentifizierung über E-Mail-Adresse oder Benutzername und Passwort
• Authentifizierung über Twitch
• Zurücksetzen von Benutzerpasswörtern
• Benutzer sperren

So verknüpfen Sie den Speicher:

1. Scrollen Sie auf der Navigationsseite zum Block Nutzerdatenbank, und klicken Sie auf Speicher.
2. Wählen Sie PlayFab aus.
3. Geben Sie im Feld Titel-ID den Wert des gleichnamigen Felds aus Ihrem PlayFab-Konto ein.
4. Klicken Sie auf Speichern.

Firebase-Speicher

Wenn Sie die Firebase-Funktionen für Benutzer verwenden möchten, verknüpfen Sie den Firebase-Speicher. In diesem Speicher sind folgende Nutzerdaten hinterlegt:

• Benutzername
• E-Mail-Adresse des Benutzers
• Benutzerpasswort
• Felder aus einem erweiterten Registrierungsformular, sofern das Formular eingerichtet ist

So verknüpfen Sie den Speicher:

1. Scrollen Sie auf der Navigationsseite zum Block Nutzerdatenbank, und klicken Sie auf Speicher.
2. Wählen Sie Firebase aus.
3. Geben Sie im Feld API-Schlüssel den Wert des gleichnamigen Felds aus Ihrem Firebase-Konto ein.
4. Klicken Sie auf Speichern.

Kundenseitiger Speicher

Verknüpfen Sie den eigenen Speicher, wenn Sie ein eigenes Autorisierungssystem verwenden und Benutzerdaten aufseiten Ihrer Anwendung speichern.

Der eigene Speicher ermöglicht Ihnen den Zugriff auf folgende Funktionen:

• Benutzerregistrierung
• Authentifizierung über E-Mail-Adresse oder Benutzername und Passwort
• Passwortlose Authentifizierung über eine Telefonnummer
• Authentifizierung über soziale Netzwerke
• Zurücksetzen von Benutzerpasswörtern

So konfigurieren Sie die Verbindung zwischen dem Xsolla-Login-Server und Ihrer Client-Anwendung:

1. Verknüpfen Sie den eigenen Speicher.
2. Konfigurieren Sie die Verarbeitung von Anfragen vom Xsolla-Login-Server.

Kundenseitigen Speicher verknüpfen

1. Scrollen Sie auf der Navigationsseite zum Block Nutzerdatenbank, und klicken Sie auf Speicher.
2. Wählen Sie Eigener Speicher aus.
3. Geben Sie die URLs ein, an die die API-Anfragen gesendet werden sollen:
   • URL für die Nutzerverifizierung
   • URL für neue Nutzer
   • URL zum Zurücksetzen des Passworts
   • URL für das passwortlose Anmelden mittels Mobiltelefons
   • URL für die Anmeldung über soziale Netzwerke
4. Klicken Sie auf Speichern.
5. Implementieren Sie für die festgelegten URLs eine API, die wie folgt antwortet:
   • mit dem Statuscode HTTP 200/HTTP 205 bei erfolgreichen Anfragen. Bei Bedarf kann ein JSON mit zusätzlichen Benutzerdaten in den Antwortrumpf eingefügt werden. Die übermittelten Daten werden in ein JWT geschrieben (Parameter partner_data).
   • mit einem sonstigen HTTP-Statuscode bei einer fehlgeschlagenen Anfrage.

Verarbeitung von Anfragen vom Xsolla-Login-Server einrichten

Anfragen des Xsolla-Login-Servers werden samt Header Authorization: Bearer <JWT> an die von Ihnen im Kundenportal angegebenen URLs gesendet. Der JWT wird mit dem geheimen Schlüssel Ihres Projekts unterzeichnet.

So verarbeiten Sie eine Anfrage:

1. Validieren Sie einen empfangenen JWT.
2. Dekodieren Sie bei erfolgreicher Validierung das JWT und stellen Sie sicher, dass es die Claims aus der folgenden Tabelle enthält. Finden und verwenden Sie eine Bibliothek für die Dekodierung.

Beispiel einer Token-Payload:

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