轉自：原文出處

身份驗證模組是Django中提供的標準許可權管理系統，提供可以使用者身份認證，使用者組和許可權管理。

AUTH可以和管理模組配合使用，快速建立網站的管理系統。

在INSTALLED_APPS中新增 'django.contrib.auth' 使用該應用程式，身份驗證模組預設啟用。

使用者

使用者是AUTH模組中維護使用者資訊的關係模式（繼承了models.Model），資料庫中該表被命名為AUTH_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
)

使用者建表關聯時

from django.contrib.auth.models import User

建立使用者

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

建立使用者物件：

user.save()

在此，需要呼叫儲存（）方法才可將此新使用者儲存到資料庫中。

auth模組不儲存使用者密碼明文而是儲存一個雜湊值，比如迭代使用的Md5演算法。

認證使用者

使用authenticate模組，使用時，先匯入模組：

from django.contrib.auth import authenticate
 

使用關鍵字引數傳遞賬戶和憑據：

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

認證使用者的密碼是否有效，若有效則返回代表該使用者的使用者物件，若無效則返回無。

需要注意的是：方法該檢查不is_active標誌位。

修改使用者密碼

修改密碼是使用者的例項方法，該方法不驗證使用者身份：

user.set_password(new_password)

通常該方法需要和身份驗證配合使用：

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

登入

先匯入模組：

from django.contrib.auth import login

login to session中新增SESSION_KEY，便於對使用者進行跟蹤：

login(request, user)

login不進行認證，也不檢查is_active標誌位，一般和authenticate配合使用：

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

在auth/__init__.py中可以看到登入的原始碼。

退出登入

logout會移除request的使用者資訊，並重新整理會話：

from django.contrib.auth import logout

def logout_view(request):
    logout(request)

許可權判斷，只允許登入使用者訪問

@login_required修飾器修飾的檢視函式會先通過會話金鑰檢查是否登入，已登入使用者可以正常的執行操作，未登入使用者將被重定向到login_url指定的位置。若未指定login_url引數，則重定向到settings.LOGIN_URL。

from django.contrib.auth.decorators import login_required

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

組

django.contrib.auth.models.Group定義了使用者組的模型，每個使用者組擁有id和name兩個欄位，該模型在資料庫被對映為auth_group資料表。

使用者物件中有一個名為groups的多對多欄位，多對多關係由auth_user_groups資料表維護user_set。組物件可以通過反向查詢使用者組中的使用者。

我們可以通過建立刪除組物件來新增或刪除使用者組：

# 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()

允許

Django的auth系統提供了模型級的許可權控制，即可以檢查使用者是否對某個資料表擁有增（新增），改（更改），刪除（刪除）許可權。

auth系統無法提供物件級的許可權控制，即檢查使用者是否對資料表中某條記錄擁有增改刪的許可權。如果需要物件級許可權控制可以使用django-guardian。

假設在部落格系統中有一張文章資料表管理博文，auth可以檢查某個使用者是否擁有對所有博文的管理許可權，但無法檢查使用者對某一篇博文是否擁有管理許可權。

檢查使用者許可權

user.has_perm方法用於檢查使用者是否擁有操作某個模型的許可權：

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

上述語句檢查使用者是否擁有部落格這個app中文模型的新增許可權，若擁有許可權則返回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

每個模型預設擁有增（新增），改（更改），刪（刪除）許可權。在django.contrib.auth.models.Permission模型中儲存了專案中所有許可權。

模型該資料庫在中被儲存為auth_permission資料表。每條許可權擁有id ，name ，  content_type_id，  codename四個欄位。

管理使用者許可權

使用者和許可權多對多通過欄位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()

自定義許可權

在定義模式時可以使用元自定義許可權：

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

判斷使用者是否擁有自定義許可權：

user.has_perm('blog.create_discussion')