Django의 HTTP 만능도구 - 'django.utils.http'

이 모듈이 가장 빛을 발하는 순간입니다.

일반적인 Base64 인코딩은 +나 / 같은 특수 문자를 포함합니다. 이 문자들은 URL에서 특별한 의미(공백, 경로 구분 등)를 가지기 때문에 URL을 통해 값을 전달할 때 문제를 일으킬 수 있습니다.

urlsafe_base64_encode는 이 문자들을 URL에서 안전하게 사용할 수 있는 -와 _로 대체하여 인코딩합니다.

주요 사용처:

• 이메일 기반 회원가입 인증 토큰
• 비밀번호 재설정 링크의 사용자 ID(pk) 인코딩

예제: (비밀번호 재설정 링크 생성)

from django.utils.http import urlsafe_base64_encode, urlsafe_base64_decode
from django.utils.encoding import force_bytes, force_str
from django.contrib.auth.models import User

# 1. 토큰 생성 시 (인코딩)
user = User.objects.get(username='testuser')
# 중요: 인코딩 전에는 항상 bytes로 변환해야 합니다.
uid_bytes = force_bytes(user.pk)
uid_token = urlsafe_base64_encode(uid_bytes)

print(f"인코딩된 토큰: {uid_token}")
# 예: 'Mg' (user.pk가 2라고 가정)
# reset_url = f"/password-reset/{uid_token}/..."


# 2. 사용자가 링크를 클릭했을 때 (디코딩)
try:
    # URL로 받은 토큰을 다시 bytes로 디코딩
    uid_bytes_decoded = urlsafe_base64_decode(uid_token)
    # 다시 문자열(혹은 정수)로 변환
    user_pk = force_str(uid_bytes_decoded)
    user = User.objects.get(pk=user_pk)
    print(f"복원된 PK: {user.pk}")
except (TypeError, ValueError, OverflowError, User.DoesNotExist):
    user = None

참고: force_bytes와 force_str는 django.utils.encoding 모듈에 있으며, urlsafe_base64 함수들과 거의 항상 함께 사용됩니다.

2. 쿼리 문자열 빌더: urlencode

파이썬 딕셔너리(dict) 객체를 HTTP GET 요청에 사용되는 쿼리 문자열(예: ?key=value&key2=value2)로 손쉽게 변환해 줍니다.

예제:

from django.utils.http import urlencode

params = {
    'page': 3,
    'q': 'django rest framework',
    'region': 'ja'
}

# 딕셔너리의 키와 값을 URL 인코딩하여 쿼리 문자열로 만듭니다.
# 'django rest framework'의 공백은 '+' 또는 '%20'으로 안전하게 인코딩됩니다.
query_string = urlencode(params)

print(query_string)
# 결과: 'page=3&q=django+rest+framework&region=ko'

3. 안전한 리디렉션 확인: is_safe_url

from django.utils.http import is_safe_url
from django.shortcuts import redirect, resolve_url

def login_success_redirect(request):
    # GET 파라미터에서 'next' 값을 가져옵니다.
    next_url = request.GET.get('next')

    # 1. next 값이 존재하고
    # 2. is_safe_url 검사를 통과해야만 해당 URL로 리디렉션합니다.
    if next_url and is_safe_url(
        url=next_url,
        allowed_hosts={request.get_host()},  # 현재 요청의 호스트만 허용
        require_https=request.is_secure()   # 현재 요청이 HTTPS면 리디렉션도 HTTPS여야 함
    ):
        return redirect(next_url)

    # 안전하지 않거나 'next' 값이 없으면 기본 페이지로 보냅니다.
    return redirect(resolve_url('main-dashboard'))