summaryrefslogtreecommitdiff
path: root/docs/topics
diff options
context:
space:
mode:
authorDylan Verheul <dylan@zostera.nl>2017-07-12 12:07:06 +0200
committerTim Graham <timograham@gmail.com>2018-02-16 13:58:55 -0500
commit9b1125bfc7e2dc747128e6e7e8a2259ff1a7d39f (patch)
tree4044872d7364729559a87fb1e3f508fc02586d07 /docs/topics
parente307ff29d28737d5a764ce2fa7db010231d6fc8e (diff)
Fixed #28379 -- Made AccessMixin raise Permissiondenied for authenticated users.
Diffstat (limited to 'docs/topics')
-rw-r--r--docs/topics/auth/default.txt18
1 files changed, 14 insertions, 4 deletions
diff --git a/docs/topics/auth/default.txt b/docs/topics/auth/default.txt
index a118e56543..3d9317f8f6 100644
--- a/docs/topics/auth/default.txt
+++ b/docs/topics/auth/default.txt
@@ -757,8 +757,17 @@ Redirecting unauthorized requests in class-based views
------------------------------------------------------
To ease the handling of access restrictions in :doc:`class-based views
-</ref/class-based-views/index>`, the ``AccessMixin`` can be used to redirect a
-user to the login page or issue an HTTP 403 Forbidden response.
+</ref/class-based-views/index>`, the ``AccessMixin`` can be used to configure
+the behavior of a view when access is denied. Authenticated users are denied
+access with an HTTP 403 Forbidden response. Anonymous users are redirected to
+the login page or shown an HTTP 403 Forbidden response, depending on the
+:attr:`~django.contrib.auth.mixins.AccessMixin.raise_exception` attribute.
+
+.. versionchanged:: 2.1
+
+ In older versions, authenticated users who lacked permissions were
+ redirected to the login page (which resulted in a loop) instead of
+ receiving an HTTP 403 Forbidden response.
.. class:: AccessMixin
@@ -781,8 +790,9 @@ user to the login page or issue an HTTP 403 Forbidden response.
.. attribute:: raise_exception
If this attribute is set to ``True``, a
- :class:`~django.core.exceptions.PermissionDenied` exception will be
- raised instead of the redirect. Defaults to ``False``.
+ :class:`~django.core.exceptions.PermissionDenied` exception is raised
+ when the conditions are not met. When ``False`` (the default),
+ anonymous users are redirected to the login page.
.. method:: get_login_url()