====== Login ======

The configured Login Module is executed for the following [[server:Terminal]] Server connections:
   * All Telnet connections
   * Unauthenticated SSH and RLogin connections

This module is responsible for querying the user's login ID and initiating the login process.

The name of the login module (by default, ''login'') is configured in [[util:SCFG]]->System->Loadable Modules->Login.

The [[http://cvs.synchro.net/cgi-bin/viewcvs.cgi/exec/login.js|default login module]] is ''[[dir:exec]]/login.js'' and supports the following configuration options in the ''[login]'' section of the ''[[dir:ctrl]]/[[config:modopts.ini]]'' file:

^ Option ^ Default      ^ Description ^
| email_passwords       | true  | Send forgotten passwords to users via [[server:mail|email (SMTP)]] |
| confirm_email_address | true  | Requires user to confirm their email address before sending a forgotten password |
| login_prompts         | 10    | Maximum number of login prompts to display before disconnecting |
| inactive_hangup       | 30    | Seconds of dumb-terminal (e.g. non-ANSI) user/bot inactivity before disconnecting |
| guest                 | true  | Display the "or Guest" login suggestion when a "Guest" user account exists |

===== Customize =====

If you choose to use a customized or entirely different login module, it is recommended that you use a different module name (not "login") and/or copy the login module to your ''[[dir:mods]]'' directory before modifying.

===== See Also =====
  * [[:module:|Modules]]
  * [[:module:Logon]] Module
  * [[:dir:exec]] Directory
  * [[:dir:mods]] Directory