Two-Factor Authentication

Two-factor authentication (2FA) can play a key role in securing your applications against password data breaches. Authentication with a one-time password (OTP) delivered to your users over SMS is an effective approach to implementing two-factor authentication. Plivo’s premium direct routes guarantee the highest possible delivery rates and the shortest possible delivery times for your 2FA SMS messages. This guide shows how to set up SMS-based two-factor authentication using either or traditional API development. PHLO lets you create and deploy workflows from an intuitive graphical canvas in few clicks.

Using API

Here’s how to implement 2FA using Plivo APIs.

Prerequisites

To get started, you need a Plivo account — sign up with your work email address if you don’t have one already. If this is your first time using Plivo APIs, follow our instructions to set up a .NET development environment.

Set up the demo application locally

Clone the 2FA demo repository from GitHub.

$ git clone https://github.com/plivo/2fa-dotnet-demo.git

Change your working directory to 2fa-dotnet-demo.

$ cd 2fa-dotnet-demo

Open the 2fa folder in Visual Studio.
Edit appsettings.json. Replace the auth placeholders with your authentication credentials from the Plivo console. Replace the phone number placeholder with an actual phone number in E.164 format (for example, +12025551234). Replace the PHLO ID with null.

A review of the code

Let‘s walk through what the code does.

Step 1: Generate the OTP

Use the Time-Based OTP algorithm to generate a random six-digit one-time password (OTP).

Random r = new Random();
var code = r.Next(999999);

Step 2: Send an SMS message with the OTP

Send an SMS message with the OTP to the user’s registered mobile number using Plivo’s Send Message API.

public int SendVerificationCodeSms(String DstNumber, String Message)
		{
			Random r = new Random();
			var code = r.Next(999999);
            var response = Client.Message.Create(
                src: AppNumber,
                dst: DstNumber,
                text: Message.Replace("__code__", code.ToString()));
            return code;
		}

Failover: Make a phone call with the OTP

If the SMS message doesn’t reach the mobile device, the user can request a voice OTP.

public int SendVerificationCodeCall(String DstNumber)
		{
			Random r = new Random();
			var code = r.Next(999999);
            var response = Client.Call.Create(
                to:new List<String>{DstNumber},
                    from:AppNumber,
                    answerMethod:"POST",
                    answerUrl:"https://twofa-answerurl.herokuapp.com/answer_url/"+code);
            return code;
		}

Step 3: Verify the OTP

Verify the OTP the user entered on their handset.

public string Index(string number, string code)
		{
			ConnectionMultiplexer redis = ConnectionMultiplexer.Connect(_configuration.GetValue<string>("RedisHost"));
			IDatabase conn = redis.GetDatabase();

			string key = $"number:{number}:code";
			var compare_code = (string)conn.StringGet(key);
	
				if (compare_code == code)
				{
					conn.KeyDelete(key);
					Verification verification = new Verification();
					verification.status = "success";
	                verification.message = "Number verified";
					string output = JsonConvert.SerializeObject(verification);
					return output;
				}
				else if(compare_code != code)
				{
					Verification verification = new Verification();
					verification.status = "failure";
					verification.message = "Number not verified";
					string output = JsonConvert.SerializeObject(verification);
					return output;
				}
			
				else
				{
					Verification verification = new Verification();
					verification.status = "failure";
					verification.message = "number not found";
					string output = JsonConvert.SerializeObject(verification);
					return output;
				}
		}

Test

To test the application, start the Redis server.

$ redis-server

Build and run the application from Visual Studio.

Set up ngrok to expose your local server to the internet.You should be able to see the application in action at https://<ngrok_identifier>.ngrok.io/.The finished application should look like this.

Getting Started

Concepts

API Reference

XML Reference

Tutorials

Migration Guides

Troubleshooting

Two-Factor Authentication

Prerequisites

Set up the demo application locally

A review of the code

Step 1: Generate the OTP

Step 2: Send an SMS message with the OTP

Failover: Make a phone call with the OTP

Step 3: Verify the OTP

Test

​Prerequisites

​Set up the demo application locally

​A review of the code

​Step 1: Generate the OTP

​Step 2: Send an SMS message with the OTP

​Failover: Make a phone call with the OTP

​Step 3: Verify the OTP

​Test

Prerequisites

Set up the demo application locally

A review of the code

Step 1: Generate the OTP

Step 2: Send an SMS message with the OTP

Failover: Make a phone call with the OTP

Step 3: Verify the OTP

Test