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