MRCI/docs/intern_commands/auth.md

### Summary ###

login to the host using a registered user account name or email address.

### IO ###

```[-user (text)] or [-email (text)]/[text]```

### Description ###

login into a user account name given in -user or email address given in -email. this command will ask for the password during execution to complete the authentication. this command will also honor any request to change the password or user name before completing the authentication.
Initial commit for the MRCI project. 2019-09-06 23:43:07 -04:00			`### Summary ###`

			`login to the host using a registered user account name or email address.`

			`### IO ###`

			```[-user (text)] or [-email (text)]/[text]```

			`### Description ###`

Password and account security updates security updates: various commands that change or create account passwords now disallow the user name, display name or email from being contained in it. this will force users to not use public information inside the password, hardening password security a little. the root user name is now changeable and required to be changed on initial login. this harden security a little by giving host admins the option to not have a well known user name attached to a high privileged account. users can no longer re-use the old password and/or user name when required to change. however, this does not actually implement full password history because the user can then later change the password back to the old password after the required change. the host can longer block by ip addresses and the auto block threshold setting has been removed. something like this is best left up to firewalls, routers, switches or any other networking infrastructure. in the future i can consider adding event triggering that run certain admin defined external or internal commands when the host detects certain event thresholds. minor changes/bug fixes: all commands that change or create user names now no longer accept user names that looks like an mail address. this works out better for clients when differentiating logging in via user name or email address. the recover_acct command now also have cancel on blank text options making it more consistent with all other commands that take text input. resetting the root user's account password via command line now also unlocks it if locked. the -help and -about command line options no longer display the default password. a new -default_pw option was added for this purpose. the -status -addr or -stop command line options require super user privileges to run properly depending on how the host is installed. an error message like "permission denied" was addded on failure to make this requirement clear to the end user. fs_copy and fs_move now does implicit skip on error instead of stop on error. the IDLE frame type id now carry an integer return code that can be interpreted by clients to determine the result of the command that was sent to the host. house keeping: all documentation was updated to reflect the changes made in this commit. the module tester example is no longer relevant to this project so it was deleted. 2020-01-29 12:29:01 -05:00			`login into a user account name given in -user or email address given in -email. this command will ask for the password during execution to complete the authentication. this command will also honor any request to change the password or user name before completing the authentication.`