Django API 호출 제한 및 파일 목록 관리 시스템의 Throttling 구현

내부 망이나 외부 망에 관계없이 API 호출에 대한 적절한 제한을 두는 것은 서비스의 안정성과 보안을 위해 필수적입니다. 특히 파일 업로드나 목록 조회와 같이 리소스 소모가 큰 작업은 특정 사용자나 IP로부터의 과도한 요청을 방지해야 합니다. 이번 글에서는 Django의 캐시 시스템과 데코레이터를 활용하여 요청 제한(Rate Limiting) 기능을 구현하는 방법을 살펴보겠습니다.

1. 클라이언트 IP 기반의 요청 제한

Django의 내장 캐시 시스템을 사용하여 IP별로 접근 횟수를 제어할 수 있습니다. 특정 IP가 분당 설정된 횟수(예: 10회)를 초과하여 접근할 경우 403 Forbidden 응답을 반환하도록 설계합니다.

from django.core.cache import cache
from django.http import HttpResponseForbidden
from django.shortcuts import render
import logging
from datetime import datetime

logger = logging.getLogger(__name__)

def get_file_list(request):
    # 클라이언트의 실제 IP 주소 추출
    ip_addr = request.META.get('REMOTE_ADDR')
    
    # 캐시에 저장할 고유 키 생성
    throttling_key = f'limit:ip:{ip_addr}'
    request_hits = cache.get(throttling_key, 0)

    # 허용 횟수를 10회로 제한
    if request_hits >= 10:
        logger.warning(f"IP {ip_addr} - 과도한 요청 발생: {datetime.now()}")
        return HttpResponseForbidden("요청 횟수가 초과되었습니다. 잠시 후 다시 시도해주세요.")

    # 방문 횟수 증가 및 캐시 만료 시간(60초) 설정
    cache.set(throttling_key, request_hits + 1, 60)

    # 파일 목록 로직 처리 (예시)
    # files = FileModel.objects.all()
    return render(request, 'files/list.html', {'files': []})

2. 인증된 사용자별 요청 제한

IP 기반 제한 외에도 로그인을 마친 개별 사용자 계정을 기준으로 제한을 적용할 수 있습니다. 이는 공용 IP를 사용하는 환경에서 특정 사용자의 악의적인 호출을 차단할 때 유용합니다.

def user_aware_file_list(request):
    current_user = request.user
    
    # 익명 사용자가 아닌 경우 유저네임을 키로 사용
    if current_user.is_authenticated:
        user_id = current_user.username
    else:
        user_id = request.META.get('REMOTE_ADDR')

    storage_key = f'limit:user:{user_id}'
    current_hits = cache.get(storage_key, 0)

    if current_hits >= 10:
        logger.error(f"사용자 {user_id} - 호출 제한 도달")
        return HttpResponseForbidden("계정별 할당된 요청 횟수를 초과했습니다.")

    cache.set(storage_key, current_hits + 1, 60)

    # 비즈니스 로직 수행
    return render(request, 'files/list.html', {})

3. 커스텀 데코레이터를 이용한 기능 모듈화

여러 뷰 함수에 동일한 제한 로직을 적용하기 위해 데코레이터 형태로 기능을 분리하는 것이 관리 측면에서 효율적입니다. 데코레이터를 사용하면 코드 중복을 줄이고 선언적으로 제한 횟수를 지정할 수 있습니다.

from functools import wraps

def throttle_access(max_calls):
    def decorator(view_func):
        @wraps(view_func)
        def _wrapped_view(request, *args, **kwargs):
            identity = request.user.username if request.user.is_authenticated else request.META.get('REMOTE_ADDR')
            cache_id = f'throttle:{view_func.__name__}:{identity}'
            
            hits = cache.get(cache_id, 0)
            if hits >= max_calls:
                logger.error(f"제한 초과 - 사용자: {identity}, 함수: {view_func.__name__}")
                return HttpResponseForbidden("접근 제한 횟수를 초과하였습니다.")

            cache.set(cache_id, hits + 1, 60)
            return view_func(request, *args, **kwargs)
        return _wrapped_view
    return decorator

# 적용 예시
@throttle_access(max_calls=5)
def download_document(request, doc_id):
    # 파일 다운로드 로직
    pass

4. django-ratelimit 라이브러리 활용

직접 캐시 로직을 구현하는 대신 검증된 외부 라이브러리인 django-ratelimit를 사용하면 더욱 강력하고 유연한 제한 설정이 가능합니다. 이 라이브러리는 미들웨어와 데코레이터를 통해 정교한 Throttling 기능을 제공합니다.

먼저 패키지를 설치한 후 settings.py에 미들웨어를 등록하여 활성화할 수 있습니다.

# settings.py
INSTALLED_APPS = [
    # ...
    'ratelimit',
]

MIDDLEWARE = [
    # ...
    'ratelimit.middleware.RatelimitMiddleware',
]

# views.py
from ratelimit.decorators import ratelimit

@ratelimit(key='user_or_ip', rate='10/m', block=True)
def secure_file_upload(request):
    # rate='10/m'은 분당 10회 요청을 의미
    # block=True 설정 시 제한 초과 시 403 에러를 즉시 발생시킴
    return render(request, 'upload_success.html')

위와 같이 라이브러리를 사용하면 key 옵션을 통해 IP, 사용자, 헤더 정보 등 다양한 기준으로 요청을 식별할 수 있으며, rate 설정을 통해 초, 분, 시, 일 단위로 세밀하게 트래픽을 제어할 수 있습니다.

태그: Django Rate Limiting Throttling API Security python

10월 17일 21:13에 게시됨