Over a million developers have joined DZone.

SMS Passwordless Authentication

DZone 's Guide to

SMS Passwordless Authentication

Going passwordless isn't new in the world of authentication, with Slack and Whatsapp on board. Learn how to build a secure app with SMS passwordless authentication.

· Mobile Zone ·
Free Resource

Check out the repo to get the code for this tutorial.

What Is SMS Passwordless Authentication?

SMS Passwordless authentication is a type of authentication where users do not need to log in with passwords. This form of authentication totally makes passwords obsolete. With this form of authentication, users are presented with the option of logging in simply via a one-time unique code that is delivered via text message.

Benefits of Passwordless Authentication

Without much ado, passwordless authentication helps:

  • Improve user experience: The faster users can sign up and use your service, the more users your app tends to attract. Users dread having to fill out forms and go through a rigorous registration process. Imagine eliminating that extra five minutes of asking users to remember their grandmother's maiden name as a security question. Passwordless authentication helps improve user experience in this regard!
  • Increase security: 59% of internet users admit to using the same password for multiple accounts. Once an attacker gets hold of one account's password, he or she can compromise other accounts that use the same password. However, once you go passwordless, there are no passwords to be hacked.

How Does SMS Passwordless Authentication Work?

Let's take a look at how SMS passwordless authentication actually works. Check out the process below:

  • The user is asked to enter a valid phone number.                                                      The user enters a valid phone number.
  • A unique one-time code is then sent to the phone number. Onetime code is received                                                            The one-time code is received.
  • Once the user enters this code into your application, your app validates that the code is correct and that the phone number exists and belongs to a user, a session is initiated, and the user is logged in. SMS Confirmation   In Auth0's case, the user has five minutes to input the code into the app and get logged in.

Take a look at Auth0's one-time code via SMS implementation below:

Authentication with a onetime code via SMS

If the phone number matches an existing user, Auth0 just authenticates the user like so:

Authenticates user

Other forms of passwordless authentication are:

  • Authentication with a magic link via email.
  • Authentication with a one-time code via e-mail.
  • Authentication with a fingerprint. Auth0 supports TouchID.

Check out this excellent article to have an in-depth understanding of how these other forms of passwordless authentication work!

Phone Number/SMS Passwordless Authentication With Auth0

With Auth0, SMS passwordless authentication otherwise known as phone number authentication is dead simple to implement. There are diagrams earlier in this post that already show the SMS passwordless authentication flow using Auth0. The Passwordless API is an efficient API implementation of passwordless authentication.

We'll build an application that allows you log in via your mobile phone number. Let's get started.

Create an index.html file in your directory and add this piece of code to it:

<!doctype html>
    <meta charset="utf-8">
    <script src="//use.typekit.net/iws6ohy.js"></script>

    <meta name="viewport" content="width=device-width, initial-scale=1">

    <!-- font awesome from BootstrapCDN -->
    <link href="//maxcdn.bootstrapcdn.com/bootstrap/3.2.0/css/bootstrap.min.css" rel="stylesheet">
    <link href="//maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css" rel="stylesheet">
    <link href="app.css" rel="stylesheet">

    <script src="auth0-variables.js"> </script>
  <body class="home">
    <div class="container">
      <div class="login-page clearfix">
        <div class="login-box auth0-box before">
          <img class="logo" src="https://i.cloudup.com/StzWWrY34s.png" />
          <h3>Auth0 Passwordless Example</h3>
          <p>Login with SMS</p>
          <div class="alert alert-warning">Don't forget to add your page's origin <strong><script type="text/javascript">document.write(location.origin)</script></strong> to your App's <strong>Allowed Origins (CORS)</strong> in the <a target="_blank" href="https://manage.auth0.com">Auth0 dashboard</a>, unless it is already in the list of <strong>Allowed Callback URLs.</strong></div>
          <a ng-click="login()" class="btn btn-primary btn-lg btn-login btn-block">SignIn</a>
        <div class="logged-in-box auth0-box logged-in" style="display: none;">
          <h1 id="logo"><img src="auth0_logo_final_blue_RGB.png" /></h1>
          <img class="avatar"/>
          <h2>Welcome <span class="nickname"></span></h2>
    <script src="http://code.jquery.com/jquery-2.1.1.min.js"></script>
    <script src="https://cdn.auth0.com/js/lock-passwordless-1.0.min.js"></script>
    <script type="text/javascript">
      $(document).ready(function() {
        $('.btn-login').click(function(e) {

          // Initialize Passwordless Lock instance
          var lock = new Auth0LockPasswordless(
            // All these properties are set in auth0-variables.js

          var appearanceOpts = {
            autoclose: true

          // Open the lock in SMS mode with the ability to handle the authentication in page
          lock.sms(appearanceOpts,function (err, profile, id_token, access_token, state, refresh_token) {
            if (!err){
              // Save the JWT token.
              localStorage.setItem('userToken', id_token);
              $('.avatar').attr('src', profile.picture);

Now, create a JavaScript file, auth0-variables.js. We'll add Auth0 variables to this file.


Create an app.css file and add the code here to it.

Run your app. The landing page should look like this:

Landing Page

When you click on Sign In, you should see this:


  • On the Auth0 dashboard, click on the red Create Client button to create a new app, like so: Create client
  • Head over to the Passwordless Connections side of the dashboard and enable SMS option. It should show something similar to the image below:Enable Swapart App
  • The next page will show you a page to fill in your Twilio SID and Twilio Auth Token and the From number.
  • Head over to Twilio, sign up and get the SID and Auth Token values, then add them to the Auth0 page and save.
  • Head over to your settings tab for the Swapart app and copy your client_id and domain
  • Open up auth0-variables.js in your code and replace the AUTH0_CLIENT_ID and AUTH0_DOMAIN values with your real Auth0 keys.
  • Make sure you add your app URL to the Allowed Origins(CORS) in the Auth0 dashboard. Your app has to run on a server. http-server and nginxare good options.

Let's try our app. Click the Login button and put in your phone number.

Login with Phone Number

                                              The code from Auth0 is delivered to your phone.

Enter the code                                                  Enter the code from your phone number.

Logged In                                                                  Submit and be logged in.

Under the hood                                             Check out the token saved in the localStorage.

You can go further and use the token to determine the logged-in and logged-out auth status of a user.

There is no doubt that passwords have become more susceptible to being compromised in recent years. Passwordless authentication aims to eliminate authentication vulnerabilities. This recent analysis of passwordless connections shows that passwordless adoption is increasing. Passwordless authentication is also very useful and gaining ground in the IoT world. It's easier, friendlier, and faster to be authenticated into an IoT device via Touch ID, push notification, or even a one-time passcode than with traditional means. If you really care about security, you should look into passwordless authentication!

mobile ,tutorial ,mobile security ,authentication ,mobile ux

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}