.. _standard-users-and-login:

Standard users and login
------------------------

Overview 
..........

For a system user that uses the standard authorization method, the
password is stored in the internal system database. 

.. note::
    VOSS Automate uses the PBKDF2 algorithm with an SHA256 hash, a key stretching mechanism recommended by 
    the National Institute of Standards Technology (NIST), Computer Security Resource Center (CSRC).


Login URL and page theme
.............................

Standard users log in at the following URL:  ``https://{hostname}/login``
  
A login page page theme can be applied to the login page during the log in process. To do this, add a 
suffix ``?theme={theme_name}`` where ``{theme_name}`` is an available theme. 

Example:  ``https://{hostname}/login/?theme=default``


Username format and hierarchy
................................

When logging in, the username can be entered in either of the following formats:

* ``{username}@hierarchy``
* ``{email address}``
* ``{username}``

.. important::
   If logging in with just ``{username}``, your username must be unique at the hierarchy level, else login 
   fails. In this case, log in using either ``{username}@hierarchy`` or ``{email address}``. Email address 
   must be unique in the system.  


Hierarchy is in dot notation and corresponds with the hierarchy to which the
user belongs. The hierarchy level is the level at which the user is created. On the login form, 
the hierarchy is prefixed with ``sys``.


Example: ``johndoe@sys.VS-OPS.VS-Corp.Chicago``


.. rubric:: Related Topics 

* :ref:`standard-users-and-login`
* :ref:`manage-themes-default-theme` (if a theme is applied to the login screen)