[django]总结Django中的用户权限模块

此文是总结Django官方网站里面的Document的文章 User authentication in Django
http://www.djangoproject.com/documentation/authentication/

该模块由
用户（Users)
权限(Permissions)
组（Groups）
消息（Messages）

这些从字面上也都很好的理解，但是我对消息（Messages）还不是很理解…………

1、安装
1）将'django.contrib.auth'添加到Setting.py的INSTALLED_APPS 中
2）安装数据库 manage.py syncdb.
其实用户权限模块是Django自己已经写好的app,所以他也具有自身的Models,所以需要同步数据库。

2、User
1)属性
其中他包含User类，他具有以下字段
username，first_name，last_name，email，password，is_staff（是否具有进入网站管理权限），
is_active，is_superuser，last_login，date_joined.

这是Django自带的User的基本的信息，如果你要使用该权限模块，就必须要使用他的User类，
但是通常情况下，我们的用户信息还会有其他的属性，这时我们可以再增加一类来扩展，该类和User的关系是OneToOne。
如：
#这是china-django中的代码

class Profile(models.Model):
    user = models.OneToOneField(User)

    blog = models.CharField(maxlength=128, blank=True)
    location = models.CharField(maxlength=128, blank=True)
    occupation = models.CharField(maxlength=64, blank=True)
    
    reward = models.IntegerField(default=0, blank=True)
    topic_count = models.IntegerField(default=0, blank=True)
    post_count = models.IntegerField(default=0, blank=True)
    
    class Admin:
        list_display = ('user', 'blog', 'location', 'occupation', 'reward', 'topic_count', 'post_count')

2）方法
这里列举几个主要的方法
is_anonymous()：是否为匿名用户，如果你已经login,则这个方法返回始终为false.
is_authenticated():是否通过验证，也就是通过用户名和密码判断该用户是否存在.
get_group_permissions()：得到所有该用户所属组别的权限.
get_all_permissions()：得到该用户所有的权限.
has_perm(perm)：判断用户是否具有特定权限,perm的格式是appname.codename.
email_user(subject, message, from_email=None):给某用户发送邮件

3) AnonymousUser
AnonymousUser是继承自User接口,但是和User有不同处：
id属性为None
is_anonymous() 返回始终为True
is_authenticated() 返回始终为False
has_perm() 返回始终为False
set_password(), check_password(), save(), delete(), set_groups()和set_permissions() 都会触发 NotImplementedError错误

3、User的验证
1）登陆(Login)

from django.contrib.auth import authenticate, login

def my_view(request):
    username = request.POST['username']
    password = request.POST['password']
    user = authenticate(username=username, password=password)
    if user is not None:
        login(request, user)
        # Redirect to a success page.
    else:
        # Return an error message.

首先我们要验证这个用户，然后再登陆，登陆成功后，我们可以通过request.user 来得到当前登陆的用户对象。

2）注销(Logout)

from django.contrib.auth import logout

def logout_view(request):
    logout(request)
    # Redirect to a success page.

3)限制非法用户访问
最普通的方法是通过request.user.is_authenticated()来判断

from django.http import HttpResponseRedirect

def my_view(request):
    if not request.user.is_authenticated():
        return HttpResponseRedirect('/login/?next=%s' % request.path)
    # 

另外有一快捷的方法login_required

from django.contrib.auth.decorators import login_required

@login_required
def my_view(request):
    # 

这样当你访问my_view的时候，就需要用户需要通过验证.若不通过则跳转到
/accounts/login/?next=/polls/3/
并将当前访问的页面作为他的一个参数，并且传递三个Context变量
form 一个FormWrapper 对象用来重构登陆表单
next 就是你访问的当前页面
site_name 当前站点名称，在Setting.py中设置SITE_ID的值

另外，我们还需要在你的urls里面配置/accounts/login路径
下面有两种两种，不同的是使用不同的模版，第一种默认使用registration/login.html 模版，第二种方式是我们自定义模版

(r'^accounts/login/$', 'django.contrib.auth.views.login'),
(r'^accounts/login/$', 'django.contrib.auth.views.login', {'template_name': 'myapp/login.html'}),

一个login.html模版的实例：

{% extends "base.html" %}

