~ubuntu-branches/ubuntu/quantal/python-django/quantal

« back to all changes in this revision

Viewing changes to docs/ref/authbackends.txt

  • Committer: Bazaar Package Importer
  • Author(s): Chris Lamb
  • Date: 2009-07-29 11:26:28 UTC
  • mfrom: (1.1.8 upstream) (4.1.5 sid)
  • Revision ID: james.westby@ubuntu.com-20090729112628-pg09ino8sz0sj21t
Tags: 1.1-1
* New upstream release.
* Merge from experimental:
  - Ship FastCGI initscript and /etc/default file in python-django's examples
    directory (Closes: #538863)
  - Drop "05_10539-sphinx06-compatibility.diff"; it has been applied
    upstream.
  - Bump Standards-Version to 3.8.2.

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.. _ref-authentication-backends:
 
2
 
 
3
==========================================
 
4
Built-in authentication backends reference
 
5
==========================================
 
6
 
 
7
.. module:: django.contrib.auth.backends
 
8
   :synopsis: Django's built-in authentication backend classes.
 
9
 
 
10
This document details the authentication backends that come with Django. For
 
11
information on how how to use them and how to write your own authentication
 
12
backends, see the :ref:`Other authentication sources section
 
13
<authentication-backends>` of the :ref:`User authentication guide
 
14
<topics-auth>`.
 
15
 
 
16
 
 
17
Available authentication backends
 
18
=================================
 
19
 
 
20
The following backends are available in :mod:`django.contrib.auth.backends`:
 
21
 
 
22
.. class:: ModelBackend
 
23
 
 
24
    This is the default authentication backend used by Django.  It
 
25
    authenticates using usernames and passwords stored in the
 
26
    :class:`~django.contrib.auth.models.User` model.
 
27
 
 
28
 
 
29
.. class:: RemoteUserBackend
 
30
 
 
31
    .. versionadded:: 1.1
 
32
 
 
33
    Use this backend to take advantage of external-to-Django-handled
 
34
    authentication.  It authenticates using usernames passed in
 
35
    :attr:`request.META['REMOTE_USER'] <django.http.HttpRequest.META>`.  See
 
36
    the :ref:`Authenticating against REMOTE_USER <howto-auth-remote-user>`
 
37
    documentation.