Django中的auth模塊

1、Django自帶的用戶認證-auth模塊

---

 

　　1.auth模塊簡介

　　網站開發過程當中，咱們須要設計實現網站的用戶系統。此時咱們須要實現包括用戶註冊、用戶登陸、用戶認證、註銷、修改密碼等功能。Flask框架中咱們須要手動的建立User模型，而後逐步實現驗證方法，但Django框架內置了強大的用戶認證系統--auth，它默認使用 auth_user 表來存儲用戶數據。auth模塊是對登陸認證方法的一種封裝，以前咱們獲取用戶輸入的用戶名及密碼後須要本身從user表裏查詢有沒有用戶名和密碼符合的對象，而有了auth模塊以後就能夠很輕鬆的去驗證用戶的登陸信息是否存在於數據庫中。除此以外，auth還對session作了一些封裝，方便咱們校驗用戶是否已登陸。若是須要個性化的User模型，你本身的模型只須要繼承User類，就能夠實現auth同樣的驗證方法。

      2.auth裏的經常使用方法

　　若是想使用auth模塊的方法，必需要先導入auth模塊 

from django.contrib import auth

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

　　      1 、authenticate()  

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

　　　　若是認證信息有效，會返回一個  User  對象。authenticate()會在User 對象上設置一個屬性標識那種認證後端認證了該用戶，且該信息在後面的登陸過程當中是須要的。當咱們試圖登錄一個從數據庫中直接取出來不通過authenticate()的User對象會報錯的.

user = authenticate(username='someone',password='somepassword')

　      　2 、login(HttpRequest, user)

　　　　該函數接受一個HttpRequest對象，以及一個認證了的User對象，此函數會使用django的session框架給某個已認證的用戶附加上session id等信息。

 1 from django.contrib.auth import authenticate, login
 2    
 3 def my_view(request):
 4   username = request.POST['username']
 5   password = request.POST['password']
 6   user = authenticate(username=username, password=password)
 7   if user is not None:
 8     login(request, user)
 9     # Redirect to a success page.
10     ...
11   else:
12     # Return an 'invalid login' error message.
13     ...

 

          3 、logout(request) 註銷用戶

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

1 from django.contrib.auth import logout
2    
3 def logout_view(request):
4   logout(request)
5  # Redirect to a success page.

         4 、user對象的 is_authenticated()

             要求：

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

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

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

                       方法1:   直接用auth的is_authenticated()方法驗證

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

　　                方法2:  根據request.user.username來驗證，若是爲空，則說明沒有登陸

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

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

1 from django.contrib.auth.decorators import login_required
2     
3 @login_required
4 def my_view(request):
5      pass

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

    3. user對象

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

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

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

    四、is_authenticated()

               若是是真正的 User 對象，返回值恆爲 True 。 用於檢查用戶是否已經經過了認證。

             經過認證並不意味着用戶擁有任何權限，甚至也不檢查該用戶是否處於激活狀態，這只是代表用戶成功的經過了認證。 這個方法很重要, 在後臺用request.user.is_authenticated()判斷用戶是否已經登陸，若是true則能夠向前臺展現request.user.name

    5 、建立用戶

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

from django.contrib.auth.models import User
user = User.objects.create_user（username='',password='',email=''）

    6 、check_password(passwd)    檢驗密碼

user = User.objects.get(username=' ')
if user.check_password(passwd):
  pass

用戶須要修改密碼的時候 首先要讓他輸入原來的密碼 ，若是給定的字符串經過了密碼檢查，返回  True 使用 set_password() 來修改密碼

user = User.objects.get(username='')
password = request.Post.get('password')
 if user.check_password(password):
    user.set_password(password=''):
    user.save　
else: 
    return HttpResponse('密碼錯誤')

  七、註冊

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)

   本身建立User表

              須要注意的是，以上的全部操做，都是針對django自動建立的auth_user表的，咱們能夠看一下這張表的結

這是django給咱們自動建立的一張user表，而若是要用auth模塊，就必需要使用（或繼承）這張表。

繼承表的好處是咱們能夠增長一些本身須要的字段，而且同時可使用auth模塊提供的接口、方法

下面就講一下繼承auth的方法：

          一、導入AbstractUser類，而且寫一個自定義的類，繼承AbstractUser類，以下：

from django.contrib.auth.models import AbstractUser
 
class UserInfo(AbstractUser):
  """
  用戶信息
  """
  nid = models.AutoField(primary_key=True)
  telephone = models.CharField(max_length=11, null=True, unique=True)

須要注意的是，UserInfo表裏就不須要有auth_user裏重複的字段了，好比說username以及password等，可是仍是能夠直接使用這些字段的，而且django會自動將password進行加密

         二、這樣寫完以後，還須要在setting.py文件裏配置：

AUTH_USER_MODEL = 'myapp.UserInfo

這樣，django就知道從myapp項目下的models去查找UserInfo這張表了