summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/authentication.txt15
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/authentication.txt b/docs/authentication.txt
index b784242f55..fd9da17c8b 100644
--- a/docs/authentication.txt
+++ b/docs/authentication.txt
@@ -228,6 +228,21 @@ information.
.. _request objects: http://www.djangoproject.com/documentation/request_response/#httprequest-objects
.. _session documentation: http://www.djangoproject.com/documentation/sessions/
+How to log a user in
+~~~~~~~~~~~~~~~~~~~~
+
+To log a user in, do the following within a view::
+
+ from django.models.auth import users
+ request.session[users.SESSION_KEY] = some_user.id
+
+Because this uses sessions, you'll need to make sure you have
+``SessionMiddleware`` enabled. See the `session documentation`_ for more
+information.
+
+This assumes ``some_user`` is your ``User`` instance. Depending on your task,
+you'll probably want to make sure to validate the user's username and password.
+
Limiting access to logged-in users
----------------------------------