emptynick/voyager-2fa

Two-factor authentication for Voyager II

v1.0.0 2021-12-07 11:22 UTC

This package is auto-updated.

Last update: 2024-11-07 17:58:00 UTC


README

This plugin for Voyager II uses pragmarx/google2fa-laravel for two-factor-authentication.

Installation

First, run composer require emptynick/voyager-2fa.
After that run php artisan 2fa:install.

This will:

  1. Publish pragmarx/google2fa-laravel config file
  2. Publish a migration to add a field named google2fa_secret to your users table
  3. Migrate

You can skip publishing the config file and migrating.
This is helpful when you want to modify the migration file.

Usage

By default, this plugin does not force you to use 2FA.
Whenever a 2FA code is assigned to a user, it will ask for it when logging-in.

Activating 2FA for your account

Open the top-right user dropdown and click Manage 2FA.
There you will see a QR code and an input box.
Scan the QR code with your phone or enter the code manually and enter the generated OTP into the input.
Click Enable and the code will be stored.
Now, whenever you log-in, you'll be asked for a one-time-password.

Warning

Disable 2FA

Clicking the Disable button will remove the OTP code from the database.
You are not required to enter an OTP when logging-in.
This requires the setting 2FA.allow_disabling to be on!

Renew 2FA code

When 2FA is active, you can simply renew the code. Proceed like described in Activating 2FA for your account and click on Renew instead of Enable!

Settings

This plugin publishes some settings.

2FA.force_2fa

When active, this setting will prevent the user to open any page before setting-up 2FA. Defaults to false.

2FA.show_warning

Shows a warning whenever a page is opened and 2FA is not activated for the current user. Defaults to true.

Warning

2FA.allow_disabling

Allow users to disable two-factor-auth. Defaults to true.