Authentifizierung

In den folgenden Schritt-für-Schritt-Anleitungen erfahren Sie mehr über die grundlegenden SDK-Funktionen.

Benutzeranmeldung über Benutzername/E-Mail-Adresse und Passwort

Dieses Tutorial erläutert, wie sich mittels SDK-Methoden Folgendes implementieren lässt:
  • Benutzerregistrierung
  • erneutes Senden einer E-Mail zum Bestätigen der Registrierung
  • Benutzeranmeldung
  • Zurücksetzen des Benutzerpassworts
Quellcode
Den Quellcode für diese Beispiele finden Sie bei GitHub.

Sie können Benutzer anhand ihres Benutzernamens oder ihrer E-Mail-Adresse authentifizieren. In den folgenden Beispielen authentifizieren wir Benutzer anhand ihres Benutzernamens, während die E-Mail-Adresse zur Bestätigung der Registrierung und zum Zurücksetzen des Passworts verwendet wird.

Hinweis
Wenn Sie ein Login-Widget auf Ihrer Website verwenden (z. B. in einem Onlineshop), müssen auf Ihrer Website und in Ihrer Anwendung dieselben Benutzerauthentifizierungsmethoden implementiert sein. Das Widget verwendet standardmäßig die E-Mail-Adresse zur Authentifizierung. Um die Benutzeranmeldung über Benutzernamen einzurichten, wenden Sie sich an Ihren Account Manager.

Die Logiken und die Benutzeroberfläche in den Beispielen sind einfach gehalten und können in Ihrer Anwendung durchaus komplexer ausfallen. Eine mögliche Option zur Implementierung eines Authentifizierungssystems ist im Demoprojekt beschrieben.

Benutzerregistrierung implementieren

Widget erstellen

  1. Wechseln Sie zum Content Browser, und erstellen Sie ein UI-Verzeichnis. Navigieren Sie im Kontextmenü zu User Interface > Widget Blueprint.
  2. Fügen Sie im Widget-Blueprint folgende Benutzeroberflächenelemente hinzu:
    • Benutzername-Feld
    • E-Mail-Adresse-Feld
    • Benutzerpasswort-Feld
    • Registrierungsschaltfläche

Das folgende Bild zeigt einen beispielhaften Seitenaufbau.

  1. Öffnen Sie einen Level-Blueprint:
    1. Wählen Sie im Content Browser ein Level.
    2. Navigieren Sie im Hauptmenü zu Blueprints > Open Level Blueprint.
  2. Sorgen Sie dafür, dass das Widget beim Levelstart angezeigt wird. Fügen Sie dazu, wie unten gezeigt, Knoten hinzu. Geben Sie im CreateWidget-Knoten das erstellte Widget an.

Ereignisbehandlung hinzufügen

  1. Wählen Sie im Hierarchy-Fenster eine Registrierungsschaltfläche aus.
  2. Klicken Sie im Details-Fenster auf das +-Symbol neben dem On Clicked-Ereignis.
  1. Öffnen Sie eine Graph-Anzeige.
  2. Verknüpfen Sie einen RegisterUser-Methodenaufruf auf dem XsollaLoginSubsystem-Objekt mit dem OnClicked-Knoten, und fügen Sie die Übermittlung der von Benutzern eingegebenen Daten hinzu.
  3. Fügen Sie folgende Rückruffunktionen hinzu:
    • OnRegistered — wird nach erfolgreicher Registrierung aufgerufen
    • OnError — wird bei einem Problem aufgerufen
Hinweis
Im Beispiel der Ereignisbehandlung nutzen die Rückruffunktionen die Klasse PrintString. Ein Code und eine Fehlerbeschreibung werden in den Parametern Code und Description übermittelt. Sie können weitere Aktionen hinzufügen, z. B. eine Anmeldeseite oder eine Seite für das erneute Senden einer Bestätigungs-E-Mail nach erfolgreicher Registrierung öffnen.
  1. Starten Sie ein Level, um mit dem Widget-Debugging zu beginnen.

Beispielhafte Implementierung einer Ereignisbehandlung:

