HOWTO · Django
Django 비밀번호 변경
이 설명을 통해 Django의 웹 페이지에 로그인한 후 사용자가 비밀번호를 변경할 수 있는 웹 페이지를 만드는 방법을 배웁니다.
이 페이지의 내용
Django에 내장된 PasswordChangeView를 사용하면 로그인한 사용자가 현재 계정의 비밀번호를 변경할 수 있습니다. 현재 비밀번호 없이 계정에 다시 접근하도록 돕는 비밀번호 재설정 절차와는 다릅니다. 아래 구현에서는 양식, 완료 페이지, URL 이름, 홈페이지 링크를 서로 연결합니다.
비밀번호 변경 뷰 설정하기
users/views.py에서 Django의 PasswordChangeView를 상속하고 양식 템플릿을 지정합니다. reverse_lazy를 사용해 success_url을 설정하면 URL 설정이 로드된 뒤 Django가 이름으로 목적지를 찾습니다. 완료 페이지에는 PasswordChangeDoneView를 사용합니다. PasswordResetDoneView는 비밀번호 재설정 절차에 쓰입니다.
이 독립형 설정 하네스는 Django 프로젝트 없이도 이름과 연결 관계를 살펴볼 수 있도록 Django를 작은 대역 객체로 대체합니다. 실제 프로젝트에서는 import문과 애플리케이션 정의를 유지하고 하네스 설정과 마지막 단언문은 생략하세요. Django의 비밀번호 변경 양식은 설정된 비밀번호 검증기를 사용해 제출된 현재 비밀번호와 새 비밀번호 확인값을 검증합니다.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
# Harness only: stand-ins let this configuration run without Django installed.
import sys
import types
django = types.ModuleType("django")
contrib = types.ModuleType("django.contrib")
auth = types.ModuleType("django.contrib.auth")
auth_views = types.ModuleType("django.contrib.auth.views")
urls = types.ModuleType("django.urls")
django.__path__ = []
contrib.__path__ = []
auth.__path__ = []
class View:
@classmethod
def as_view(cls):
return cls
class PasswordChangeView(View):
pass
class PasswordChangeDoneView(View):
pass
def reverse_lazy(name):
return name
def path(route, view, name=None):
return (route, view, name)
def include(module, namespace=None):
return (module, namespace)
auth_views.PasswordChangeView = PasswordChangeView
auth_views.PasswordChangeDoneView = PasswordChangeDoneView
urls.reverse_lazy = reverse_lazy
urls.path = path
urls.include = include
sys.modules.update({
"django": django,
"django.contrib": contrib,
"django.contrib.auth": auth,
"django.contrib.auth.views": auth_views,
"django.urls": urls,
})
users_views = types.ModuleType("users_views")
users_views.ChangePasswordView = None
users_views.ChangePasswordDoneView = None
sys.modules["users_views"] = users_views
# users/views.py
from django.contrib.auth.views import PasswordChangeDoneView, PasswordChangeView
from django.urls import reverse_lazy
class ChangePasswordView(PasswordChangeView):
template_name = "users/password-change.html"
success_url = reverse_lazy("users:password-change-done")
class ChangePasswordDoneView(PasswordChangeDoneView):
template_name = "users/password-change-done.html"
users_views.ChangePasswordView = ChangePasswordView
users_views.ChangePasswordDoneView = ChangePasswordDoneView
# users/urls.py
# In the project file, import these classes from .views.
from django.urls import path
from users_views import ChangePasswordDoneView, ChangePasswordView
app_name = "users"
urlpatterns = [
path("change-password/", ChangePasswordView.as_view(), name="password-change"),
path("change-password/done/", ChangePasswordDoneView.as_view(), name="password-change-done"),
]
# project urls.py
from django.urls import include, path
project_urlpatterns = [
path("users/", include("users.urls", namespace="users")),
]
assert ChangePasswordView.success_url == "users:password-change-done"
assert [route[2] for route in urlpatterns] == ["password-change", "password-change-done"]
assert project_urlpatterns[0][1] == ("users.urls", "users")
실제 프로젝트에서 앱 URL 파일은 from .views import ChangePasswordDoneView, ChangePasswordView로 뷰를 가져옵니다. 예제를 독립적으로 실행할 수 있도록 하네스에서는 users_views를 사용합니다. 프로젝트 URL 파일에서는 django.urls에서 include와 path를 가져오고, 하네스에 나온 것과 같은 path("users/", include("users.urls", namespace="users")) 설정을 사용하세요.
앱 및 프로젝트 URL 패턴 등록하기
위 하네스에는 두 단계의 URL 설정이 모두 포함되어 있습니다. 실제 프로젝트의 users/urls.py에는 app_name = "users"를 설정하고, 프로젝트 URL 설정에서는 해당 모듈을 namespace="users"로 포함합니다. 두 설정을 함께 사용하면 users:password-change-done을 이름으로 찾을 수 있습니다. 앱의 경로 이름과 reverse_lazy 목적지도 서로 일치해야 합니다.
비밀번호 변경 및 완료 템플릿 만들기
users/templates/users/password-change.html을 만들고 공통 base.html을 상속하게 하세요. 이 템플릿은 같은 URL로 POST 요청을 보내며, 양식 안에 {% csrf_token %}를 포함하고 {{ form.as_p }}로 현재 비밀번호와 새 비밀번호 입력란을 표시합니다. CSRF 토큰은 Django의 요청 위조 방어를 지원하지만, 인증이나 비밀번호 검증을 대신하지는 않습니다.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
{% extends 'base.html' %}
{% block title %}Change password{% endblock title %}
{% block content %}
<h1>Change your password</h1>
<form action="" method="post">
{% csrf_token %}
{{ form.as_p }}
<button type="submit">Change password</button>
</form>
{% endblock content %}
성공 응답을 위한 users/templates/users/password-change-done.html을 만드세요. 같은 기본 템플릿을 상속하고 비밀번호가 변경되었음을 알린 뒤 프로젝트의 home-view 경로로 돌아가는 링크를 추가합니다. POST 요청이 성공하면 이 페이지로 리디렉션됩니다. 이 페이지를 표시하는 것만으로 비밀번호가 변경되는 것은 아닙니다.
{% extends 'base.html' %}
{% block title %}Password changed{% endblock title %}
{% block content %}
<h1>Your password has been changed</h1>
<a href="{% url 'home-view' %}">Home page</a>
{% endblock content %}
홈페이지에서 링크 추가하기
홈 템플릿에서 {% url 'users:password-change' %}로 양식 링크를 추가하세요. Django에 내장된 비밀번호 변경 뷰는 로그인한 사용자를 요구하므로, 로그인 상태에서만 보이는 탐색 메뉴에 링크를 두거나 로그인하지 않은 방문자를 뷰가 리디렉션하도록 하세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
<a href="{% url 'users:password-change' %}">Change password</a>
비밀번호 변경 절차 실행 및 확인하기
프로젝트의 일반적인 개발 환경을 실행하고 테스트 계정으로 로그인한 다음 새 홈페이지 링크를 따라가세요. 현재 비밀번호와 서로 일치하는 유효한 새 비밀번호를 입력해 제출합니다. Django가 완료 페이지로 리디렉션하는지 확인한 뒤 로그아웃하고 새 비밀번호로 다시 로그인하세요. 이는 수동 확인 절차이며, 이 문서의 환경에서 실제로 절차를 실행했다는 보고는 아닙니다.
간단한 경로 이름 확인 예제는 네임스페이스와 경로의 관계를 보여 줍니다.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
app_name = "users"
route_name = "password-change-done"
success_target = f"{app_name}:{route_name}"
print(success_target)
흔한 설정 오류 해결하기
Django가 users:password-change-done을 역참조할 수 없다고 알리면 app_name, 프로젝트 URL 포함 설정의 네임스페이스, 경로의 name, reverse_lazy 목적지가 서로 일치하는지 확인하세요. TemplateDoesNotExist 오류는 대개 뷰에 지정한 템플릿 경로와 앱의 templates/users/ 디렉터리 아래 실제 위치가 다를 때 발생합니다. 철자를 확인하고 앱이 설치되어 Django가 템플릿을 찾을 수 있는지도 살펴보세요.
양식에서 CSRF 오류가 발생하면 POST 양식 안에 {% csrf_token %}를 넣고, Django의 일반적인 요청 흐름을 통해 페이지를 제출하는지 확인하세요. 방문자가 로그인 페이지로 리디렉션되는 것은 로그인한 사용자를 위한 기능에서 예상되는 동작입니다. 비밀번호 변경을 시험하기 전에 로그인하세요. 비밀번호가 바뀌지 않았는데 완료 페이지가 표시된다면 양식이 해당 뷰로 요청을 보내는지, 제출한 현재 비밀번호와 새 비밀번호 확인값이 프로젝트의 검증 조건을 충족하는지 확인하세요.