1
.. _ref-authentication-backends:
3
==========================================
4
Built-in authentication backends reference
5
==========================================
7
.. module:: django.contrib.auth.backends
8
:synopsis: Django's built-in authentication backend classes.
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
17
Available authentication backends
18
=================================
20
The following backends are available in :mod:`django.contrib.auth.backends`:
22
.. class:: ModelBackend
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.
29
.. class:: RemoteUserBackend
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>`