From 5c0380b6ede3b8e1d18e8abe40451ba9632202bf Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Fri, 10 Feb 2006 15:27:36 +0000 Subject: [PATCH] Added 'How to log a user in' section to docs/authetication.txt git-svn-id: http://code.djangoproject.com/svn/django/trunk@2297 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/authentication.txt | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/authentication.txt b/docs/authentication.txt index b784242f553..fd9da17c8b9 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 ----------------------------------