Authentication via application launcher
If you use Xsolla Launcher or Steam to deliver your application to users, you can automatically authenticate the user using the launcher’s credentials.
How-tos
You can use Xsolla Launcher to deliver your application to users and update it. The Launcher contains a built-in authorization tool. To avoid the need to re-enter username and password, set up authorization in your application via the Launcher.
Set up SDK and Launcher to work together
- Set up Launcher in your Publisher Account.
config.json
file, it is enough to change the values for the following objects:launcher_project_id
— specify Launcher ID found in Publisher Account > Launcher > General settings > General infologin_project_id
— specify Login ID found in Publisher Account > Launcher > General settings > Authentication
- Implement the Launcher authorization logic in your application.
- Generate a launcher installation file and a build archive.
- Create an application build.
- Upload the application build to the Xsolla update server.
Implement logic for authentication via Launcher
The flow for authorization in the application via Launcher is as follows:
- The user is authorized in Launcher.
- The user installs and runs the application.
- Launcher runs the application and passes user parameters via the command line. The authorization token is passed in the
xsolla-login-token
parameter. - The application processes command line parameters and obtains a token. An example of a token processing script can be viewed in the demo project.
- The application validates the received token. An example of a token validation script can be viewed in the demo project.
- The application automatically authorizes the user without displaying an authorization page. An example of a user authorization script can be viewed in the demo project.
Token.Instance
property.Create an application build
- Go to your Unity project.
- Click
Window > Xsolla > Edit Settings in the main menu. In theInspector panel:- In the
Project ID field, specify the Project ID found in Publisher Account > Project settings > Project ID. - In the
Login ID field, specify the Login ID found in Publisher Account > Launcher > General settings > Authentication.
- In the
- Run the user authorization scene, where the token is processed.
- Click
File > Build settings in the main menu and then clickAdd Open Scenes . Make sure the authorization scene is added first in the list. - Click
Build . - In the pop-up window, specify the path to the directory where the finished build will be placed.
Native authentication allows players to enter your application via the installed Steam application.
To set up native authentication:
- Set up silent authentication via Steam in Publisher Account.
- Configure your Unity project.
- Configure processing of events.
- Ensure authentication via Steam.
Configure your Unity project
- Create a
steam_appid.txt
file and enter your application ID in Steam there. Then, place this file in theAssets/Plugins/Steamworks.NET/redist/
catalog of your project.
steam_appid.txt
file in the Assets/Plugins/Steamworks.NET/redist/
catalog. This file includes the application ID in Steam for a demo project.- Open your Unity project.
- In the main menu, go to
Window > Xsolla > Demo Settings . - In the
Inspector panel:- Check the
Use Steam authorization box. - In the
Steam App ID field, specify your application ID in Steam. The value should be the same as the value in thesteam_appid.txt
file.
- Check the
Configure processing of events
To authenticate users via Steam, you should pass a session ticket
to the SilentAuth
method. For an example, see the SteamAuth.cs
class of the demo project.
Ensure authentication via Steam
- Create the build of your Unity project for a stand-alone platform or start a scene.
- Launch Steam and log in.
- Launch your application. If everything is correct, you will be logged into the applictaion automatically.
Found a typo or other text error? Select the text and press Ctrl+Enter.