README

This bundle provides a two-factor authentication system for Roadiz CMS. Based on scheb/two-factor-bundle bundle.

• OTP (One Time Password) authentication with Google Authenticator
• Backup codes (hashed and stored in database)
• Trusted devices (remembered for a configurable amount of time)
• Use APP_NAMESPACE, APP_TITLE and APP_SECRET environment variables

Installation

Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

$ composer require roadiz/two-factor-bundle

Applications that don't use Symfony Flex

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:

$ composer require roadiz/two-factor-bundle

Step 2: Enable the Bundle

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

// config/bundles.php

return [
    // ...
    \RZ\Roadiz\TwoFactorBundle\RoadizTwoFactorBundle::class => ['all' => true],
];

Configuration

• Copy and merge @RoadizTwoFactor/config/packages/scheb_2fa.yaml files into your project config/packages folder
• Add this bundle routes to your project config/routes.yaml file:

# config/routes.yaml
roadiz_two_factor:
    resource: "@RoadizTwoFactorBundle/config/routing.yaml"

Contributing

Report issues and send Pull Requests in the main Roadiz repository