Logs a session in. Requires a valid username and password for the current realm. If the username and password combination is invalid an error is thrown.

Example:

function login ( args ) {
  try {
    zimki.session.login( args.username, args.password );
  }
  catch (e) {
    return "could not log in";
  }
  return "logged in";
}
zimki.publishPath( '/login', login );