mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-08-03 10:34:04 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 1

Fixed #18616 -- added user_login_fail signal to contrib.auth

Browse source 
Thanks to Brad Pitcher for documentation
This commit is contained in:
Michael Farrell 2012-07-12 11:13:15 +09:30 • committed by Preston Holmes
parent 8bd7b598b6
commit 7cc4068c44
5 changed files with 62 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

4
docs/releases/1.5.txt
View file

@ -191,6 +191,10 @@ Django 1.5 also includes several smaller improvements worth noting:
recommended as good practice to provide those templates in order to present
pretty error pages to the user.
* :mod:`django.contrib.auth` provides a new signal that is emitted
whenever a user fails to login successfully. See
:data:`~django.contrib.auth.signals.user_login_failed`
Backwards incompatible changes in 1.5
=====================================

21
docs/topics/auth.txt
View file

@ -876,13 +876,15 @@ The auth framework uses two :doc:`signals </topics/signals>` that can be used
for notification when a user logs in or out.
.. data:: django.contrib.auth.signals.user_logged_in
:module:
.. versionadded:: 1.3
Sent when a user logs in successfully.
Arguments sent with this signal:
``sender``
As above: the class of the user that just logged in.
The class of the user that just logged in.
``request``
The current :class:`~django.http.HttpRequest` instance.
@ -891,6 +893,8 @@ Arguments sent with this signal:
The user instance that just logged in.
.. data:: django.contrib.auth.signals.user_logged_out
:module:
.. versionadded:: 1.3
Sent when the logout method is called.
@ -905,6 +909,21 @@ Sent when the logout method is called.
The user instance that just logged out or ``None`` if the
user was not authenticated.
.. data:: django.contrib.auth.signals.user_login_failed
:module:
.. versionadded:: 1.5
Sent when the user failed to login successfully
``sender``
The name of the module used for authentication.
``credentials``
A dictonary of keyword arguments containing the user credentials that were
passed to :func:`~django.contrib.auth.authenticate()` or your own custom
authentication backend. Credentials matching a set of 'sensitive' patterns,
(including password) will not be sent in the clear as part of the signal.
Limiting access to logged-in users
----------------------------------