In this step, you will install the code you will use as the starting point for this tutorial.
The application is a fictional social network site called Kittens and Co. It currently enables you to register with a user name and password but you will improve it to support two-factor authentication (2FA) for added security.
First, ensure that you have Ruby and
bundler installed by running:
ruby --version bundler --version
Then, clone the tutorial application from its GitHub repository and run it locally:
git clone https://github.com/nexmo-community/nexmo-rails-devise-2fa-demo.git cd nexmo-rails-devise-2fa-demo bundle install rake db:migrate RAILS_ENV=development rails server
At this point you can start the app, register for an account with a user name and password and log in and out. The application implements registration and login using Devise but most of this tutorial applies similarly to applications that use other authentication methods. Additionally, the application uses the
devise-bootstrap-templates gems for styling.
The next step is to add two-factor authentication to the registration and login process.
All the code you need to complete this tutorial is on the
basic-login branch. The completed code is on the
Ensure that you are on the
basic-login branch before continuing. You can display the current branch in
git by running:
git rev-parse --abbrev-ref HEAD
Switch branches if necessary by executing:
git checkout basic-login