{% block content %}

{% if form.has_errors %}
<p>Your username and password didn't match. Please try again.</p>
{% endif %}

<form method="post" action=".">
<table>
<tr><td><label for="id_username">Username:</label></td><td>{{ form.username }}</td></tr>
<tr><td><label for="id_password">Password:</label></td><td>{{ form.password }}</td></tr>
</table>

<input type="submit" value="login" />
<input type="hidden" name="next" value="{{ next }}" />
</form>

{% endblock %}

4）用户是否有权限访问

当我们创建了一个带有class Admin:内类的类后，会自动add, create 和 delete三种权限，不过我们也可以自己定义权限。
如下：

class USCitizen(models.Model):
    # 
    class Meta:
        permissions = (
            ("can_drive", "Can drive"),
            ("can_vote", "Can vote in elections"),
            ("can_drink", "Can drink alcohol"),
        )

这样我们为USCitizen类定义了三种自定义的权限,其中第一项是codename,第二项是discription。 

当我们定义好权限后，我们可以通过user.has_perm来判断是否具有权限

def my_view(request):
    if not (request.user.is_authenticated() and request.user.has_perm('polls.can_vote')):
        return HttpResponse("You can't vote in this poll.")

has_perm的参数应该是appname(packname) + . + codename

还有一种更简便的方式,如下：
@user_passes_test(lambda u: u.has_perm('polls.can_vote'))
这样如果该用户没有权限，则自动跳转到/accounts/login/，也可以自定义跳转
@user_passes_test(lambda u: u.has_perm('polls.can_vote'), login_url='/login/')

4、template中的用户验证
Users

{% if user.is_authenticated %}
    <p>Welcome, {{ user.username }}. Thanks for logging in.</p>    
{% else %}
    <p>Welcome, new user. Please log in.</p>
{% endif %}

Permissions
{{ perms.foo }}，一个已经登陆的用户对foo的app只要有任何的权限，{{ perms.foo }}就会等于True,反之为False
{{ perms.foo.can_vote }}, 这个很清楚了...
实例如下：

{% if perms.foo %}
    <p>You have permission to do something in the foo app.</p>
    {% if perms.foo.can_vote %}
        <p>You can vote!</p>
    {% endif %}
    {% if perms.foo.can_drive %}
        <p>You can drive!</p>
    {% endif %}
{% else %}
    <p>You don't have permission to do anything in the foo app.</p>
{% endif %}

5、authentication backends
Django中队用户的验证都是通过自身的模块，也可以使用其他的模块。
默认的AUTHENTICATION_BACKENDS 是
('django.contrib.auth.backends.ModelBackend',)

我们可以自己写一个不同的用户验证方式，但必须具有get_user 和authenticate方法
如：

from django.conf import settings
from django.contrib.auth.models import User, check_password

class SettingsBackend:
    """
    Authenticate against the settings ADMIN_LOGIN and ADMIN_PASSWORD.

    Use the login name, and a hash of the password. For example:

    ADMIN_LOGIN = 'admin'
    ADMIN_PASSWORD = 'sha1$4e987$afbcf42e21bd417fb71db8c66b321e9fc33051de'
    """
    def authenticate(self, username=None, password=None):
        login_valid = (settings.ADMIN_LOGIN == username)
        pwd_valid = check_password(password, settings.ADMIN_PASSWORD)
        if login_valid and pwd_valid:
            try:
                user = User.objects.get(username=username)
            except User.DoesNotExist:
                # Create a new user. Note that we can set password
                # to anything, because it won't be checked; the password
                # from settings.py will.
                user = User(username=username, password='get from settings.py')
                user.is_staff = True
                user.is_superuser = True
                user.save()
            return user
        return None

    def get_user(self, user_id):
        try:
            return User.objects.get(pk=user_id)
        except User.DoesNotExist:
            return None

这个时候我们需要修改Setting
AUTHENTICATION_BACKENDS = (
 'sputnik.backends.ldapBackend.LDAPBackend',
)

这里还有一片关于Authentication Backends的文章

LDAP Authentication in Django with Backends

全文结束，谈不上总结，因为缺少我的体会和心得，也谈不上翻译，因为my englishi is Poor.

See You!!!