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

​

Integrating One-tap Sign-in

Implement the event handlers, and OwnID integration on the desired page.

​

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.

// only if `false` then the prompt will be shown 
checkSession: async () => { 
    // use your own method to check for if the user is logged in
    return this.authService.isLoggedIn(); 
}

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. Redirect the user to the appropriate landing page at your discretion.

5. 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.

​

Next Steps

​

Ready to deploy?