PlayFab-Speicher

Bei Nutzung des PlayFab-Speichers haben Sie Zugriff auf:

• Benutzerregistrierung
• Authentifizierung über E-Mail-Adresse und Passwort des Benutzers
• Authentifizierung über Twitch
• Zurücksetzen von Benutzerpasswörtern
• Nutzer sperren

Interaktionsablauf

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 Endpunkten JWT, OAuth 2.0 und Password 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

Die Benutzerregistrierung läuft wie hier beschrieben ab. Sie können die Kontobestätigungs-E-Mail einrichten, mit der Ihre Benutzer die Registrierung abschließen können.

Ablauf der Benutzerregistrierung

1. Der Client sendet die Anfrage Register new user 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 eine Anfrage an PlayFab, die Nutzerdaten zu ändern.
5. Wenn Sie die Kontobestätigung eingerichtet haben:
   • und die Login API-Aufrufe zur Integration der Lösung nutzen, gilt die Registrierung als abgeschlossen.
   • 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 {email address} gesendet.
   Wenn Sie die Kontobestätigung nicht eingerichtet haben, erfolgt die Anmeldung des Benutzers automatisch nach Abschluss der Registrierung.

Benutzerkontobestätigung in PlayFab

1. Folgen Sie der Anleitung, um Ihr Projekt in PlayFab einzurichten.
2. Sie müssen die Schritte Erstellen einer E-Mail-Vorlage und Erstellen einer Regel zum Senden einer E-Mail beim Aktualisieren einer Kontakt-E-Mail aus dem Modul Voraussetzungen abschließen.
3. Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.

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 dem JWT-Standard und basierend auf dem OAuth 2.0-Protokoll.

Ablauf bei der auf dem JWT-Standard basierenden Authentifizierung

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.
   • der SessionTicket-Wert aus der Antwort auf die PlayFab-Anfrage in den session_ticket-Anspruch geschrieben wird.
   • die EntityToken-Werte aus der Antwort auf die PlayFab-Anfrage in den entity_token-, entity_id- und entity_type-Anspruch geschrieben werden.
4. Der Benutzer wird mithilfe des Abfrageparameters token zur login_url weitergeleitet. Dabei wird der Benutzer-JWT in den token-Parameter geschrieben.

Ablauf bei der auf dem OAuth 2.0-Protokoll basierenden Authentifizierung

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 antwortet mit der login_url samt code im Abfrageparameter sowie mit dem übermittelten Parameter redirect_uri.
4. Der Benutzer wird mithilfe des Abfrageparameters code zur redirect_uri weitergeleitet.
5. Der Client sendet die Anfrage Generate 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.
   • der SessionTicket-Wert 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.
   • die EntityToken-Werte aus der Antwort auf die PlayFab-Anfrage in den entity_token-, entity_id- und entity_type-Anspruch geschrieben werden.

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 de JWT-Standard und basierend auf dem OAuth 2.0-Protokoll.

Ablauf bei der auf dem JWT-Standard basierenden Authentifizierung

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.
   • der SessionTicket-Wert aus der Antwort auf die PlayFab-Anfrage in den session_ticket-Anspruch geschrieben wird.
   • die EntityToken-Werte aus der Antwort auf die PlayFab-Anfrage in den entity_token-, entity_id- und entity_type-Anspruch geschrieben werden.
5. Der Benutzer wird mithilfe des Abfrageparameters token zur login_url weitergeleitet. Dabei wird der Benutzer-JWT in den token-Parameter geschrieben.

Ablauf bei der auf dem OAuth 2.0-Protokoll basierenden Authentifizierung

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 mithilfe des Abfrageparameters code zur redirect_uri weitergeleitet.
6. Der Client sendet die Anfrage Generate 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.
   • der SessionTicket-Wert aus der Antwort auf die PlayFab-Anfrage in den session_ticket-Anspruch geschrieben wird, wenn Sie scope=playfab an die Twitch-Authentifizierungsanfrage übermittelt haben.
   • die EntityToken-Werte aus der Antwort auf die PlayFab-Anfrage in den entity_token-, entity_id- und entity_type-Anspruch geschrieben werden.

Twitch-Authentifizierung einrichten

1. Erstellen Sie Ihr Twitch-Konto, und notieren Sie sich die Twitch Client ID.
2. Wechseln Sie ins Kundenportal, und navigieren Sie zu Ihr Projekt > Login.
3. Klicken Sie beim gewünschten Login-Projekt auf Konfigurieren.
4. Scrollen Sie zum Block Authentifizierung, und klicken Sie auf Anmeldung über soziale Netzwerke. Klicken Sie bei Twitch auf das ⚙-Symbol und dann auf Einstellungen. Geben Sie Ihre Twitch Client ID in das Feld Anwendungs-ID ein.
5. Nehmen Sie bei Bedarf weitere Einstellungen vor.
6. Klicken Sie auf Verknüpfen.
7. Richten Sie Twitch in Ihrem PlayFab-Konto ein.
8. Falls das Login-Produkt über die Login API-Aufrufe integriert wurde:
   1. Rufen Sie einen Link für die Authentifizierung über Twitch ab. Verwenden Sie dazu den Authentifizierungsaufruf des sozialen Netzwerks (JWT oder OAuth 2.0). Platzieren Sie den erhaltenen Link auf der Benutzeroberfläche Ihrer Anwendung.

Benutzerpasswörter zurücksetzen

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.

Nutzer sperren

Sie können Benutzer im Kundenportal sperren. Gesperrte Nutzer können sich nicht authentifizieren. Die Sperrung wird nur aufseiten von Xsolla erfasst und gespeichert.

Weitere Informationen