Kundenseitiger Speicher

Bei Verwendung des eigenen Speichers haben Sie Zugriff auf:

• Benutzerregistrierung
• Authentifizierung über Benutzername und Passwort
• Passwortlose Authentifizierung über eine Telefonnummer
• Authentifizierung über soziale Netzwerke
• Zurücksetzen von Benutzerpasswörtern

Interaktionsablauf

Sie können das Login-Widget oder Ihre Anwendung, die die Login API-Aufrufe nutzt, 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 und Password erläutert.
2. Der Xsolla Login-Server sendet Anfragen an Ihren Server. Befolgen Sie die Anleitung, um die Anfragen zu validieren.
3. Der Xsolla Login-Server verarbeitet eine Antwort von Ihrem Server und sendet das Ergebnis an den Client zurück.
4. Der Client verarbeitet die Antwort.

• Als JSON-Objekt.

• Als ein Array von Objekten mit Benutzerattributen. Die Objekte sollten die folgende Struktur aufweisen:

Benutzerregistrierung

1. Der Client sendet die Anfrage Register new user an den Xsolla-Login-Server.
2. Der Xsolla-Login-Server sendet eine Anfrage an die URL für neue Nutzer. Die Antwort muss dem in diesem Integrationsablauf angegebenen Format entsprechen. In der Antwort können Sie eine Liste von Benutzerattributen oder ein erforderliches JSON-Objekt angeben. Das von Ihnen in der Antwort angegebene JSON-Objekt wird im Feld partner_data des Benutzer-JWT aufgezeichnet.

POST https://your.hostname/your_registration_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "email":"j.smith@email.com",
  "password":"123456",
  "username":"j.smith@email.com"
}

curl --request POST \
  --url 'https://your.hostname/your_registration_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

Antwort mit Benutzerattributen (Beispiele):

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Antwort mit einem JSON-Objekt (Beispiel):

{ "region": "Asia",
  "type": "new"
}

3. Nutzerdaten werden in die Xsolla-Datenbank geschrieben, während der Parameter email als "unbestätigt" gekennzeichnet wird. Der Benutzer erhält eine E-Mail zur Kontobestätigung.
4. Wenn Sie das Login-Widget integriert haben, wird der Benutzer zur Seite weitergeleitet. Dabei wird ihm folgende Meldung angezeigt: Bitte bestätigen Sie Ihr Konto gemäß den Anweisungen, die wir Ihnen per E-Mail an {email} gesendet haben.
5. Auch bei einer fehlgeschlagenen Benutzerregistrierung können Sie eine Fehlermeldung im Authentifizierungs-Widget anzeigen. Übermitteln Sie dazu in der Antwort auf die Anfrage zur Benutzererstellung das Objekt error mit den folgenden Details:
   • Geben Sie im Parameter code den Wert 011-002 an.
   • Geben Sie im Parameter description den Fehlermeldungstext an.

{
  "error": {
    "code": "011-002",
    "description": "<string>"
  }
}

Authentifizierung über Benutzername und Passwort

1. Der Client sendet die Anfrage Auth by username and password an den Xsolla-Login-Server.
2. Der Xsolla-Login-Server sendet eine Anfrage an die URL für die Benutzerverifizierung. Die Antwort muss dem in diesem Interaktionsablauf angegebenen Format entsprechen. In der Antwort können Sie eine Liste von Benutzerattributen oder ein erforderliches JSON-Objekt angeben. Das von Ihnen in der Antwort angegebene JSON-Objekt wird im Feld partner_data des Benutzer-JWT aufgezeichnet.

POST https://your.hostname/your_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "email":"j.smith@email.com",
  "password":"123456",
  "username":"j.smith@email.com"
}

curl --request POST \
  --url 'https://your.hostname/your_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"j.smith@email.com","password":"123456","username":"j.smith@email.com"}'

Antwort mit Benutzerattributen (Beispiele):

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Antwort mit einem JSON-Objekt (Beispiel):

{ "region": "Asia",
  "type": "new"
}

3. Der Xsolla Login-Server generiert einen Benutzer-JWT.
4. Der Benutzer wird mittels token-Abfrageparameter zur login_url weitergeleitet. Der Benutzer-JWT ist im token-Parameter enthalten.

Passwortlose Authentifizierung über eine Telefonnummer

1. Der Client öffnet ein Authentifizierungsformular, damit der Nutzer seine Telefonnummer eingeben kann.
2. Der Nutzer gibt seine Telefonnummer ein.
3. Der Client sendet die Anfrage Start auth by phone number an den Xsolla-Login-Server.
4. Im Client wird ein Feld angezeigt, in dem der Nutzer den Verifizierungscode eingeben kann.
5. Der Nutzer gibt den erhaltenen Verifizierungscode ein.
6. Der Client sendet die Anfrage Complete auth by phone number an den Xsolla-Login-Server.
7. Wenn sich der Nutzer erstmalig autorisiert, sendet der Xsolla-Login-Server eine Anfrage an die URL für das passwortlose Anmelden über Mobiltelefon. Die Antwort muss dem in diesem Integrationsablauf beschriebenen Format entsprechen. In der Antwort können Sie eine Liste von Benutzerattributen oder ein erforderliches JSON-Objekt angeben. Das von Ihnen in der Antwort angegebene JSON-Objekt wird im Feld partner_data des Benutzer-JWT aufgezeichnet.

