Nutzerdatenspeicher 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:
- Scrollen Sie zum Block Nutzerdatenbank, und klicken Sie auf Speicher.
- 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:
- Scrollen Sie zum Block Nutzerdatenbank, und klicken Sie auf Speicher.
- Wählen Sie PlayFab aus.
- Geben Sie im Feld Titel-ID den Wert des gleichnamigen Felds aus Ihrem PlayFab-Konto ein.
- 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
- Scrollen Sie zum Block Nutzerdatenbank, und klicken Sie auf Speicher.
- Wählen Sie Firebase aus.
- Geben Sie im Feld API-Schlüssel den Wert des gleichnamigen Felds aus Ihrem Firebase-Konto ein.
- 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
- Verknüpfen Sie den eigenen Speicher.
- Konfigurieren Sie die Verarbeitung von Anfragen vom Xsolla Login-Server.
Kundenseitigen Speicher verknüpfen
- Scrollen Sie zum Block Nutzerdatenbank, und klicken Sie auf Speicher.
- Wählen Sie Eigener Speicher aus.
- Geben Sie die URLs ein, an die die API-Anfragen gesendet werden sollen:
- Klicken Sie auf Speichern.
- 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.
- 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
- Wenn Sie möchten, dass der JWT die Benutzer-ID aus Ihrer Datenbank enthält, wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.
- Damit die passwortlose Authentifizierung über eine Telefonnummer ordnungsgemäß funktioniert, muss Ihre API-Antwort den
account_id
-Parameter enthalten, der mit der Benutzer-ID aus dem Client übereinstimmt.
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:
- Validieren Sie einen empfangenen JWT.
- 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.
Claim | Typ | Beschreibung |
---|---|---|
exp | Unix Timestamp | Das Verfallsdatum und die Verfallsuhrzeit des JWT. Die JWT-Lebensspanne beträgt 7 Minuten. |
iat | Unix Timestamp | Das Ausgabedatum und die Ausgabeuhrzeit des JWT. |
iss | string | Der Dienst, der das JWT unterzeichnet hat https://login.xsolla.com . |
request_type | string | Konstant: gateway_request . |
xsolla_login_project_id | string (UUID) | Die ID Ihres Login-Projekts im Kundenportal. |
social_access_token | string (UUID) | Zugriffstoken des sozialen Netzwerks, über das der Nutzer authentifiziert wurde. Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie diesen Claim übermitteln möchten. |
- json
{
"exp": 1573635020,
"iat": 1573634600,
"iss": "https://login.xsolla.com",
"request_type": "gateway_request",
"xsolla_login_project_id": "00000000-0000-0000-0000-000000000000"
}
Weitere Informationen
Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.