PlayFab

So funktioniert's

Sie können PlayFab als Speicher für folgende Benutzerdaten verwenden:

  • Benutzername
  • E-Mail-Adresse des Benutzers
  • Passwort des Benutzers
  • Felder aus einem erweiterten Registrierungsformular, sofern das Formular eingerichtet wurde
Die Benutzerdaten werden zudem aufseiten von Xsolla gespeichert, allerdings werden die Passwörter nur durch PlayFab geprüft.

Bei Nutzung des PlayFab-Speichers haben Sie Zugriff auf folgende Funktionen:

Sie können das Login-Widget oder Ihre Anwendung als Client einsetzen. Die Interaktion zwischen dem Client und dem Xsolla-Login-Server läuft wie folgt ab:

  1. Der Client sendet Anfragen an den Xsolla-Login-Server. Das Anfrageformat ist in den Methodengruppen JWT, OAuth 2.0 und General erläutert.
  2. Der Xsolla-Login-Server sendet Anfragen an PlayFab.
  3. Der Xsolla-Login-Server verarbeitet eine Antwort von PlayFab und sendet die Ergebnisse an den Client zurück.
  4. Der Client verarbeitet die Antwort.

Benutzerregistrierung in PlayFab

Der Ablauf der Benutzerregistrierung ist im Folgenden beschrieben. Sie können das Senden der E-Mail für die Bestätigung des Benutzerkontos einrichten, um die Benutzerregistrierung abzuschließen.

Ablauf der Benutzerregistrierung

  1. Der Client sendet die Anfrage Register an den Xsolla-Login-Server.
  2. Der Xsolla-Login-Server sendet eine Registrierungsanfrage.
  3. Die Benutzerdaten werden in die Xsolla-Datenbank geschrieben.
  4. Der Xsolla-Login-Server sendet die Anfrage, um Daten in PlayFab zu ändern.
  5. Wenn Sie die Kontobestätigung eingerichtet haben:
    1. und die API-Methoden zur Integration der Lösung nutzen, gilt die Registrierung als abgeschlossen.
    2. und das Login-Widget zur Integration der Lösung nutzen, wird der Benutzer an eine Seite mit folgender Nachricht weitergeleitet: Die E-Mail für die Kontobestätigung wurde an {E-Mail-Adresse} gesendet.
    Wenn Sie die Kontobestätigung nicht eingerichtet haben, erfolgt die Anmeldung des Benutzers automatisch nach Abschluss der Registrierung.

Benutzerkontobestätigung in PlayFab

Führen Sie die folgenden Schritte aus, um die E-Mail für die Kontobestätigung einzurichten:

  1. Folgen Sie der Anleitung, um Ihr Projekt in PlayFab einzurichten.
  2. Sie müssen die Schritte Create an email template und Create a rule to send an email when a contact email is updated aus dem Modul Requirements abschließen.
  3. Wenden Sie sich an Ihren Account Manager.

Note: Der Benutzer, welcher sich für das mit PlayFab verbundene Projekt registriert hat, kann sich anmelden, ohne seine E-Mail-Adresse bestätigen zu müssen.

Authentifizierung über E-Mail-Adresse und Passwort des Benutzers

Es gibt zwei Arten der Authentifizierung über E-Mail-Adresse und Passwort des Benutzers: Basierend auf einem JWT und basierend auf dem OAuth 2.0-Protokoll.

Authentifizierung (JWT):

  1. Der Client sendet die Anfrage Auth by Username and Password an den Xsolla-Login-Server.
  2. Der Xsolla-Login-Server sendet die Authentifizierungsanfrage an PlayFab.
  3. Der Xsolla-Login-Server generiert ein Benutzer-JWT, wobei:
    • der PlayFabId-Wert aus der Antwort auf die PlayFab-Anfrage in den external_account_id-Anspruch geschrieben wird.
    • das SessionTicket aus der Antwort auf die PlayFab-Anfrage in den session_ticket-Anspruch geschrieben wird.
  4. Der Benutzer wird mittels Abfrageparameter-token an die login_url weitergeleitet. Dabei wird ein Benutzer-JWT in den token-Parameter geschrieben.

Authentifizierung (OAuth 2.0):

  1. Der Client sendet die Anfrage Auth by Username and Password samt Parameter redirect_uri an den Xsolla-Login-Server.
  2. Der Xsolla-Login-Server sendet die Authentifizierungsanfrage an PlayFab.
  3. Der Xsolla-Login-Server gibt die login_url samt code in einem Abfrageparameter zurück und übermittelt die redirect_uri.
  4. Der Benutzer wird mittels Abfrageparameter-code zur redirect_uri weitergeleitet.
  5. Der Client sendet die Anfrage Generate User JWT an den Xsolla-Login-Server, um den empfangenen code gegen einen Benutzer-JWT zu tauschen.
  6. Der Xsolla-Login-Server generiert einen Benutzer-JWT, wobei:
    • der PlayFabId-Wert aus der Antwort auf die PlayFab-Anfrage in den external_account_id-Anspruch geschrieben wird.
    • das SessionTicket aus der Antwort auf die PlayFab-Anfrage in den session_ticket-Anspruch geschrieben wird, wenn Sie scope=playfab an die Auth by Username and Password-Anfrage übermittelt haben.