POST https://your.hostname/your_phone_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "login": "+12025550140",
  "type": "phone"
}

curl --request POST \
  --url 'https://your.hostname/your_phone_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"login":"+12025550140","type":"phone"}'

Antwort mit Benutzerattributen (Beispiele):

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Antwort mit einem JSON-Objekt (Beispiel):

{ "region": "Asia",
  "type": "new"
}

Passwortlose Authentifizierung über E-Mail

1. Der Client öffnet ein Authentifizierungsformular, damit der Nutzer seine E-Mail-Adresse eingeben kann.
2. Der Nutzer gibt seine E-Mail-Adresse ein.
3. Der Client sendet die Anfrage Start auth by email an den Xsolla-Login-Server.
4. Im Client wird ein Feld angezeigt, in dem der Nutzer den Verifizierungscode eingeben kann.
5. Der Nutzer gibt den erhaltenen Verifizierungscode ein.
6. Der Client sendet die Anfrage Complete auth by email an den Xsolla-Login-Server.
7. Wenn sich der Nutzer erstmalig autorisiert, sendet der Xsolla-Login-Server eine Anfrage an die URL für das passwortlose Anmelden über E-Mail. Die Antwort muss dem in diesem Integrationsablauf beschriebenen Format entsprechen. In der Antwort können Sie eine Liste von Benutzerattributen oder ein erforderliches JSON-Objekt angeben. Das von Ihnen in der Antwort angegebene JSON-Objekt wird im Feld partner_data des Benutzer-JWT aufgezeichnet.

POST https://your.hostname/your_email_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "email": "user@mail.com",
  "type": "email"
}

curl --request POST \
  --url 'https://your.hostname/your_email_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email": "user@mail.com","type": "email"}'

Antwort mit Benutzerattributen (Beispiele):

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Antwort mit einem JSON-Objekt (Beispiel):

{ "region": "Asia",
  "type": "new"
}

Authentifizierung über soziale Netzwerke

Geben Sie die URL für die Anmeldung über soziales Netzwerk in den Einstellungen Ihres Login-Projekts im Kundenportal (unter Nutzerdatenbank > Speicher > Eigener Speicher) an, um Nutzerdaten bei der Authentifizierung über soziale Netzwerke abzurufen. An diese URL wird eine Anfrage mit den vom sozialen Netzwerk empfangenen Daten gesendet.

Authentifizierungsablauf:

1. Der Client sendet die Anfrage Auth via social network an den Xsolla-Login-Server.
2. Der Nutzer meldet sich bei einem sozialen Netzwerk an.
3. Der Xsolla-Login-Server verarbeitet die vom dem sozialen Netzwerk empfangenen Nutzerdaten und sendet eine Anfrage an die URL für die Anmeldung über soziale Netzwerke. Die Antwort muss dem in diesem Szenario beschriebenen Format entsprechen. In der Antwort können Sie eine Liste von Benutzerattributen oder ein erforderliches JSON-Objekt angeben. Das von Ihnen in der Antwort angegebene JSON-Objekt wird im Feld partner_data des Benutzer-JWT aufgezeichnet.

{
  "exp": 1573635020,
  "iat": 1573634600,
  "iss": "https://login.xsolla.com",
  "request_type": "gateway_request",
  "xsolla_login_project_id": "00000000-0000-0000-0000-000000000000",
  "sub": "00000000-0000-0000-0000-000000000000",
  "email": "example@test.com",
  "username": "Smith707",
  "provider": "google",
  "id": "123",
}

URL für neue Nutzer Antwortbeispiel:

POST https://your.hostname/your_social_authentication_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{}

curl --request POST \
  --url 'https://your.hostname/your_social_authentication_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json'

Antwort mit Benutzerattributen (Beispiele):

{
    "attributes": [
      {
        "attr_type": "server",
        "key": "company",
        "permission": "private",
        "value": "facebook-promo"
      },
      {
        "attr_type": "server",
        "key": "custom-id",
        "permission": "private",
        "value": 48582
      }
    ]
}

Antwort mit einem JSON-Objekt (Beispiel):

{ "region": "Asia",
  "type": "new"
}

Benutzerpasswörter zurücksetzen

1. Der Client sendet die Anfrage Reset password an den Xsolla-Login-Server.
2. Der Xsolla-Login-Server sendet dem Nutzer eine Bestätigung über die Zurücksetzung des Passworts per E-Mail.
3. Nachdem der Nutzer das Zurücksetzen des Passworts in der E-Mail bestätigt hat, wird er auf die entsprechende Seite weitergeleitet.
4. Der Nutzer gibt ein neues Passwort ein.
5. Der Xsolla-Login-Server sendet eine Anfrage an die URL zum Zurücksetzen des Passworts.

URL für neue Nutzer Antwortbeispiel:

POST https://your.hostname/your_reset_uri HTTP/1.1
Authorization: Bearer {JWT}
Content-Type: application/json

{
  "username": "john@gmail.com",
  "fields": {
    "password": "NewPa$$word1"
  }
}

curl --request POST \
  --url 'https://your.hostname/your_reset_uri' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","fields":{"password":"NewPa$$word1"}}'

Weitere Informationen