django-proxy-users 0.0.8

Authentication extension to enable proxy users in django.

===================

Required components.
--------------------

Within the application we have integral components that are necessary
to run this app.

* Forms
* django_proxy_users.forms.AuthenticationForm (extends django.contrib.auth.forms.AuthenticationForm, django.core.paginator.Paginator)
* django_proxy_users.forms.AuthenticateAsForm (extends django.contrib.auth.forms.Form)

* Backends
* django_proxy_users.auth.backends.LoginAsBackend
* django_proxy_users.auth.backends.LogBackInAsBackend

* Context Processors
* django_proxy_users.context_processors.login_as


Sample Components and Open Source Libraries.
--------------------------------------------

* Open Source Libraries
* Jquery 1.8.2
* Twitter Bootstrap
* Views
* django_proxy_users.views.home
* django_proxy_users.views.login
* django_proxy_users.views.login
* django_proxy_users.views.logout
* django_proxy_users.views.login_as
* django_proxy_users.views.log_back_in_as

Install & Configure
===================

Required Steps to get it working.
----------------------------

1. Get the code source from either:
* Download and place within your django app.
* http://pypi.python.org/pypi/django-proxy-user/
* https://github.com/jturo/django-proxy-users
* OR PIP install
* pip install django-proxy-users

2. Install the app in setttings.py.::

INSTALLED_APPS = (
...
'django_proxy_users',
...
)

3. Add context processors.::

TEMPLATE_CONTEXT_PROCESSORS = (
...
"django.contrib.auth.context_processors.auth",
"django.core.context_processors.debug",
"django.core.context_processors.i18n",
"django.core.context_processors.media",
"django.core.context_processors.static",
"django.core.context_processors.tz",
"django.contrib.messages.context_processors.messages",
"django_proxy_users.context_processors.login_as",
...
)

4. Add Authentication Backends.::

AUTHENTICATION_BACKENDS = (
...
"django_proxy_users.auth.backends.LoginAsBackend",
"django_proxy_users.auth.backends.LogBackInAsBackend",
"django.contrib.auth.backends.ModelBackend",
...
)

Enable the example.
-------------------

1. Enable the django admin panel to add some testing users.

2. Update the urls.py file.

```
urlpatterns = patterns('',
...
url(r'^django/proxy/users/', include('django_proxy_users.urls')),
)
```

2. Syncronize the database.

python manage.py syncdb

3. Create some testing users.

Additional and Optional Configuration Options (settings.py).
-------------------------------------------------------------

**ORIGINAL_USER_KEY** session key where the original user is stored