Django的自帶認證系統——auth模塊

Django自帶的用戶認證

auth模塊

from django.contrib import auth

備註：使用auth模塊時，咱們默認使用Django提供的auth_user表，建立數據時，可使用命令行來建立超級用戶：

命令行：在項目的根目錄下輸入：python manage.py createsuperuser   回車提示輸入用戶名：輸入用戶名後，回車，輸入郵箱地址，能夠不填，繼續回車，輸入密碼：輸入密碼時，密碼必須是數字和字母組成，而且不能少於八位，不然會報錯，其餘的信息能夠不填。

django.contrib.auth中提供了許多方法，這裏主要介紹其中的三個：

authenticate()   

提供了用戶認證，即驗證用戶名以及密碼是否正確,通常須要username  password兩個關鍵字參數

若是認證信息有效，會返回一個  User  對象。authenticate()會在User 對象上設置一個屬性來標識後端已經認證了該用戶，且該信息在後續的登陸過程當中是須要的。

當咱們試圖登錄一個從數據庫中直接取出來不通過authenticate()的User對象時會報錯！！！

user = authenticate(username='theuser',password='thepassword')

login(HttpRequest, user)　　

該函數接受一個HttpRequest對象，以及一個認證了的User對象

備註：auth.login方法將校驗經過的用戶封裝到request中，這樣在request的生命週期咱們均可以使用request.user獲得這個用戶的對象，不論是在視圖函數仍是在模板語言中均可以使用request.user 而後在  .字段屬性  來取到須要的內容。

此函數使用django的session框架給某個已認證的用戶附加上session id等信息。

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 'invalid login' error message. ...

logout(request) 註銷用戶　

from django.contrib.auth import logout def logout_view(request): logout(request) # Redirect to a success page.

該函數接受一個HttpRequest對象，無返回值。當調用該函數時，當前請求的session信息會所有清除。該用戶即便沒有登陸，使用該函數也不會報錯。

　　備註：註銷用戶後，直接訪問這個路徑，還能夠登陸，可是咱們能夠print(request.user)，當用戶經過校驗登陸時，獲得的是一個具體的用戶對象，當註銷時，再次訪問時，就會輸出AnonymousUser（是一個類 <class 'django.utils.functional.SimpleLazyObject'>），意爲匿名用戶，能夠經過這個處理一些判斷。

user對象的 is_authenticated()

要求：

1  用戶登錄後才能訪問某些頁面，

2  若是用戶沒有登陸就訪問該頁面的話直接跳到登陸頁面

3  用戶在跳轉的登錄界面中完成登錄後，自動訪問跳轉到以前訪問的地址

方法1:

def my_view(request): if not request.user.is_authenticated(): return redirect('%s?next=%s' % (settings.LOGIN_URL, request.path))

方法2:

django已經爲咱們設計好了一個用於此種狀況的裝飾器：login_required()

from django.contrib.auth.decorators import login_required @login_required def my_view(request): ...

若用戶沒有登陸，則會跳轉到django默認的 登陸URL '/accounts/login/ ' (這個值能夠在settings.py文件中經過LOGIN_URL進行修改)。並傳遞  當前訪問url的絕對路徑 (登錄成功後，會重定向到該路徑)。

User對象

User 對象屬性：username， password（必填項）password用哈希算法保存到數據庫

is_staff ： 用戶是否擁有網站的管理權限.

is_active ： 是否容許用戶登陸, 設置爲``False``，能夠不用刪除用戶來禁止 用戶登陸

is_authenticated()

若是是真正的 User 對象，返回值恆爲 True 。 用於檢查用戶是否已經經過了認證。
經過認證並不意味着用戶擁有任何權限，這個方法甚至也不檢查該用戶是否處於激活狀態，只是代表用戶成功的經過了認證。

這個方法很重要, 在後臺用request.user.is_authenticated()判斷用戶是否已經登陸，若是true則能夠向前臺展現request.user.name

建立用戶

使用 create_user 輔助函數建立用戶:

from django.contrib.auth.models import User #表明數據庫中Django自帶建立的auth_user這張表
user = User.objects.create_superuser(username='',password='') #這是建立超級用戶的方法（備註：密碼有限制） user = User.objects.create_user（username='',password='',email=''） #這個是建立普通用戶的方法

check_password(passwd)

用戶須要修改密碼的時候，首先要讓其輸入原來的密碼 ，若是給定的值經過了密碼檢查，返回 True

備註：用戶修改密碼時，確定是已經登陸的狀態，因此，此時，校驗密碼時，咱們能夠取得用戶輸入的原密碼，經過這個user_obj ，咱們能夠直接user_obj.check_password(原密碼)來獲得一個校驗的結果True或False。而後根據這個狀態咱們在進行下一步的操做，即修改密碼。在使用這個對象 .set_password(新密碼=‘XX’)，值得注意的時，修改完密碼後，必定要保存  .save() 方法。

 

修改密碼

使用 set_password() 來修改密碼

user = User.objects.get(username='') user.set_password(password='') user.save()

字段的擴展

　　咱們在使用Django自帶的auth_user表時，他提供的字段是有限的，咱們若是有其餘的字段需求，就須要擴展這張表。

　　方式有兩種：

　　一，使用ORM中OneToOne進行關聯，建立一張表，關聯這張auth_user 這張表。

#app下的models.py中

#導入這張Django內置的表
from django.contrib.auth.models import User

class UserDetail(models.Model):
    mobile = models.CharFiled(max_length=11)
    user = models.OneToOneFiled(to=User)   #切記，此處的User不須要加「」雙引號，由於User是從其餘文件中導入的，
　　　　　　　　　　　　這個User這是代指這張表。加引號的話，系統會從當前加載的整個py文件中反射的去找。顯然找不到。

　　二，繼承的方式 （推薦使用這種用法）

from django.contrib.auth.models import AbstractUser

class UserInfo(AbstractUser):
    mobile = models.CharFiled(max_length=11)

備註：使用繼承的方式建立新表時，至關於咱們對內置的auth_user表進行了覆蓋，這是咱們要在settings.py文件中指定一個參數：AUTH_USER_MODEL = "APP的名字.繼承AbstractUser的類的類名"  ，來告訴Django默認用戶認證時使用哪張表。

使用繼承的方式代替auth_user 表，咱們任然可使用全部的auth方法，建立用戶時，變成 models.UserInfo.objects.create_user()這個用法了。

簡單示例

def sign_up(request):
 
    state = None
    if request.method == 'POST':
 
        password = request.POST.get('password', '')
        repeat_password = request.POST.get('repeat_password', '')
        email=request.POST.get('email', '')
        username = request.POST.get('username', '')
        if User.objects.filter(username=username):
                state = 'user_exist'
        else:
                new_user = User.objects.create_user(username=username, password=password,email=email)
                new_user.save()
 
                return redirect('/book/')
    content = {
        'state': state,
        'user': None,
    }
    return render(request, 'sign_up.html', content)　

註冊示例代碼

 

@login_required
def set_password(request):
    user = request.user
    state = None
    if request.method == 'POST':
        old_password = request.POST.get('old_password', '')
        new_password = request.POST.get('new_password', '')
        repeat_password = request.POST.get('repeat_password', '')
        if user.check_password(old_password):
            if not new_password:
                state = 'empty'
            elif new_password != repeat_password:
                state = 'repeat_error'
            else:
                user.set_password(new_password)
                user.save()
                return redirect("/log_in/")
        else:
            state = 'password_error'
    content = {
        'user': user,
        'state': state,
    }
    return render(request, 'set_password.html', content)

修改密碼示例