用戶身份驗證和管理是啟動新項目時的基本功能。由于這些任務(wù)經(jīng)常重復(fù)，因此開發(fā)了各種軟件包來簡化流程，使開發(fā)人員能夠?qū)Ｗ⒂陧椖康钠渌矫妗?Djoser 就是這樣的一個包，它與 Django REST Framework (DRF) 無縫集成來處理身份驗證和用戶管理。在本指南中，我將引導(dǎo)您使用 Djoser 構(gòu)建完整的用戶身份驗證系統(tǒng)，包括設(shè)置電子郵件功能和自定義電子郵件模板。

設(shè)置項目

首先為您的項目創(chuàng)建一個目錄：

mkdir userauth

導(dǎo)航到您首選 IDE 中的新目錄，設(shè)置虛擬環(huán)境并激活它

python venv .venv
source .venv/bin/activate

接下來，安裝必要的軟件包：

pip install django djangorestframework djoser djangorestframework_simplejwt social-auth-app-django drf-yasg

注意：一些依賴項，例如social-auth-app-django，可能會隨Djoser 自動安裝。如果是這樣，您可以跳過顯式添加它們

安裝后，生成一個requirements.txt 文件來跟蹤您的依賴項：

pip freeze > requirements.txt

您應(yīng)該會看到requirements.txt 文件中列出的所有已安裝的軟件包，包括所有依賴項。

創(chuàng)建 Django 項目并讓服務(wù)器運(yùn)行

django-admin startapp userauth . 

這將創(chuàng)建 django 項目。然后我們需要在項目中創(chuàng)建一個應(yīng)用程序

python manage.py startapp accounts

您的項目目錄現(xiàn)在應(yīng)包含以下內(nèi)容：

• .venv（虛擬環(huán)境）

• 帳戶/（身份驗證應(yīng)用程序）

• userauth/（主項目文件夾）

• manage.py

• 需求.txt

配置項目

將所需的軟件包和應(yīng)用程序添加到settings.py中的INSTALLED_APPS部分：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

     # Third Party Apps
    'rest_framework',
    'djoser',
    'rest_framework_simplejwt',
    'drf_yasg',

    # Local Apps
    'accounts',
]

更新您的 settings.py 以包含 Django REST Framework 和 SimpleJWT 的配置：

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'rest_framework_simplejwt.authentication.JWTAuthentication',
    ),
}

讓我們創(chuàng)建自定義用戶模型
在accounts文件夾中創(chuàng)建managers.py文件
賬戶/managers.py

from django.contrib.auth.models import BaseUserManager


class CustomUserManager(BaseUserManager):

    def create_user(self, email, username, password=None, **extra_fields) -> None:

        if not username:
            raise ValueError("Username is required")

        if not email:
            raise ValueError("Email is required")


        email = self.normalize_email(email)
        user = self.model(email=email, username=username, **extra_fields)
        user.set_password(password)
        user.save()
        return user


    def create_superuser(self, email, username, password, **extra_fields):
        """
        Create and save a SuperUser with the given email and password.
        """
        extra_fields.setdefault("is_staff", True)
        extra_fields.setdefault("is_superuser", True)
        extra_fields.setdefault("is_active", True)

        if extra_fields.get("is_staff") is not True:
            raise ValueError("Superuser must have is_staff=True.")

        if extra_fields.get("is_superuser") is not True:
            raise ValueError("Superuser must have is_superuser=True.")

        return self.create_user(email, username, password, **extra_fields)

賬戶/models.py

from django.db import models
from django.contrib.auth.models import AbstractUser
from accounts.managers import CustomUserManager



class CustomUser(AbstractUser):
    username = None
    email = models.EmailField(unique=True)
    is_verified = models.BooleanField(default=False)


    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = []

    objects = CustomUserManager()


    def __str__(self):
        return self.email

將此行添加到您的settings.py 文件中

AUTH_USER_MODEL = 'accounts.CustomUser'

我們可以繼續(xù)進(jìn)行遷移，然后運(yùn)行本地開發(fā)服務(wù)器

python manage.py makemigrations
python manage.py migrate
python manage.py runserver

到目前為止應(yīng)該沒有問題。

配置 Djoser URL

在項目的 URL 模式中包含 Djoser 提供的 URL，以及 API 文檔的 Swagger：

userauth/urls.py

from django.contrib import admin
from django.urls import include, path
from rest_framework import permissions
from drf_yasg.views import get_schema_view
from drf_yasg import openapi


