Authentication

To fully interact with Xsolla Backend services, a local user must be logged in. There are several types of login methodologies utilized by Xsolla Backend.

Chess showcases two types of login:

• Device

• Email/Password

Device Login

To perform device login, there is a single line call:

await _sdk.Instance.LoginDevice();

This in turn will use a generated device id to log the local user without friction.

It is recommended to store off a login token locally, for subsequent logins. In Unity, a good place to store off the login token is in PlayerPrefs:

// Grab a stored token from the previous login
string token = PlayerPrefs.GetString("logToken", null);

// If token doesnt exist use device login
if (string.IsNullOrEmpty(token))
    await _sdk.Instance.LoginDevice();
else
    await _sdk.Instance.LoginToken(token);

_user = _sdk.Instance.LoggedInUser;

Email/Password Login

Performing an email/password login is similar to Device Login in that it is a single-line call.

In Chess we perform a two-part login. First we register the local user.

To register a local user, a User object must be created and populated with:

• Name

• FirstName

• LastName

• Email

• Roles

Once the User object has been created, the user can be registered with a single-line call:

_user = await _sdk.Instance.RegisterUserAndPassword(user, pass);

This will return a new user object for the newly created local user:

public async Task AXRRegisterEmail(string email, string pass)
{
    try
    {
        // Create a new user
        User user = new User()
        {
            Name = email,
            FirstName = "chess",
            LastName = "player",
            Email = email,
            Roles = new List<string>(),
        };

        // Register user with supplied password
        _user = await _sdk.Instance.RegisterUserAndPassword(user, pass);

        // Define email variable in PlayerPrefs
        if (_user != null)
            PlayerPrefs.SetString(EMAIL_ID, _user.Email);
    }
    catch (Exception e)
    {
        throw e;
    }
}

Next we login the local user. This can be done with this single line call:

await _sdk.Instance.LoginPassword(email, pass);

Once the LoginPassword method is called the user can be pulled from the CoreSdk instance’s LoggedInUser property.

_user = _sdk.Instance.LoggedInUser;