Browse files

Fixed #4819: documented the need to call authenticate() before login…

…(), based on a patch from Davd Krauth.

git-svn-id: bcc190cf-cafb-0310-a4f2-bffc1f526a37
  • Loading branch information...
ubernostrum committed Dec 1, 2007
1 parent 0e464d5 commit 1087dc31fb1ef5b921d12619b9e7aba209b1643f
Showing with 11 additions and 0 deletions.
  1. +11 −0 docs/authentication.txt
@@ -337,6 +337,17 @@ This example shows how you might use both ``authenticate()`` and ``login()``::
# Return an 'invalid login' error message.
+.. admonition:: Calling ``authenticate()`` first
+ When you're manually logging a user in, you *must* call
+ ``authenticate()`` before you call ``login()``; ``authenticate()``
+ sets an attribute on the ``User`` noting which authentication
+ backend successfully authenticated that user (see the `backends
+ documentation`_ for details), and this information is needed later
+ during the login process.
+.. _backends documentation: #other-authentication-sources
Manually checking a user's password

0 comments on commit 1087dc3

Please sign in to comment.