NAME

IX::Login - manage authentication interface and modes for web apps


SYNOPSIS

  use IX::Login;
  ...
  IX::Login::login();
  IX::Login::logout();
  IX::Login::loginInterface();


REQUIREMENTS

IX::Login cannot operate independently of the IX framework.


DESCRIPTION

IX::Login and IX::Authenticate work closely together, where IX::Login takes care of the interfaces closest to the end user.


FEATURES

Manual vs. Automatic Authmodes

IX::Login expects a $IX::Conf::x{authmode} value of 'manual' or 'automatic', and will default to 'manual' if an empty or invlaid value is set.

An authmode of 'manual' will prompt the user to select an authentication system from a dropdown menu, and will only attempt to authenticate against that system with the provided username/password. The first value in the $IX::Conf::x{authsystems} list will be preselected in the dropdown as a preferred system.

Setting the authmode to 'automatic' will hide authentication options from the user and attempt to authenticate against each of the systems listed in $IX::Conf::x{authsystems} until one of the attempts succeeds. The systems will be tried in the order they are listed in $IX::Conf::x{authsystems}.

loginInterace()

The default login page presented by IX when an application requires authentication to perform certain actions (see IX::Dispatch).


AUTHORS

Written and maintained by Marcus Del Greco (marcus@mindmined.com)