E-Mail für die Registrierungsbestätigung einrichten

Nach erfolgreicher Registrierung erhält der Benutzer eine E-Mail für die Registrierungsbestätigung an eine angegebene E-Mail-Adresse gesendet. Im Kundenportal können Sie die E-Mails individualisieren.

Wenn Sie eine Android-Anwendung entwickeln, richten Sie Deep-Links ein, damit Benutzer zur Anwendung weitergeleitet werden, nachdem sie die Registrierung bestätigt haben.

Anfrage zum erneuten Senden einer Registrierungsbestätigungs-E-Mail implementieren

Widget erstellen

  1. Wechseln Sie zum Content Browser, und öffnen Sie ein UI-Verzeichnis. Navigieren Sie im Kontextmenü zu User Interface > Widget Blueprint.
  2. Fügen Sie im Widget-Blueprint folgende Benutzeroberflächenelemente hinzu:
    • Benutzername-/E-Mail-Adresse-Feld
    • "E-Mail erneut senden"-Schaltfläche

Das folgende Bild zeigt einen beispielhaften Seitenaufbau.

  1. Öffnen Sie einen Level-Blueprint:
    1. Wählen Sie im Content Browser ein Level.
    2. Navigieren Sie im Hauptmenü zu Blueprints > Open Level Blueprint.
  2. Geben Sie im CreateWidget-Knoten das erstellte Widget an.

Ereignisbehandlung hinzufügen

  1. Wählen Sie im Hierarchy-Fenster eine "E-Mail erneut senden"-Schaltfläche aus.
  2. Klicken Sie im Details-Fenster auf das +-Symbol neben dem On Clicked-Ereignis.
  1. Öffnen Sie eine Graph-Anzeige.
  2. Verknüpfen Sie einen ResendAccountConfirmationEmail-Methodenaufruf auf dem XsollaLoginSubsystem-Objekt mit dem OnClicked-Knoten, und fügen Sie die Übermittlung der von Benutzern eingegebenen Daten hinzu.
  3. Fügen Sie die Rückruffunktionen OnEmailResent und OnError hinzu.
  4. Starten Sie ein Level, um mit dem Widget-Debugging zu beginnen.

Nach erfolgreicher Anfrage erhält der Benutzer eine E-Mail zur Registrierungsbestätigung an die bei der Registrierung angegebene E-Mail-Adresse.

Beispielhafte Implementierung einer Ereignisbehandlung:

Benutzeranmeldung implementieren

Widget erstellen

  1. Wechseln Sie zum Content Browser, und öffnen Sie ein UI-Verzeichnis. Navigieren Sie im Kontextmenü zu User Interface > Widget Blueprint.
  2. Fügen Sie im Widget-Blueprint folgende Benutzeroberflächenelemente hinzu:
    • Benutzername-Feld
    • Passwort-Feld
    • "Angemeldet bleiben"-Kontrollkästchen
    • Anmeldeschaltfläche

Das folgende Bild zeigt einen beispielhaften Seitenaufbau.

  1. Öffnen Sie einen Level-Blueprint:
    1. Wählen Sie im Content Browser ein Level.
    2. Navigieren Sie im Hauptmenü zu Blueprints > Open Level Blueprint.
  2. Geben Sie im CreateWidget-Knoten das erstellte Widget an.

Ereignisbehandlung hinzufügen

  1. Wählen Sie im Hierarchy-Fenster eine Anmeldeschaltfläche aus.
  2. Klicken Sie im Details-Fenster auf das +-Symbol neben dem On Clicked-Ereignis.
  1. Öffnen Sie eine Graph-Anzeige.
  2. Verknüpfen Sie einen AuthenticateUser-Methodenaufruf auf dem XsollaLoginSubsystem-Objekt mit dem OnClicked-Knoten, und fügen Sie die Übermittlung der von Benutzern eingegebenen Daten hinzu.
  3. Fügen Sie die Rückruffunktionen OnAuthenticated und OnError hinzu.
