Herramienta universal de HTTP de Django - 'django.utils.http'

Este es el momento donde este módulo realmente brilla.

La codificación Base64 común incluye caracteres especiales como + o /. Estos caracteres tienen significados especiales en las URLs (espacios, delimitadores de ruta, etc.), lo que puede causar problemas al transmitir valores a través de URLs.

urlsafe_base64_encode reemplaza estos caracteres por - y _, que son seguros para usar en URLs.

Usos principales:

• Tokens de autenticación para registro basado en correo electrónico
• Codificación del ID de usuario (pk) en enlaces de restablecimiento de contraseña

Ejemplo: (Generación de enlace de restablecimiento de contraseña)

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. Al crear el token (codificación)
user = User.objects.get(username='testuser')
# Importante: siempre hay que convertir a bytes antes de codificar.
uid_bytes = force_bytes(user.pk)
uid_token = urlsafe_base64_encode(uid_bytes)

print(f"Token codificado: {uid_token}")
# Ej: 'Mg' (suponiendo que user.pk es 2)
# reset_url = f"/password-reset/{uid_token}/..."


# 2. Cuando el usuario hace clic en el enlace (decodificación)
try:
    # Decodificación del token recibido en la URL a bytes
    uid_bytes_decoded = urlsafe_base64_decode(uid_token)
    # Convertir de nuevo a cadena (o entero)
    user_pk = force_str(uid_bytes_decoded)
    user = User.objects.get(pk=user_pk)
    print(f"PK restaurada: {user.pk}")
except (TypeError, ValueError, OverflowError, User.DoesNotExist):
    user = None

Nota: force_bytes y force_str pertenecen al módulo django.utils.encoding, y generalmente se utilizan junto con las funciones de urlsafe_base64.

2. Constructor de cadenas de consulta: urlencode

Convierte fácilmente un objeto diccionario (dict) de Python en una cadena de consulta utilizada en solicitudes HTTP GET (por ejemplo, ?key=value&key2=value2).

Ejemplo:

from django.utils.http import urlencode

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

# Se codifican las claves y los valores del diccionario en una cadena de consulta.
# Los espacios en 'django rest framework' se codifican de forma segura como '+' o '%20'.
query_string = urlencode(params)

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

3. Verificación de redirección segura: is_safe_url

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

def login_success_redirect(request):
    # Obtener el valor 'next' de los parámetros GET.
    next_url = request.GET.get('next')

    # 1. El valor next debe existir y
    # 2. solo entonces se redirige a esa URL después de pasar la verificación is_safe_url.
    if next_url and is_safe_url(
        url=next_url,
        allowed_hosts={request.get_host()},  # Solo se permite el host de la solicitud actual
        require_https=request.is_secure()   # Si la solicitud es HTTPS, la redirección también debe ser HTTPS
    ):
        return redirect(next_url)

    # Si no es seguro o el valor 'next' no existe, redirigimos a la página principal.
    return redirect(resolve_url('main-dashboard'))