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

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 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 auf der Navigationsseite zum Block Authentifizierung, und klicken Sie auf Anmeldung über soziale Netzwerke. Klicken Sie bei Twitch Sie 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. Bei Integration des Login-Produkts über die Login API-Aufrufe:
   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.

Diese Seite bewerten

Gibt es etwas, das wir verbessern können? Senden

Jetzt nicht

Vielen Dank für Ihr Feedback!

Weitere Informationen