-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Christopher Mühl
committed
Jan 4, 2018
1 parent
0be9a59
commit 0bab9e0
Showing
2 changed files
with
26 additions
and
3 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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" | ||
|
@@ -11,7 +11,7 @@ | |
"email": "[email protected]" | ||
} | ||
], | ||
"license": "LGPL-3.0", | ||
"license": "LGPL-3.0+", | ||
"autoload": { | ||
"psr-4": { | ||
"DieSchittigs\\TwoFactorAuth\\": "src/" | ||
|