==============
 Auth Handler
==============

The :term:`auth handler` is responsible for managing user accounts,
and related things:

* authenticate user from login credentials
* check which permissions a user/role has
* create/modify users, roles
* grant/revoke role permissions

The base class and default auth handler is
:class:`wuttjamaican.auth.AuthHandler`.

The :term:`app handler` is responsible for creating the auth handler
via :meth:`~wuttjamaican.app.AppHandler.get_auth_handler()`::

   app = config.get_app()
   auth = app.get_auth_handler()