Dies ist ein individuelles LLM für Xsolla, es darf auf die Entwicklerdokumentation, die API-Referenz, den Partner-Support und verschiedenen SDKs zugreifen. Beachten Sie, dass die Antworten KI-generiert sind, nutzen Sie also bitte Ihr Urteilsvermögen.
Oder wählen Sie häufig gestellte Fragen aus:
Wie wird man Xsolla-Partner?
Wo finde ich die Projekt-ID?
Wie hoch sind die Gebühren bei Xsolla?
Wie integriert man Web Shop?
Die Antwort basiert auf den folgenden Quellen:
Sie können den Dialog fortsetzen, indem Sie Text in die Suchleiste eingeben.
Vereinfacht die Integration des Web Shops in das Spiel.
Das Authentifizierungs-Widget erfordert keine Registrierung oder Passworteingabe. Der Nutzer muss lediglich die Benutzer-ID aus dem Spiel eingeben oder dasselbe Social-Media-Konto für die Anmeldung verwenden, das er auch für die Anmeldung beim Spiel verwendet.
Hinweis
Die Authentifizierung anhand der Benutzer-ID sollten Sie verwenden, wenn Xsolla Login in Ihrem Spiel nicht eingerichtet ist.
Bietet eine breite Palette von Autorisierungsmethoden: soziale Netzwerke, Einmalcodes oder ‑Links sowie Benutzername und Passwort.
Ermöglicht es Ihnen, das Xsolla Login-Widget anzupassen.
Sie können eine Altersbeschränkung für die Autorisierung festlegen.
Hinweis
Verwenden Sie die Authentifizierung über Xsolla Login, wenn diese Lösung bereits in Ihrem Spiel eingerichtet ist.
Für jede der Authentifizierungsmethoden können Sie einen Fast-Login-Block Ihrer Website hinzufügen.
Ablauf für den Nutzer
Der Nutzer öffnet den Web Shop, für den die Authentifizierung über Benutzer-ID konfiguriert ist.
Der Nutzer autorisiert sich im Web Shop auf eine der folgenden Arten:
Der Nutzer gibt seine ID im Block "Fast Login" ein und klickt auf "Anmelden".
Der Nutzer klickt bei dem ausgewählten Artikel auf "Kaufen" oder oben in der Leiste auf "Anmelden":
Daraufhin öffnet sich ein Modalfenster, in dem der Nutzer seine ID eingeben oder ein soziales Netzwerk auswählen muss.
Der Nutzer gibt seine ID ein und klickt auf Weiter. Alternativ klickt der Nutzer auf das Social-Media-Symbol, wählt ein soziales Netzwerk aus und schließt die Authentifizierung auf der Seite des sozialen Netzwerks ab.
Das System prüft, ob der Nutzer im Spiel existiert. Wenn ein Nutzer mit dieser ID oder diesem Social-Media-Konto im Spiel existiert, wird er im Web Shop autorisiert. Andernfalls wird eine Fehlermeldung angezeigt.
Die Widget-Anpassungseinstellungen im Login-Projekt haben keinen Einfluss auf die Bedienoberfläche der Benutzer-ID-Authentifizierung.
Wählen Sie in der Drop-down-Liste Neuer Login aus.
Geben Sie die URL für den Empfang von Webhooks ein.
Hinweis
Webhook-URLs sollten mit https:// beginnen. Die Angabe von http:// führt zu einem Fehler.
Hinweis
Standardmäßig wird der Xsolla-Speicher verwendet. Wir empfehlen Ihnen, diese Einstellung im Kundenportal nicht zu ändern, da der Xsolla-Speicher mehr Einstellmöglichkeiten bietet.
Konfigurieren Sie die Autorisierung über soziale Netzwerke, die bereits mit Ihrer Anwendung verknüpft sind (optional):
Öffnen Sie Ihr Projekt im Kundenportal, und wechseln Sie zum Abschnitt Login.
Klicken Sie auf Konfigurieren.
Scrollen Sie zum Block Authentifizierung, und klicken Sie auf Anmeldung über soziale Netzwerke.
Klicken Sie auf der Karte des gewünschten sozialen Netzwerks, rechts neben dem Titel, auf das ⚙-Symbol und dann auf Verknüpfen.
Hinweis
Um die Autorisierung über soziale Netzwerke verwenden zu können, müssen Sie die Anwendungs-ID und den geheimen Schlüssel der Anwendung in Ihrem Projekt eingeben. Das können Sie in den Einstellungen auf der Karte des jeweiligen sozialen Netzwerks erledigen. Die Anwendungs-ID und den geheimen Schlüssel finden Sie im Entwicklerkonto des Social-Media-Anbieters. Detaillierte Anweisungen dazu finden Sie im Kundenportal in den Einstellungen auf der Karte des jeweiligen sozialen Netzwerks.
Ablauf für den Nutzer
Der Nutzer öffnet den Web Shop, für den die Authentifizierung über Xsolla Login konfiguriert ist.
Der Nutzer klickt bei dem ausgewählten Artikel auf die Schaltfläche “Kaufen”, auf die Schaltfläche “Anmelden” in der oberen Leiste oder auf die Schaltfläche “Anmelden” im Block “Fast Login”.
Daraufhin öffnet sich ein Modalfenster, darin werden die in Xsolla Login eingerichteten Autorisierungsmethoden angezeigt.
Der Nutzer fährt mit der Autorisierung fort und gibt ggf. weitere Daten ein.
Das System prüft, ob der Nutzer im Spiel existiert. Wenn der Nutzer im Spiel existiert, wird er im Web Shop autorisiert. Andernfalls wird eine Fehlermeldung angezeigt.
Wie komme ich dazu
Wechseln Sie im Baukasten Ihrer Website zum Block Login-Einstellungen.
Wählen Sie die Autorisierungsoption Xsolla Login aus.
Wählen Sie in der Drop-down-Liste Neuer Login aus.
Hinweis
Daraufhin wird automatisch ein Login-Projekt erstellt, bei dem die Benutzerauthentifizierung per E-Mail-Adresse und Passwort erfolgt. Für das erstellte Login-Projekt wird die Web Shop-URL in Form einer Rückruf-URL angegeben, an die der Benutzer in den folgenden Fällen weitergeleitet wird:
nach erfolgreicher Authentifizierung
nach erfolgreicher Bestätigung der E-Mail-Adresse
nach dem Zurücksetzen des Passworts
im Falle eines Authentifizierungsfehlers
Wenn Sie die Domain des Web Shops ändern, ändert sich auch automatisch die Rückruf-URL in den Login-Projekteinstellungen.
Wechseln Sie aus dem Modalfenster zu den Login-Projekteinstellungen oder klicken Sie im Block Xsolla Login auf Konfigurieren Sie die Authentifizierungsmethoden.
Hinweis
Um die Authentifizierung im Web Shop zu ermöglichen, konfigurieren Sie dieselben sozialen Netzwerke wie für die Authentifizierung in Ihrer Anwendung. Wenn keine sozialen Netzwerke konfiguriert sind, ist die Benutzerauthentifizierung nur per E-Mail-Adresse und Passwort möglich.
Wenn Sie die Authentifizierung über soziale Netzwerke für den Web Shop einrichten, verwenden Sie dieselbe Anwendungs-ID und denselben geheimen Schlüssel wie für die Authentifizierung in Ihrer Anwendung.
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.
Hinweis
Xsolla-Speicher unterstützt die auf dem JWT-Standard basierende Authentifizierung und die auf dem OAuth 2.0-Protokoll basierende Authentifizierung. Alle Nutzerdaten werden bei Xsolla gespeichert.
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
Hinweis
Der PlayFab-Speicher unterstützt die auf dem JWT-Standard basierende Authentifizierung und die auf dem OAuth 2.0-Protokoll basierende Authentifizierung.
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.
Hinweis
Alle Nutzerdaten sind bei Xsolla gespeichert. Lediglich die Benutzerpasswörter werden über den PlayFab-Speicher verifiziert.
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
Hinweis
Der Firebase-Speicher unterstützt die auf dem JWT-Standard basierende Authentifizierung und die auf dem OAuth 2.0-Protokoll basierende Authentifizierung.
So verknüpfen Sie den Speicher:
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.
Hinweis
Alle Nutzerdaten werden im JSON-Format gespeichert und mit jedem verbundenen Client in Echtzeit aktualisiert.
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
Hinweis
Der eigene Speicher unterstützt die auf dem JWT-Standard basierende Authentifizierung.
So konfigurieren Sie die Verbindung zwischen dem Xsolla Login-Server und Ihrer Client-Anwendung:
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.
Hinweis
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.
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.
Der Block “Fast Login” bietet Nutzern eine weitere Möglichkeit, sich auf der Website zu authentifizieren.
Das Erscheinungsbild des Blocks und dessen Funktionen hängen von der ausgewählten Authentifizierungsmethode ab.
Ist für die Website die Option Authentifizierung über Benutzer-ID konfiguriert, wird im Block “Fast Login” ein Feld für die Eingabe der ID und eine Anmeldeschaltfläche angezeigt.
Merkmale:
Benutzerauthentifizierung ohne Umweg über das Modalfenster
Einrichtung des Blockinhalts. Folgende Abschnitte können Sie aktivieren und konfigurieren:
Titel
Beschreibung
Anweisungen zum Auffinden der Benutzer-ID
Benutzerdefinierter Hintergrund
Sie können den Funktionsumfang des Blocks auch per JS-Code erweitern, z. B. Text, eine Schaltfläche oder ein Bild hinzufügen.
Ist die Option Authentifizierung über Xsolla Login für die Website konfiguriert, wird im Block “Fast Login” eine zusätzliche Schaltfläche angezeigt, die zur Autorisierung auffordert. Wenn man auf die Schaltfläche klickt, öffnet sich ein Modalfenster, in dem sich der Nutzer über eine der in Xsolla Login konfigurierten Methoden autorisieren kann.
Merkmale:
Text der Autorisierungsschaltfläche bearbeitbar
benutzerdefinierter Hintergrund festlegbar
Sie können den Funktionsumfang des Blocks auch per JS-Code erweitern, z. B. Text, eine Schaltfläche oder ein Bild hinzufügen.
Bei neuen Websites ist, sofern die Vorlage “Web Shop” gewählt wurde, der Block “Fast Login” standardmäßig vorhanden. Sie können den Block bei Bedarf entfernen.
Wenn Sie eine Website in der Vergangenheit erstellt haben und diese keinen “Fast Login”-Block enthält, können Sie den Block hinzufügen.
Wählen Sie im Abschnitt Seiten die gewünschte Website aus, und klicken Sie auf Site Builder öffnen.
Klicken Sie auf Block hinzufügen.
Wählen Sie die Option Fast Login.
Hinweis
Bevor Sie den Block “Fast Login” verwenden, sollten Sie in den Login-Einstellungen eine Autorisierungsoption aus der Drop-down-Liste auswählen.
Für die Methode “Authentifizierung über Benutzer-ID” müssen Sie in den Login-Einstellungen außerdem die URL angeben, die den Webhook empfangen soll. Ist keine URL angeben, lässt sich die Website nicht veröffentlicht, weil die Benutzerauthentifizierung nicht verfügbar ist.
In der Website-Vorschau ist es auch ohne angegebene Webhook-URL möglich, Benutzer zu authentifizieren.