Stille Authentifizierung

So funktioniert's

Die stille Authentifizierung ermöglicht es Ihnen, Benutzer in Ihrem Spiel automatisch über eine Publishing-Plattform zu authentifizieren. Steam, Xbox Live und Epic Games werden derzeit unterstützt. Wenn Sie Unterstützung für die Plattformen Stone oder Mail.ru benötigen, wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com.

Interaktionsablauf:

1. Benutzer startet Ihr Spiel.
2. Das Spiel erhält Plattform-Autorisierungsdaten über das Plattform-SDK.
3. Ihr Spiel generiert eine Anfrage und sendet diese an den Xsolla Login-Server, um ein JWT abzurufen.
4. Der Xsolla Login-Server authentifiziert den Benutzer und sendet das JWT.

Für wen ist es

Partner, die Login bereits integriert haben und ein Konto bei einer Publishing-Plattform besitzen.

Wie komme ich dazu

1. Richten Sie die stille Authentifizierung im Kundenportal ein.
2. Schließen Sie die Integrationsschritte aufseiten Ihrer Anwendung ab.

Stille Authentifizierung einrichten

Im Login-Produkt gibt es zwei Ansätze, die stille Authentifizierung zu aktivieren:

• durch Konfiguration der klassischen Anmeldung (siehe folgende Anleitung);
• durch Erstellen eines Schatten-Login-Projekts (siehe So richten Sie ein Schatten-Login-Projekt ein).

1. Öffnen Sie Ihr Projekt im Kundenportal, und wechseln Sie zum Abschnitt Login.
2. Klicken Sie beim gewünschten Projekt mit klassischer Anmeldung auf Konfigurieren.
3. Scrollen Sie zum Block Authentifizierung, und klicken Sie auf Publishing-Plattformen.

4. Klicken Sie auf das ⚙-Symbol neben dem Namen der gewünschten Publishing-Plattform und dann auf Einstellungen, um die Publishing-Plattform zu verknüpfen.

5. Geben Sie in dem Modalfenster die Parameter für die ausgewählte Plattform an:
   • Steam:
     • Anwendungs-ID – AppID Ihres Kontos auf der Plattform;
     • Geheimer Schlüssel der Anwendung – Web-API-Schlüssel.
   • Epic Games:
     • Anwendungs-ID – Client-ID des Clients Ihres Spiels auf der Plattform;
     • Geheimer Schlüssel der Anwendung – Geheimer Schlüssel des Clients Ihres Spiels auf der Plattform.
   • Xbox Live:
     • Anwendungs-ID – Anwendungs-/Client-ID Ihres Spiels auf der Plattform;
     • Geheimer Schlüssel der Anwendung – dieser wurde bei der Registrierung Ihres Spiels auf der Plattform generiert.

6. Klicken Sie auf Verknüpfen.
7. Wiederholen Sie die Schritte 4 bis 6 bei Bedarf für weitere Publishing-Plattformen.

Anwendungsseitige Integration

Verwenden Sie die jeweilige Anleitung für die Publishing-Plattform, auf der Ihre Anwendung gehostet ist:

• Steam
• Xbox Live
• Epic Games

Steam

1. Rufen Sie das Session-Ticket ab.
2. Übermitteln Sie es an die Anfrage für die stille Authentifizierung (JWT or OAuth 2.0) als session_ticket-Parameter.

Xbox Live

1. Erstellen Sie ein Session-Ticket (Parameter session_ticket) basierend auf den nach der Benutzerauthentifizierung erhaltenen Plattformdaten. Der Parameter wird auf Grundlage der <xid>-<uhs>;<XSTSToken>-Vorlage erstellt, wobei:
   • <xid> — Xbox User ID;
   • <uhs> — user hash;
   • <XSTSToken> — Xbox Secure Token Service.
2. Übermitteln Sie den Parameter session_ticket an die Anfrage für die stille Authentifizierung (JWT oder OAuth 2.0).

Epic Games

1. Rufen Sie den exchangecode-Autorisierungscode von der Plattform ab, der nach der Benutzerauthentifizierung generiert wird.
2. Übermitteln Sie den empfangenen exchangecode als session_ticket-Parameter an die Stille-Authentifizierung-Anfrage (JWT oder OAuth 2.0)