.. _09:

======================
LoginController.signin
======================

.. image :: images/08.jpg
   :align: center
   :height: 544
   :width: 923

:func:`myapp/controllers/login.py:LoginController.signin`

The sign-in form sends a POST request carrying the data entered into the ``username`` and ``password`` fields.

The submitted data is checked against that held in the database by means of a :func:`User.authenticate` class method (not treated here) which retrieves the :class:`User` named ``username`` and checks the submitted ``password`` against the stored value, thus maintaining good separation between generic auth'n'auth routines and data structure specifics.

If the user has successfully authenticated, then :func:`auth.login` is called with the :class:`User` object as arg.