One-Tap Sign-In

Returning users can be automatically prompted for a single tap to log back in, no matter where they are on the site.

​

Prerequisites

To get the most out of this guide, make sure to do the following tasks first:

1. Complete the backend integrations (see Build Server-Side Endpoints).
2. Complete the Login integration (see Login).

​

Integrating One-tap Sign-in

Implement a one-tap sign in on the desired pages.

​

Add the Pop-Up Prompt to your Page

The SDK activateReturningUsersPrompt method is used to integrate with the one-tap sign-in journey. It starts by offering users on the site a pop-up to login by clicking the Continue button shown in Figure 1, if they’re not already logged in.

​

Implement the activateReturningUsersPrompt Method

In the ownid method:

1. Enter activateReturningUsersPrompt for the method name.

2. Check to make sure the user isn’t already logged in using the checkSession async function. Only if false the prompt will be shown.

3. Configure the onLogin event to copy the data.token object locally. The data.token is the value generated by the getSessionByLoginId endpoint and you should use it to set a user session or exchange it for a session token.

4. Assign an error function as desired in the onError parameter.

Use the code snippets below, and check the embedded comments, to model your implementation of the submit handler and the SDK activateReturningUsersPrompt method.

  ownid('activateReturningUsersPrompt', {
    onLogin: (data) => { 
      // use your own method to set a user session
      this.authService.setSession(data.token);
    },
    checkSession: async () => {
      // only if `false` then the prompt will be shown
      // use your own method to check for if the user is logged in
      return this.authService.isLoggedIn(); 
    },
    onError: (errorMessage) => { 
      // handle errorMessage 
    }
  });

​

Next Steps

​

Ready to deploy?