Django, Djoser 및 JWT를 사용한 사용자 인증에 대한 단계별 가이드: 1부

새 프로젝트를 시작할 때 사용자 인증 및 관리는 기본 기능입니다. 이러한 작업은 자주 반복되므로 프로세스를 간소화하기 위해 다양한 패키지가 개발되어 개발자가 프로젝트의 다른 측면에 집중할 수 있습니다. 그러한 패키지 중 하나는 Django REST Framework(DRF)와 원활하게 통합되어 인증 및 사용자 관리를 처리하는 Djoser입니다. 이 가이드에서는 이메일 기능 및 사용자 정의 이메일 템플릿 설정을 포함하여 Djoser를 사용하여 전체 사용자 인증 시스템을 구축하는 과정을 안내하겠습니다.

프로젝트 설정

프로젝트용 디렉토리를 만드는 것부터 시작하세요.

mkdir userauth

원하는 IDE에서 새 디렉토리로 이동하여 가상 환경을 설정하고 활성화하세요

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와 함께 자동으로 설치될 수 있습니다. 그렇다면 명시적으로 추가하는 것을 건너뛸 수 있습니다

설치한 후에는 요구사항.txt 파일을 생성하여 종속성을 추적하세요.

pip freeze > requirements.txt

모든 종속성을 포함하여 요구사항.txt 파일에 나열된 설치된 모든 패키지가 표시되어야 합니다.

Django 프로젝트 생성 및 서버 실행

django-admin startapp userauth . 

이렇게 하면 django 프로젝트가 생성됩니다. 그런 다음 프로젝트 내에 앱을 만들어야 합니다

python manage.py startapp accounts

이제 프로젝트 디렉토리에는 다음이 포함되어야 합니다.

• .venv(가상환경)

• 계정/(인증앱)

• userauth/(메인 프로젝트 폴더)

• manage.py

• requirements.txt

프로젝트 구성

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',
]

Django REST Framework 및 SimpleJWT에 대한 구성을 포함하도록 settings.py를 업데이트하세요.

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

다음부터 사용자 정의 사용자 모델을 만들어 보겠습니다
계정 폴더에 presents.py 파일을 생성하세요
account/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)

accounts/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'

마이그레이션을 진행한 다음 로컬 개발 서버를 실행할 수 있습니다

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

현재까지는 문제가 없을 것입니다.

Djoser URL 구성

API 문서용 Swagger와 함께 Djoser가 프로젝트의 URL 패턴에 제공하는 URL을 포함하세요.

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'))
]

API 문서를 보려면 브라우저에서 http://127.0.0.1:8000/api/docs/로 이동하세요.

Djoser 설정 구성

djoser에 대해 구성할 수 있는 모든 설정은 여기에서 찾을 수 있습니다. Djoser 설정

userauth/settings.py

mkdir userauth

여기서 사용자는 활성화 이메일을 받아야 합니다. 활성화 URL은 사용자가 클릭할 수 있도록 사용자의 이메일로 전송되는 링크입니다. 토큰과 uid를 추출하고 게시물 요청을 프로젝트의 활성화 경로에 대한 본문으로 보내야 합니다

이메일 전송 구성

마지막으로 이메일 전송을 구성해야 합니다. 이메일 전송을 위해 mailtrap을 사용할 예정입니다. 콘솔이나 선택한 이메일 서비스로 이메일을 보내도록 선택할 수 있습니다.

콘솔로 이메일 보내기

python venv .venv
source .venv/bin/activate

외부 메일 서비스 이용하기

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

자리 표시자를 올바른 자격 증명으로 바꾸세요

이를 테스트하기 위해 Postman을 사용하여 테스트하겠습니다.

새 사용자 만들기

그러면 사용자에게 활성화 이메일이 전송됩니다

이메일 템플릿 사용자 정의

이메일 템플릿을 약간 맞춤설정해 보겠습니다
계정 디렉토리에 템플릿 폴더를 생성한 다음 이메일 폴더를 생성하고 거기에 템플릿 폴더를 생성하세요

계정/템플릿/이메일/activation_email.py
djoser와 함께 제공되는 기본 이메일을 사용자 정의합니다

pip freeze > requirements.txt

템플릿에서 사이트 이름을 맞춤 설정하려면 djoser 설정에 다음 줄을 추가하세요

django-admin startapp userauth . 

현재 이메일 템플릿은 다음과 같습니다.

활성화 보기 확장

이 글의 마지막 부분에서는 이메일 확인 작업을 진행하겠습니다.
account/views.py에서 활성화 보기를 사용자 정의하는 것부터 시작합니다:

accounts/views.py

python manage.py startapp accounts

djoser의 활성화 보기를 확장하여 사용자 정의하고 사용자 모델의 is_verified 필드를 true로 설정합니다

계정/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',
    ),
}

이를 테스트하려면 새 테스트 사용자를 생성하고 이메일로 전송된 활성화 URL을 클릭하세요.
우리 프로젝트에 URL이 존재하지 않기 때문에 이 페이지로 이동하게 됩니다

URL에서 uid와 토큰을 추출하고 account/urls.py 파일에 정의한 활성화 경로에 게시물 요청을 보냅니다

스크린샷에서 제 경로는 ;

mkdir userauth

UID는 MTY입니다
토큰은 cil456-aaf8331efb885f0b4412f35ce544648c입니다

매개변수를 사용하여 활성화 엔드포인트에 게시 요청하기

이것으로 Djoser를 사용한 사용자 인증 설정 튜토리얼을 마칩니다. 이제 이메일 활성화 및 사용자 정의 가능한 템플릿을 갖춘 기능적 인증 시스템이 있습니다. 이 시리즈의 두 번째 부분에서는 사용자가 Google, Facebook, GitHub와 같은 타사 서비스를 사용하여 가입하고 로그인할 수 있도록 하는 소셜 인증에 대해 알아봅니다. 앞으로도 계속 지켜봐주세요!

질문이나 의견이 있으시면 언제든지 댓글을 남겨주세요.

위 내용은 Django, Djoser 및 JWT를 사용한 사용자 인증에 대한 단계별 가이드: 1부의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!