3 minute read.Last Modified 2023-11-17 12:56 EST
The TrueNAS CLI guide for SCALE is a work in progress! New namespace and command documentation is continually added and maintained, so check back here often to see what is new!
auth two_factor commands are based on authentiation functions found in the SCALE API and web UI. Use to set up user two-factor authentication and view status for the user.
auth ls to view the list of available commands and namespaces.
The interactive argument editor is a text user interface (TUI) that can help enter complex commands with multiple configurable properties. It shows expected properties, defaults, input types (string, boolean, integer, or array), and can include command instructions or warnings.
Optional properties, indicated by the
# symbol, are disabled by default.
Required properties are enabled.
Do not disable properties that are enabled by default.
To configure required properties, enter a space after the colon then add the value.
To enable optional properties, delete
# from the corresponding line.
Some required properties are disabled if they are part of a pair of properties where one or the other is required. Select one property to enable and enter a value.
Press F2 or click Save to save the modified file.
Press F10, Esc, or click Quit to exit the TUI. The command automatically executes upon exit.
auth two_factor config displays current 2FA settings for the currently logged-in user.
auth two_factor config does not require entering properties or arguments.
Enter the command, then press Enter. The command returns a table with two-factor authentication properties for the currently logged-in user.
|Displays the system-assigned ID number for the currently logged-in user.|
|Displays the length (number of digits) allowed for a one-time password.|
|Displays the number of passwords before and after the current remain valid for the currently logged-in user.|
|Displays the lifespan of a one-time password for the currently logged-in user.|
auth two_factor config +------------+--------+ | id | 1 | | otp_digits | 6 | | secret | <null> | | window | 0 | | interval | 30 | | services | <dict> | | enabled | false | +------------+--------+
auth two_factor update command changes 2FA settings.
auth two_factor update has five property arguments. Enter at least one property arguments.
See two_factor update Properties for details.
Enter the command string then press Enter. The command returns nothing when successful.
|Enter a number from six to eight to set the length of a one-time password.|
|Enter a number of passwords before and after the current remain valid. This extends the validity of one-time passwords.|
|Enter a number to set the lifespan of a one-time password.|
|Enter the |