Skip to content

[WIP] Two Factor Authentication

License

Unknown, GPL-2.0 licenses found

Licenses found

Unknown
LICENSE.md
GPL-2.0
LICENSE.GPL
Notifications You must be signed in to change notification settings

collective/pas.plugins.tfa

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Plone Meta codecov Code Style GitHub contributors

pas.plugins.tfa

This is a requirement for the https://github.com/collective/volto-tfa Volto plugin.

Features

  • Provides a PAS plugin to add 2FA authentication to the normal login machinery.
  • Provides additional UI components & javascript for Plone ClassicUI

Installation

via buildout

Install pas.plugins.tfa by adding it to your buildout

[buildout]
    ...
    eggs =
        pas.plugins.tfa

and then running bin/buildout

If you are only using this plugin for volto-tfa then you do not need to anything further. Continue with the installation instructions for volto-tfa

via pip

checkout the package and install it via

pip install -e .

Setting up 2FA in ClassicUI

In order to enable 2FA on your classic site, start by enabling the addon.

Go the Plone control panel and install "pas.plugins.tfa"

To enable 2FA for a particular user, go to the Users control panel, select a user and check 'Two Factor Authentication'.

Once enabled a user will be prompted to configure their 2FA code the next time they login.

Test the package in a Testenvironment

python3 -m venv ./venv
source venv/bin/activate
pip install cookiecutter
pip install mxdev
mxdev -c mx.ini
pip install -r requirements-mxdev.txt
cookiecutter -f --no-input --config-file instance.yaml https://github.com/plone/cookiecutter-zope-instance
runwsgi -v instance/etc/zope.ini
deactivate 

Development

we use tox

python3 -m venv ./venv
source venv/bin/activate
tox -e init

Format the code run

tox -e format

Lint the code run

tox -e lint

Run tests

tox -e test

Run code coverage

tox -e coverage

check dependencies

tox -e dependencies

check circular dependencies

tox -e circular

check release

tox -e release-check

run all together

tox

Documentation of changes

we use towncrier

add a news snippet like xx.bugfix in news/

the content of the file should be a short description of your work

describe your work shortly @username 

Authors

This add-on is heavily inspired by and built upon collective.googleauthenticator (major credit goes to its contributors).

Initial plugin development by:

Mauro Amico (https://github.com/mamico)

Contributors

Put your name here, you deserve it!

Contribute

Support

If you are having issues, please create an issue at https://github.com/collective/pas.plugins.tfa/issues

License

The project is licensed under the GPLv2.

About

[WIP] Two Factor Authentication

Resources

License

Unknown, GPL-2.0 licenses found

Licenses found

Unknown
LICENSE.md
GPL-2.0
LICENSE.GPL

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages