Skip to content
This repository has been archived by the owner on Apr 11, 2019. It is now read-only.

Latest commit

 

History

History
45 lines (28 loc) · 1.8 KB

README.md

File metadata and controls

45 lines (28 loc) · 1.8 KB
Raw

Redmine Out of Band Auth (2 factor authentication, 2FA)

Build Status

Redmine plugin that provides Out of Band authentication by email.

Usage

  • Check the Enable out of band authentication checkbox on the Administrator > Users > username or My account page.
    • Will send a verification code to the default notification email address from the next login.
  • If you want to encrypt the verification code, register database_cipher_key in your_redmine_path/config/configuration.yml .
    • If you are already registering SCM or LDAP password, please carefully read the notes in your_redmine_path/config/configuration.yml, such as by running rake db:encrypt RAILS_ENV=production .

Screenshot

Out of Band Authentication

out_of_band_auth

My account

my_account

Verification code

verification_code

Install

  1. git clone or copy an unarchived plugin to plugins/redmine_out_of_band_auth on your Redmine path.
  2. $ cd your_redmine_path
  3. $ bundle install
  4. $ bundle exec rake redmine:plugins:migrate NAME=redmine_out_of_band_auth RAILS_ENV=production
  5. web service restart

Uninstall

  1. $ cd your_redmine_path
  2. $ bundle exec rake redmine:plugins:migrate NAME=redmine_out_of_band_auth RAILS_ENV=production VERSION=0
  3. remove plugins/redmine_out_of_band_auth
  4. web service restart

License

The MIT License