Hinweis
Nach erfolgreicher Benutzeranmeldung wird der Autorisierungstoken im Parameter LoginData übermittelt. Der Autorisierungstoken kommt in Anfragen an Xsolla-Server zum Einsatz.
  1. Starten Sie ein Level, um mit dem Widget-Debugging zu beginnen.

Beispielhafte Implementierung einer Ereignisbehandlung:

Zurücksetzen von Passwörtern implementieren

Widget erstellen

  1. Wechseln Sie zum Content Browser, und öffnen Sie ein UI-Verzeichnis. Navigieren Sie im Kontextmenü zu User Interface > Widget Blueprint.
  2. Fügen Sie im Widget-Blueprint folgende Benutzeroberflächenelemente hinzu:
    • Benutzername-/E-Mail-Adresse-Feld
    • "Passwort zurücksetzen"-Schaltfläche

Das folgende Bild zeigt einen beispielhaften Seitenaufbau.

  1. Öffnen Sie einen Level-Blueprint:
    1. Wählen Sie im Content Browser ein Level.
    2. Navigieren Sie im Hauptmenü zu Blueprints > Open Level Blueprint.
  2. Geben Sie im CreateWidget-Knoten das erstellte Widget an.

Ereignisbehandlung hinzufügen

  1. Wählen Sie im Hierarchy-Fenster eine "Passwort zurücksetzen"-Schaltfläche aus.
  2. Klicken Sie im Details-Fenster auf das +-Symbol neben dem On Clicked-Ereignis.
  1. Öffnen Sie eine Graph-Anzeige.
  2. Verknüpfen Sie einen ResetUserPassword-Methodenaufruf auf dem XsollaLoginSubsystem-Objekt mit dem OnClicked-Knoten, und fügen Sie die Übermittlung der von Benutzern eingegebenen Daten hinzu.
  3. Fügen Sie die Rückruffunktionen OnEmailSent und OnError hinzu.
  4. Starten Sie ein Level, um mit dem Widget-Debugging zu beginnen.

Beispielhafte Implementierung einer Ereignisbehandlung:

Nach einer erfolgreichen Anfrage zum Zurücksetzen des Passworts erhält der Benutzer eine E-Mail mit einem entsprechenden Link. Im Kundenportal können Sie unter Ihr Login-Projekt > Allgemeine Einstellungen > URL > Rückruf-URL eine URL-Adresse oder einen Pfad festlegen, an die bzw. der der Benutzer nach einer erfolgreichen Authentifizierung, der Bestätigung seiner E-Mail-Adresse oder dem Zurücksetzen seines Passworts weitergeleitet wird.

War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Ausblenden

Anmeldung über soziale Netzwerke

Diese Anleitung erläutert, wie Sie mithilfe von SDK-Methoden die Benutzerregistrierung und ‑anmeldung über Social-Media-Konten implementieren.

Im Gegensatz zur Benutzerauthentifizierung über Benutzername/E-Mail-Adresse und Passwort müssen Sie für die Benutzerregistrierung keine separate Logik implementieren. Wenn die erstmalige Anmeldung des Benutzers über ein soziales Netzwerk erfolgt, wird automatisch ein neues Konto erstellt.

Wenn Sie in Ihrer Anwendung die Anmeldung über soziale Netzwerke als alternative Authentifizierungsmethode implementiert haben, wird das Social-Media-Konto automatisch mit einem bestehenden Benutzerkonto verknüpft, sofern die folgenden Bedingungen erfüllt sind:

  • Ein Benutzer, der sich mittels Benutzername/E-Mail-Adresse und Passwort registriert hat, meldet sich über sein Social-Media-Konto bei Ihrer Anwendung an.
  • Das soziale Netzwerk gibt eine E-Mail-Adresse zurück.
  • Die E-Mail-Adresse des Benutzers in einem sozialen Netzwerk entspricht derselben E-Mail-Adresse, die für die Anmeldung bei Ihrer Anwendung verwendet wird.
Quellcode
Den Quellcode für diese Beispiele finden Sie bei GitHub.
Hinweis
Sie können die manuelle Verknüpfung von Social-Media-Konten implementieren. Fügen Sie dazu Ihrer Anwendung eine Seite hinzu, auf der Benutzer ihr Social-Media-Konto mit ihrem Benutzerkonto verknüpfen können. Verwenden Sie dafür im Page Controller die SDK-Methode LinkSocialNetworkToUserAccount.

Die Beispiele zeigen die Einrichtung der Benutzeranmeldung über ein Twitter-Konto. Andere soziale Netzwerke lassen sich auf dieselbe Weise einrichten.

Die Logiken und die Benutzeroberfläche in den Beispielen sind einfach gehalten und können in Ihrer Anwendung durchaus komplexer ausfallen. Eine mögliche Option zur Implementierung eines Authentifizierungssystems ist im Demoprojekt beschrieben.

Widget erstellen

  1. Wechseln Sie zum Content Browser, und erstellen Sie ein UI-Verzeichnis.
  2. Navigieren Sie im Kontextmenü zu User Interface > Widget Blueprint.
  3. Fügen Sie im Widget-Blueprint die Schaltfläche für das Anmelden über das soziale Netzwerk hinzu.

Das folgende Bild zeigt einen beispielhaften Seitenaufbau.

  1. Öffnen Sie einen Level-Blueprint:
    1. Wählen Sie im Content Browser ein Level.
    2. Navigieren Sie im Hauptmenü zu Blueprints > Open Level Blueprint.
  2. Sorgen Sie dafür, dass das Widget beim Levelstart angezeigt wird. Fügen Sie dazu, wie unten gezeigt, Knoten hinzu. Geben Sie im CreateWidget-Knoten das erstellte Widget an.

Ereignisbehandlung hinzufügen

  1. Wählen Sie im Hierarchy-Fenster eine Anmeldeschaltfläche aus.
  2. Klicken Sie im Details-Fenster auf das +-Symbol neben dem On Clicked-Ereignis.
  1. Öffnen Sie eine Graph-Anzeige.
  2. Implementieren Sie das Öffnen der Anmeldeseite in einem integrierten Browser:
    1. Verknüpfen Sie einen mit dem XsollaLoginSubsystem-Objekt verbundenen GetSocialAuthenticationUrl-Methodenaufruf mit dem OnClicked-Knoten, und fügen Sie die Übermittlung der von Benutzern eingegebenen Daten hinzu. Übermitteln Sie den Wert Twitter an den Parameter ProviderName.
    2. Fügen Sie folgende Rückruffunktionen hinzu:
      • OnUrlReceived — wird beim erfolgreichen Empfang einer Seiten-URL aufgerufen. Die empfangene URL wird im Parameter Url übermittelt.
      • OnError — wird bei einem Problem aufgerufen.
Hinweis
Im Beispiel der Ereignisbehandlung nutzt die Rückruffunktion OnError die Klasse PrintString. Ein Code und eine Fehlerbeschreibung werden in den Parametern Code und Description übermittelt. Sie können weitere Aktionen hinzufügen.
  1. Implementieren Sie die Benutzeranmeldung:
    1. Rufen Sie die mit dem XsollaLoginSubsystem-Objekt verbundene SDK-Methode LaunchSocialAuthentication auf.
    2. Übermitteln Sie die URL einer Anmeldeseite.
  1. Um einen Token abzurufen, tracken Sie die Änderung der Anmeldeseiten-URL:
    1. Implementieren Sie das Schließen eines Browsers nach der erfolgreichen Anmeldung.
    2. Rufen Sie die Methode OnSocialAuthCompleted auf, und abonnieren Sie ein BrowserClosed-Ereignis.
Hinweis
Der Abruf eines Tokens aus einer URL erfolgt durch den Blueprint eines integrierten Browsers. Der Autorisierungstoken wird an den Parameter LoginData übermittelt. Verwenden Sie ihn in Anfragen an Xsolla-Server.

Beispielhafte Implementierung einer Ereignisbehandlung:

War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Ausblenden
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Letztmalig aktualisiert: 10. Oktober 2023

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!