Skip to content

Commit

Permalink
Add readme
Browse files Browse the repository at this point in the history
  • Loading branch information
Christopher Mühl committed Jan 4, 2018
1 parent 0be9a59 commit 0bab9e0
Show file tree
Hide file tree
Showing 2 changed files with 26 additions and 3 deletions.
25 changes: 24 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,24 @@
# Two-Factor Authentication Bundle
# Contao Two-Factor Authentication

[![Packagist](https://img.shields.io/packagist/v/dieschittigs/contao-tfa-bundle.svg?style=for-the-badge)](https://packagist.org/packages/dieschittigs/contao-tfa-bundle)
[![Packagist](https://img.shields.io/packagist/dt/dieschittigs/contao-tfa-bundle.svg?style=for-the-badge)](https://packagist.org/packages/dieschittigs/contao-tfa-bundle)
[![license](https://img.shields.io/github/license/dieschittigs/contao-tfa-bundle.svg?style=for-the-badge)]()

This Contao bundle enables Two-Factor Authentication (TFA/2FA) for backend users. Users with 2FA enabled are not allowed to visit any backend page after logging in, before typing in the correct access code.

The bundle is compatible with **Contao 4.4** or newer.

## Installation
No matter which method you use to install the package, make sure to run the install tool afterwards so that the additional database column can be created.

#### Composer
With [Composer](https://getcomposer.org/) simply type `composer require dieschittigs/contao-tfa-bundle` in your Contao installation's root folder.

#### Contao Manager (Contao 4.5+)
Select _Packages > Install Packages_ and search for `contao-tfa-bundle`. The button _Check & Install_ will then install it for you.

## Usage
To enable Two-Factor-Authentication for your account, visit your backend profile and open the "_Two-Factor Authentication_" section. Scan the displayed QR code with a compatible app (we recommend **Google Authenticator**, which is available for iOS and Android), verify by typing in the code generated by your app and save.

## Caveats
This bundle intercepts all backend requests to display a two-factor-authentication page for users that have 2FA enabled, but haven't yet authenticated themselves. As such the users can still log in, but they can't access any backend pages.
4 changes: 2 additions & 2 deletions composer.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
{
"name": "dieschittigs/contao-tfa-bundle",
"description": "Adds two-factor authentication to Contao 4 backend users",
"description": "Adds two-factor-authentication to Contao 4 backend users",
"type": "contao-bundle",
"require": {
"robthree/twofactorauth": "^1.6"
Expand All @@ -11,7 +11,7 @@
"email": "[email protected]"
}
],
"license": "LGPL-3.0",
"license": "LGPL-3.0+",
"autoload": {
"psr-4": {
"DieSchittigs\\TwoFactorAuth\\": "src/"
Expand Down

0 comments on commit 0bab9e0

Please sign in to comment.