this function DOES NOT check authentication - it just checks/provides
authentication credentials required to connect to the MySQL server
usually with $GLOBALS['dbi']->connect()
it returns false if something is missing - which usually leads to
auth() which displays login form
it returns true if all seems ok which usually leads to auth_set_user()
it directly switches to authFails() if user inactivity timeout is reached