This tutorial shows how to use SDK methods to implement:

• user sign-up
• resend request for a sign-up confirmation email
• user login
• user password reset

Source code

See the source code for these examples on GitHub.

You can authenticate users with their username or email address. In the following examples we authenticate users with their username, whereas the email address is used to confirm sign-up and to reset the password.

The logics and interface in the examples are less complicated than they will be in your application. A possible authentication system implementation option is described in the demo project.

Implement user sign-up

Create widget

1. Go to Content Browser and create a UI directory. In the contextual menu, go to User Interface > Widget Blueprint.
2. In the widget blueprint, add the following interface elements:
   • username field
   • user email address field
   • user password field
   • sign-up button

The following picture shows an example of the page structure.

3. Open a level blueprint:
   1. Choose a level in Content Browser.
   2. In the main menu, go to Blueprints > Open Level Blueprint.
4. Implement widget display when the level is started. To do this, add nodes as shown below. In the CreateWidget node, specify the created widget.

Add event handling

1. In the Hierarchy panel, select a sign-up button.
2. In the Details panel, click the + icon near the On Clicked event.

3. Open a Graph view.
4. Link a RegisterUser method call on the XsollaLoginSubsystem object to the OnClicked node and add passing of data entered by users.
5. Add callback functions:
   • OnRegistered — called if sign-up is successful
   • OnError — called if an error occurs

6. To start widget debugging, start a level.

Example of event handling implementation:

Set up sign-up confirmation email

After successful sign-up, a user receives a sign-up confirmation email to a specified address. You can customize emails sent to users in Publisher Account.

If you are developing an Android application, set up deep links to return a user to an application after they confirm sign-up.

Implement sign-up confirmation email resend request

Create widget

1. Go to Content Browser and open a UI directory. In the contextual menu, go to User Interface > Widget Blueprint.
2. In the widget blueprint, add the following interface elements:
   • username/email field
   • resend email button

The following picture shows an example of the page structure.

3. Open a level blueprint:
   1. Choose a level in Content Browser.
   2. In the main menu, go to Blueprints > Open Level Blueprint.
4. In the CreateWidget node, specify the created widget.

Add event handling

1. In the Hierarchy panel, select a resend email button.
2. In the Details panel, click the + icon near the On Clicked event.

3. Open a Graph view.
4. Link a ResendAccountConfirmationEmail method call on the XsollaLoginSubsystem object to the OnClicked node and add passing of data entered by users.
5. Add the OnEmailResent and OnError callback functions.
6. To start widget debugging, start a level.

If the request is successful, the user receives a sign-up confirmation email to the email address specified during sign-up.

Example of event handling implementation:

Implement user login

Create widget

1. Go to Content Browser and open a UI directory. In the contextual menu, go to User Interface > Widget Blueprint.
2. In the widget blueprint, add the following interface elements:
   • username field
   • password field
   • remember me checkbox
   • login button

The following picture shows an example of the page structure.

3. Open a level blueprint:
   1. Choose a level in Content Browser.
   2. In the main menu, go to Blueprints > Open Level Blueprint.
4. In the CreateWidget node, specify the created widget.

Add event handling

1. In the Hierarchy panel, select a login button.
2. In the Details panel, click the + icon near the On Clicked event.

3. Open a Graph view.
4. Link an AuthenticateUser method call on the XsollaLoginSubsystem object to the OnClicked node and add passing of data entered by users.
5. Add the OnAuthenticated and OnError callback functions.

6. To start widget debugging, start a level.

Example of event handling implementation:

Implement password reset

Create widget

1. Go to Content Browser and open a UI directory. In the contextual menu, go to User Interface > Widget Blueprint.
2. In the widget blueprint, add the following interface elements:
   • username/user email address field
   • password reset button

The following picture shows an example of the page structure.

3. Open a level blueprint:
   1. Choose a level in Content Browser.
   2. In the main menu, go to Blueprints > Open Level Blueprint.
4. In the CreateWidget node, specify the created widget.

Add event handling

1. In the Hierarchy panel, select a password reset button.
2. In the Details panel, click the + icon near the On Clicked event.

3. Open a Graph view.
4. Link a ResetUserPassword method call on the XsollaLoginSubsystem object to the OnClicked node and add passing of data entered by users.
5. Add the OnEmailSent and OnError callback functions.
6. To start widget debugging, start a level.

Example of event handling implementation:

After successful password reset request, the user receives an email with a password reset link. In Publisher Account > your Login project > General settings > URL > Callback URL, you can configure a URL address or a path a user is redirected to after successful authentication, email confirmation, or password reset.

This guide shows how you can use SDK methods to implement user sign-up and login via their social network account.

Unlike for user authentication via username/user email address and password, you don’t have to implement separate logics for user sign-up. If the user’s first login is via a social network, a new account is created automatically.

If you have implemented social login in your application as an alternative authentication method, the social network account automatically links to an existing user account if the following conditions are met:

• A user who signed up with username/email address and password logged into your application via a social network account.
• A social network returns an email address.
• User email address in a social network is the same as the email address used for sign-up in your application.

Source code

See the source code for these examples on GitHub.

The examples show how to set up user login via a Twitter account. You can set up all social networks in the same way.

The logics and interface in the examples are less complicated than they will be in your application. A possible authentication system implementation option is described in the demo project.

Create widget

1. Go to Content Browser and create a UI directory.
2. In the contextual menu, go to User Interface > Widget Blueprint.
3. In the widget blueprint, add the social login button.

The following picture shows an example of the page structure.

4. Open a level blueprint:
   1. Choose a level in Content Browser.
   2. In the main menu, go to Blueprints > Open Level Blueprint.
5. Implement widget display when the level is started. To do this, add nodes as shown below. In the CreateWidget node, specify the created widget.

Add event handling

1. In the Hierarchy panel, select a login button.
2. In the Details panel, click the + icon near the On Clicked event.

3. Open a Graph view.
4. Implement a login page opening in a built-in browser:

1. 1. Link a GetSocialAuthenticationUrl method call connected with the XsollaLoginSubsystem object to the OnClicked node and add passing of data entered by users. Pass the Twitter value to the ProviderName parameter.
   2. Add the callback functions:
      • OnUrlReceived — called if you successfully receive a page URL. Received URL is passed in the Url parameter.
      • OnError — called if an error occurs.

5. Implement user login:
   1. Call the LaunchSocialAuthentication SDK methods linked to the XsollaLoginSubsystem object.
   2. Pass a login page URL.

6. To get a token, track a login page URL change after successful user login:
   1. Implement closing of a browser after successful login.
   2. Call the OnSocialAuthCompleted method and subscribe to a BrowserClosed event.

Example of event handling implementation: