So richten Sie ein Schatten-Login-Projekt ein

1. Erstellen Sie ein Schatten-Login-Projekt, sofern noch nicht geschehen (siehe Integrationsleitfaden, Schritte 1 bis 5).
2. Richten Sie Ihr Schatten-Login-Projekt im Kundenportal ein.
3. Integrieren Sie die Lösung aufseiten Ihrer Anwendung.

Im Kundenportal einrichten

1. Öffnen Sie Ihr Projekt im Kundenportal, und wechseln Sie zum Abschnitt Login.
2. Klicken Sie beim gewünschten Schatten-Login-Projekt 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. Wechseln Sie zur Registerkarte Rückruf-URLs, und legen Sie die folgenden Parameter fest:
   • Rückruf-URL – URL oder Pfad in der Anwendung, an die bzw. den die Benutzer nach erfolgreicher Authentifizierung, Bestätigung ihrer E-Mail-Adresse oder Zurücksetzen ihres Passworts weitergeleitet werden. Sie können mehrere gültige URLs angeben.
   • Fehler-Rückruf-URL – URL oder Pfad in der Anwendung, an die bzw. den die Benutzer im Falle eines Authentifizierungsfehlers weitergeleitet werden. Ist kein Wert angegeben, wir der Wert aus dem Feld Rückruf-URL genutzt.

8. Klicken Sie auf Speichern.

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)