Two Factor Authentication - 2FA

From nuBuilderForte
Revision as of 05:21, 1 April 2021 by Apmuthu (talk | contribs) (Created page with "== Activate 2FA == This is done in the '''nuconfig.php''' file using these setting parameters (true) whose default values when disabled are: <pre> $nuConfig2FAAdmin = false; ...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Activate 2FA

This is done in the nuconfig.php file using these setting parameters (true) whose default values when disabled are:

$nuConfig2FAAdmin  = false;              //-- Use 2FA authentication for administrator
$nuConfig2FAUser   = false;              //-- Use 2FA authentication for users
$nuConfig2FAFormID = "nuauthentication"; //-- 2FA form ID. Default id: nuauthentication
$nuConfig2FATokenValidityTime = 168;     //-- 2FA Token Validity Time in Hours. Default: 7 days (7 * 24 hours)
$nuConfig2FAShowRememberMe    = false;   //-- Show a checkbox "Remember me for X days" in the authentication form

Functionality

  • If the 2FA authentication is active, a user is redirected to an authentication form after logging in.
  • On that form, a two-factor authentication token can be requested, which will be sent by email (or SMS).
  • If a valid token is entered, redirected to the actual form will occur.
  • One cannot open any other form until authenticated.
  • No need to authenticate again after a successful login during the "Token Validity Time" (same machine, browser)

2fa.png

Setting up 2FA

  • Setup the nuconfig.php variables above as appropriate like:
$nuConfig2FAAdmin = true;
$nuConfig2FAUser = true;
$nuConfig2FAShowRememberMe = false;
  • Navigate to Home -> Builders -> PHP Procedure "nuAuthentication2FA_Template"
  • Clone it
  • Adapt the code to your needs and save it.