schema_view = get_schema_view(
    openapi.Info(
        title="User Accounts API",
        default_version="v1",
        description="REST implementation of Django authentication system using Djoser",
        contact=openapi.Contact(email="contact@snippets.local"),
        license=openapi.License(name="BSD License"),
    ),
    public=True,
    permission_classes=(permissions.AllowAny,),
)

urlpatterns = [
    path('admin/', admin.site.urls),
    path('api/docs', schema_view.with_ui("swagger", cache_timeout=0), name="swagger-ui"),
    path('api/', include('djoser.urls')), 
    path('api/', include('djoser.urls.jwt'))
]

通過瀏覽器訪問http://127.0.0.1:8000/api/docs/查看API文檔。

配置 Djoser 設(shè)置

可以為 djoser 配置的所有設(shè)置都可以在此處找到 Djoser 設(shè)置

userauth/settings.py

mkdir userauth

這里我們要求用戶接收激活電子郵件。激活 URL 是發(fā)送到用戶電子郵件以供用戶點(diǎn)擊的鏈接。需要提取令牌和 uid，并將發(fā)布請求作為正文發(fā)送到項目中的激活路由

配置電子郵件發(fā)送

最后我們需要配置電子郵件發(fā)送。我將使用 mailtrap 發(fā)送電子郵件。您可以選擇將電子郵件發(fā)送到控制臺或您選擇的任何電子郵件服務(wù)。

用于將電子郵件發(fā)送到您的控制臺

python venv .venv
source .venv/bin/activate

使用外部郵件服務(wù)

pip install django djangorestframework djoser djangorestframework_simplejwt social-auth-app-django drf-yasg

用正確的憑據(jù)替換占位符

為了測試這一點(diǎn)，我們將使用郵遞員來測試它。

創(chuàng)建新用戶

然后發(fā)送給用戶的激活郵件

自定義電子郵件模板

讓我們稍微自定義一下電子郵件模板
在accounts目錄中創(chuàng)建一個模板文件夾，然后創(chuàng)建一個電子郵件文件夾并繼續(xù)在其中創(chuàng)建模板文件夾

帳戶/模板/電子郵件/activation_email.py
我們自定義了djoser自帶的默認(rèn)郵箱

pip freeze > requirements.txt

要在模板中自定義站點(diǎn)名稱，請將此行添加到 djoser 設(shè)置

django-admin startapp userauth . 

電子郵件模板現(xiàn)在看起來像這樣

擴(kuò)展激活視圖

在本文的最后一部分，我們將進(jìn)行電子郵件驗證。
我們首先在accounts/views.py中自定義激活視圖：

帳戶/views.py

python manage.py startapp accounts

我們正在擴(kuò)展 djoser 上的激活視圖以對其進(jìn)行自定義，并將用戶模型上的 is_verified 字段設(shè)置為 true

accounts/urls.py

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',

     # Third Party Apps
    'rest_framework',
    'djoser',
    'rest_framework_simplejwt',
    'drf_yasg',

    # Local Apps
    'accounts',
]

項目級別的 URL 文件
userauth/urls.py

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'rest_framework_simplejwt.authentication.JWTAuthentication',
    ),
}

要測試此功能，請創(chuàng)建一個新的測試用戶，然后單擊發(fā)送到電子郵件的激活網(wǎng)址。
您到達(dá)此頁面是因為該網(wǎng)址在我們的項目中不存在

從 url 中提取 uid 和 token，并向您在accounts/urls.py 文件中定義的激活路由發(fā)出發(fā)布請求

從截圖來看，我的路線是；

mkdir userauth

uid 是 MTY
代幣為 cil456-aaf8331efb885f0b4412f35ce544648c

使用參數(shù)向激活端點(diǎn)發(fā)出 POST 請求

使用 Djoser 設(shè)置用戶身份驗證的教程到此結(jié)束。您現(xiàn)在擁有一個具有電子郵件激活和可自定義模板的功能身份驗證系統(tǒng)。在本系列的第二部分中，我們將探討社交身份驗證，使用戶能夠使用 Google、Facebook 和 GitHub 等第三方服務(wù)進(jìn)行注冊和登錄。更多精彩敬請期待！

如果您有任何問題或反饋，請隨時發(fā)表評論。

以上是使用 Django、Djoser 和 JWT 進(jìn)行用戶身份驗證的分步指南：第一部分的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！