Django權限auth模塊詳解

轉自:http://www.cnblogs.com/Finley/p/5575305.html

1,auth模塊是Django提供的標準權限管理系統,能夠提供用戶身份認證,用戶組和權限管理

2,auth能夠和admin模塊配合使用,快速創建網站的管理系統

在INSTALLED_APPS中添加'django.contrib.auth'使用該APP,auth模塊默認啓用

user

user是auth模塊中維護用戶信息的關係模式(繼承了model.Model)數據庫中該表被命名爲auth_user

User表的SQL描述:

CREATE TABLE "auth_user" (
    "id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, 
    "password" varchar(128) NOT NULL, "last_login" datetime NULL, 
    "is_superuser" bool NOT NULL, 
    "first_name" varchar(30) NOT NULL, 
    "last_name" varchar(30) NOT NULL,
    "email" varchar(254) NOT NULL, 
    "is_staff" bool NOT NULL, 
    "is_active" bool NOT NULL,
    "date_joined" datetime NOT NULL,
    "username" varchar(30) NOT NULL UNIQUE
)

 auth模塊提供了不少API管理用戶信息,在必要的時候咱們能夠導入User表進行操做,好比其餘表須要與User創建關聯時

from django.contrib.auth.models import User

 新建用戶

user = User.objects.create_user(username, email, password)

 創建對象

user.save()

 須要調用save()方法新用戶纔會寫入數據庫

auth模塊不存儲用戶密碼明文而是存儲一個hash值,好比迭代使用Md5算法

認證用戶

先導入函數

from django.contrib.auth import authenticate

 使用關鍵字參數傳遞帳戶和憑據:

user = authenticate(username=username, password=password)

 認證用戶的密碼是否有效,如有效則返回表明該用戶的user對象,若無效則返回None.

修改密碼

修改密碼是User的實例方法,該方法不驗證用戶身份:

user.set_password(new_password)

 一般該方法須要和authenticate配合使用:

user = auth.authenticate(username=username, password=old_password)
if user is not None:
       user.set_password(new_password)
       user.save()

 登陸

首先import

from django.contrib.auth import login

 login向session中添加session_key,便於對用戶進行跟蹤:

login(request,user)

login不進行認證,也不檢查is_active標誌位,通常和suthenticate配合使用:

user = authenticate(username=username, password=password)
if user is not None:
      if user.is_active:
            login(request, user)

 在auth/__init__.py中能夠看到login的源代碼.

退出登陸

logout會移除request中的user信息,並刷新session

from django.contrib.auth import logout
def logout_view(request):
     logout(request)

 只容許登陸的用戶訪問

@login_required修飾器修飾的view函數會先經過session key檢查是否登陸,已登陸用戶能夠正常的執行操做,未登陸用戶將被重定向到login_url指定的位置

若未指定login_url參數,則重定向到setting.LOGIN_URL

from django.contrib.auth.decorators import login_required

@login_required(login_url='/accounts/login/')
def my_view(request):

 Group

django.contrib.auth.model.Group定義了用戶組的模型,每一個用戶組擁有id和name兩個字段,該模型在數據庫被映射爲auth_group數據表

User對象中有一個名爲groups的多對多字段,多對多關係由auth_user_groups數據表維護.Group對象能夠用過user_set反向查詢用戶組中的用戶

咱們能夠經過建立刪除Group對象來添加或刪除用戶組.

#add
group = Group.objects.create(name=group_name)
group.save()
#del
group.delete()

 

咱們能夠經過標準的多對多字段操做管理用戶與用戶組的關係:

• 用戶加入用戶組user.groups.add(group)或group.user_set.add(user)

• 用戶退出用戶組user.groups.remove(group)或group.user_set.remove(user)

• 用戶退出全部用戶組user.groups.clear()

• 用戶組中全部用戶退出組group.user_set.clear()

Permission

Django的auth系統提供了模型級的權限控制， 便可以檢查用戶是否對某個數據表擁有增(add), 改(change), 刪(delete)權限。

auth系統沒法提供對象級的權限控制， 即檢查用戶是否對數據表中某條記錄擁有增改刪的權限。若是須要對象級權限控制可使用django-guardian.

假設在博客系統中有一張article數據表管理博文， auth能夠檢查某個用戶是否擁有對全部博文的管理權限， 但沒法檢查用戶對某一篇博文是否擁有管理權限。

檢查用戶權限

user.has_perm方法用於檢查用戶是否擁有操做某個模型的權限:

user.has_perm('blog.add_article') user.has_perm('blog.change_article') user.has_perm('blog.delete_article')

上述語句檢查用戶是否擁有blog這個app中article模型的添加權限， 若擁有權限則返回True。

has_perm僅是進行權限檢查, 便是用戶沒有權限它也不會阻止程序員執行相關操做。

permission_required修飾器能夠代替has_perm並在用戶沒有相應權限時重定向到登陸頁或者拋出異常。

# permission_required(perm[, login_url=None, raise_exception=False]) @permission_required('blog.add_article') def post_article(request): pass

每一個模型默認擁有增(add), 改(change), 刪(delete)權限。在django.contrib.auth.models.Permission模型中保存了項目中全部權限。

該模型在數據庫中被保存爲auth_permission數據表。每條權限擁有id ,name , content_type_id, codename四個字段。

管理用戶權限

User和Permission經過多對多字段user.user_permissions關聯，在數據庫中由auth_user_user_permissions數據表維護。

• 添加權限: user.user_permissions.add(permission)

• 刪除權限: user.user_permissions.delete(permission)

• 清空權限: user.user_permissions.clear()

用戶擁有他所在用戶組的權限， 使用用戶組管理權限是一個更方便的方法。Group中包含多對多字段permissions， 在數據庫中由auth_group_permissions數據表維護。

• 添加權限: group.permissions.add(permission)

• 刪除權限: group.permissions.delete(permission)

• 清空權限: group.permissions.clear()

自定義權限

在定義Model時可使用Meta自定義權限:

class Discussion(models.Model): ... class Meta: permissions = ( ("create_discussion", "Can create a discussion"), ("reply_discussion", "Can reply discussion"), )

判斷用戶是否擁有自定義權限:

user.has_perm('blog.create_discussion')