How to set up a shadow Login project
- Create a shadow Login project if it has not already been created (see Integration Guide, steps 1–5).
- Set up your shadow Login project in Publisher Account.
- Integrate the solution on the side of your application.
Setting up in Publisher Account
- Open your project in Publisher Account and go to the Login section.
- Click Configure in the panel of a shadow Login project.
- Go to the Authentication block and select the Publishing platforms section.
- To connect a publishing platform, click the ⚙ icon next to its name and select Settings.
Note
Currently, integration with the Steam, Xbox Live and Epic Games platforms is supported. If you need support for the Stone or Mail.ru platforms, contact your Customer Success Manager or email to csm@xsolla.com.
- In the modal window, specify the parameters for the selected platform:
- Steam:
- Application ID — AppID of your account on the platform;
- Application secret key — Web API Key.
- Epic Games:
- Application ID — Client ID of the client of your game on the platform;
- Application secret key — Secret key of the client of your game on the platform.
- Xbox Live:
- Application ID — Application ID/Client ID of your game on the platform;
- Application secret key — Application Secret generated when your game was registered on the platform.
- Steam:
Note
For the Xbox Live platform, it is not necessary to provide setting values. You can connect Xbox Live with access keys owned by Xsolla. To do this, click the ⚙ icon to the right of the platform name and select Connect.
- Click Connect.
- Go to the Callback URLs tab and specify the following parameters:
- Callback URL — the URL or path in the application to which users are redirected after they have successfully authenticated, confirmed their email, or reset their password. You can specify multiple valid URLs.
- Error callback URL — the URL or path in the application to which users are redirected in case of an authentication error. If no value is specified, the Callback URL value will be used.
- Click Save changes.
Note
In addition to the basic settings, you can also configure additional parameters for your shadow Login project. This can be done at the same time as the basic setup or later. You can find additional settings on the Login project page in the Security, Communication providers, Customization, and Legal settings blocks.
Application side integration
Use the instruction for the publishing platform that hosts your application:
Steam
Form a session ticket (session_ticket
parameter) based on the platform data after user authentication:- Get the session ticket.
- Pass it to the silent authentication request (JWT or OAuth 2.0) as a
session_ticket
parameter.
Xbox Live
- Form a session ticket (
session_ticket
parameter) based on the platform data after user authentication. The parameter is formed based on the<xid>-<uhs>;<XSTSToken>
template where: ;<xid>
— Xbox User ID ;<uhs>
— user hash .<XSTSToken>
— Xbox Secure Token Service
- Pass the
session_ticket
parameter to the silent authentication request (JWT or OAuth 2.0).
Epic Games
- Get the
exchangecode
authorization code from the platform, which is generated after user authentication. - Pass the received
exchangecode
to the silent authentication request (JWT or OAuth 2.0) as thesession_ticket
parameter.
Was this article helpful?
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.Found a typo or other text error? Select the text and press Ctrl+Enter.