Download the PHP package lahthony/otp-auth-bundle without Composer

LahthonyOTPAuthBundle

About :

This bundle permits to easy implements 2 factor authentication in a symfony project.

Users will then get TOTP authentication by using apps like Google Authenticator

Let's get started. Just go through the following steps.

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

This command requires you to have Composer installed globally, as explained in the installation chapter of the Composer documentation.

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the app/AppKernel.php file of your project:

Then you will need to update the service.yml

Step 3: Implements OTPAuthInterface

You need to implement the OTPAuthInterface on your User Entity commonly present in src/AppBundle/Entity/User.

:warning: Do not forget to generate getter setter. :warning:

:warning: After that DO NOT FORGET to schema update: :warning:

Step 4: Add one field to your UserFormType

We've made for you an eventsubscriber that permits you to add the required field easily on yourUserFormType.

You can add it on your UserEditType too if you want to permit your users to enable or disable OTP Authentication after he has registered.

Just do like so:

For User Registration:

For User Edit:

Step 5: Update your Login Form And your homepage

You need now to add one field one your login form and the link to reset the authenticator

Step 6: Import Routes

In your routing.yml import routes from our bundle :

Step 7: Enjoy

• You can now try it. First create a user that accepts the 2Factor Authentication.

• Then a flash message will appears on your homepage with the QRCode and the Recovery Pass.

  :warning: Don't forget to wrote it down the Recovery Pass if you want to recover an account that has lost its authenticator. :warning:

  Scan the QRCode with an otp app like Google Authenticator dowload it here

• Go on the login page and enter the generated code on your app to connect.

• You can now update it from your user edit ask to disable it.

• That's magic right ?! Hope you like it; feel free to give us feed backs and report bugs. We'd like to know your opinion.

Configuration

If you want to redefine default configuration add this to your app/config/config.yml