Wenn keine Benutzerdaten im Xsolla-Speicher vorliegen:

  1. werden die Benutzerdaten dorthin geschrieben.
  2. sendet der Xsolla-Login-Server die Anfrage, um Daten in PlayFab zu ändern.

Authentifizierung über Twitch

Sie sollten ein soziales Netzwerk in PlayFab einrichten, damit Sie Benutzer über Twitch authentifizieren können. Es gibt zwei Arten der Authentifizierung über Twitch: Basierend auf einem JWT und basierend auf dem OAuth 2.0-Protokoll.

Authentifizierung (JWT):

  1. Der Client sendet die Anfrage Auth via Social Network an den Xsolla-Login-Server.
  2. Der Xsolla-Login-Server sendet die Authentifizierungsanfrage an PlayFab.
  3. Die Benutzerdaten werden in die Xsolla-Datenbank geschrieben.
  4. Der Xsolla-Login-Server generiert ein Benutzer-JWT, wobei:
    • der PlayFabId-Wert aus der Antwort auf die PlayFab-Anfrage in den external_account_id-Anspruch geschrieben wird.
    • das SessionTicket aus der Antwort auf die PlayFab-Anfrage in den session_ticket-Anspruch geschrieben wird.
  5. Der Benutzer wird mittels Abfrageparameter-token an die login_url weitergeleitet. Dabei wird ein Benutzer-JWT in den token-Parameter geschrieben.

Authentifizierung (OAuth 2.0):

  1. Der Client sendet die Anfrage Auth via Social Network samt Parameter redirect_uri an den Xsolla-Login-Server.
  2. Der Xsolla-Login-Server sendet die Authentifizierungsanfrage an PlayFab.
  3. Die Benutzerdaten werden in die Xsolla-Datenbank geschrieben.
  4. Der Xsolla-Login-Server sendet die Anfrage, um Daten in PlayFab zu ändern.
  5. Der Benutzer wird mittels Abfrageparameter-code an die redirect_uri weitergeleitet.
  6. Der Client sendet die Anfrage Generate User JWT an den Xsolla-Login-Server, um den empfangenen code gegen einen Benutzer-JWT zu tauschen.
  7. Der Xsolla-Login-Server generiert einen Benutzer-JWT, wobei:
    • der PlayFabId-Wert aus der Antwort auf die PlayFab-Anfrage in den external_account_id-Anspruch geschrieben wird.
    • das SessionTicket aus der Antwort auf die PlayFab-Anfrage in den session_ticket-Anspruch geschrieben wird, wenn Sie scope=playfab an die Twitch-Authentifizierungsanfrage übermittelt haben.

Info: Wenn der Benutzerdatensatz in PlayFab mit dem Twitch-Konto verknüpft ist, wird es als ein Konto betrachtet.

Zurücksetzen von Benutzerpasswörtern

Das Zurücksetzen von Benutzerpasswörtern läuft wie folgt ab:

  1. Der Client sendet die Anfrage Reset Password an den Xsolla-Login-Server.
  2. Der Xsolla-Login-Server sendet die Anfrage zum Zurücksetzten des Passworts an PlayFab.
  3. Das aktualisierte Passwort wird in den PlayFab-Speicher geschrieben.

Sperren von Benutzern

Sie können Benutzer im Kundenportal unter Ihrem Login-Projekt > Nutzer sperren. Gesperrte Benutzer können sich nicht authentifizieren. Der Datensatz, welcher Informationen über die Sperrung enthält, wird nur in der Xsolla-Datenbank gespeichert.

Für wen ist es

Partner, die bereits Login integriert haben und über ein Projekt in PlayFab verfügen.

Wie komme ich dazu

So verknüpfen Sie einen PlayFab-Speicher:

  1. Navigieren Sie im Kundenportal zu Ihrem Login-Projekt > Allgemeine Einstellungen.
  2. Wählen Sie im Abschnitt Nutzerdatenspeicherung die Option PlayFab aus.
  3. Geben Sie die Title ID aus Ihrem PlayFab-Konto ein.

Info: Sie können die PlayFab-Methoden verwenden, um weitere E-Mails an Benutzer zu senden.

So richten Sie Twitch in PlayFab ein.

  1. Erstellen Sie Ihr Twitch-Konto und besorgen Sie sich die Twitch Client ID.
  2. Navigieren Sie zu Ihrem Login-Projekt > Social-Media-Einbindung.
  3. Verknüpfen Sie Twitch.tv, indem Sie die Twitch Client ID im Feld Application ID eingeben.
  4. Folgen Sie der Anleitung, um Twitch in einem PlayFab-Konto einzurichten.
  5. Wenn Sie Xsolla-Login über die API-Methoden integriert haben:
    1. rufen Sie den Link für die Authentifizierung über Twitch ab. Nutzen Sie dafür die Methode "Auth via Social Network" (JWT oder OAuth 2.0).
    2. Platzieren Sie den erhaltenen Link in Ihre Benutzeroberfläche.