.. _index:

***************************************************
:mod:`repoze.who` -- WSGI Authentication Middleware
***************************************************

:Author: Chris McDonough / Tres Seaver
:Version: |version|

.. module:: repoze.who
   :synopsis: WSGI authentication middleware

.. topic:: Overview

   :mod:`repoze.who` is an identification and authentication framework
   for arbitrary WSGI applications.  It can be used as WSGI middleware,
   or as an API from within a WSGI application.

   :mod:`repoze.who` is inspired by Zope 2's Pluggable Authentication
   Service (PAS) (but :mod:`repoze.who` is not dependent on Zope in any
   way; it is useful for any WSGI application).  It provides no
   facility for authorization (ensuring whether a user can or cannot
   perform the operation implied by the request).  This is considered
   to be the domain of the WSGI application.
 
   It attempts to reuse implementations from ``paste.auth`` for some
   of its functionality.

Sections
========

.. toctree::
   :maxdepth: 2

   narr
   use_cases
   middleware
   api
   configuration
   plugins

Change History
==============

.. toctree::
   :maxdepth: 2

   changes

Support and Development
=======================

To report bugs, use the `Repoze bug tracker <http://bugs.repoze.org>`_.

If you've got questions that aren't answered by this documentation,
contact the `Repoze-dev maillist
<http://lists.repoze.org/listinfo/repoze-dev>`_ or join the `#repoze
IRC channel <irc://irc.freenode.net/#repoze>`_.

Browse and check out tagged and trunk versions of :mod:`repoze.who`
via the `Repoze github repository
<https://github.com/repoze/repoze.who/>`_.  To check out the trunk
via git, use this command::

  git clone https://github.com:repoze/repoze.who.git

Or, if you are logged in:

  git clone git@github.com:repoze/repoze.who.git

To find out how to become a contributor to :mod:`repoze.who`, please
see the `contributor's page <http://repoze.org/contributing.html>`_.

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`