JWT를 활용한 파이썬 API 서버의 접근 로그 및 보안 이벤트 저장 방법

22 Sep 2023

API 서버는 사용자 인증 및 보안을 관리하는 중요한 역할을 수행합니다. JWT(Json Web Token)는 많은 개발자에게 인증 및 권한 부여를 간편하게 구현할 수 있는 도구입니다. 그러나 API 서버에 접근한 사용자들의 로깅 정보와 보안 이벤트를 저장하는 것은 보안 정책 및 문제 해결을 위해 매우 중요합니다. 이번 블로그 포스트에서는 JWT를 활용한 파이썬 API 서버에서 접근 로그와 보안 이벤트를 저장하는 방법에 대해 알아보겠습니다.

1. 로그 저장 방법

1.1. Access Log

API 서버에 접근하는 모든 사용자의 로그를 저장하기 위해서는 Access Log를 활용할 수 있습니다. Access Log는 사용자의 IP 주소, 접근 시간, 요청 URL, HTTP 상태 코드 등의 정보를 기록합니다. 이러한 로그는 추후 보안 문제나 서비스 개선을 위해 사용될 수 있습니다.

import logging

logging.basicConfig(filename='access.log', level=logging.INFO)

# Access Log 저장 예제
def save_access_log(ip, url, status_code):
    logging.info(f"IP: {ip} - URL: {url} - Status Code: {status_code}")

위의 예제 코드에서는 파이썬의 내장 logging 모듈을 활용하여 Access Log를 저장하였습니다. 접근 로그를 저장할 파일(위의 예제에서는 access.log)을 설정하고, 필요한 정보를 포맷에 맞추어 저장합니다.

1.2. Audit Log

Audit Log는 사용자의 행위와 관련된 모든 이벤트를 로그로 저장합니다. 이는 사용자의 접근 시도, 권한 부여, 인증 실패 등에 대한 정보를 포함합니다. JWT를 사용하는 경우, Audit Log는 중요한 보안 이벤트를 기록하기 위해 매우 유용합니다.

import logging

logging.basicConfig(filename='audit.log', level=logging.INFO)

# Audit Log 저장 예제
def save_audit_log(username, event):
    logging.info(f"User: {username} - Event: {event}")

위의 예제 코드는 Audit Log를 저장하기 위해 logging 모듈을 사용합니다. 사용자의 이름(또는 아이디)와 이벤트 정보를 로그로 저장합니다.

2. 보안 이벤트 저장 방법

파이썬 API 서버에서 JWT를 활용한 보안 이벤트를 저장하기 위해서는 Error Log와 Security Incident Log를 활용할 수 있습니다.

2.1. Error Log

Error Log는 서버에서 발생하는 오류 및 예외 상황을 기록합니다. 복구해야 할 오류를 식별하고 디버깅하는 데 유용합니다. JWT를 사용하는 API 서버에서는 암호화 및 복호화 중 발생하는 오류, 만료된 토큰에 대한 오류 등을 기록할 수 있습니다.

import logging

logging.basicConfig(filename='error.log', level=logging.ERROR)

# Error Log 저장 예제
def save_error_log(error_message):
    logging.error(f"Error: {error_message}")

위의 코드 예제는 Error Log를 저장하는 함수를 보여줍니다. 발생한 오류 메시지를 기록합니다.

2.2. Security Incident Log

보안 사고가 발생했을 때, 이를 기록하기 위해 Security Incident Log를 활용할 수 있습니다. 이는 API 서버에서 발생한 보안 이벤트를 추적하고 분석하기 위해 사용됩니다. 예를 들어, 잘못된 액세스 토큰으로 인한 인증 실패, 알 수 없는 IP 주소로부터의 액세스 등을 기록합니다.

import logging

logging.basicConfig(filename='security.log', level=logging.WARNING)

# Security Incident Log 저장 예제
def save_security_incident_log(ip, username, event):
    logging.warning(f"IP: {ip} - User: {username} - Event: {event}")

위의 예제 코드는 Security Incident Log를 저장하는 함수를 보여줍니다. 공격을 시도한 IP 주소, 사용자 이름(또는 아이디) 및 발생한 이벤트를 로그로 저장합니다.

마무리

이번 포스트에서는 JWT를 활용한 파이썬 API 서버에서의 접근 로그 및 보안 이벤트 저장 방법에 대해 알아보았습니다. 로깅은 보안 및 문제 해결에 필수적이므로 적절한 로그 저장 방법과 관리가 필요합니다. 이를 통해 API 서버의 안전성을 향상시킬 수 있고, 보안 사고 발생 시 신속하게 대응할 수 있습니다.

#API #서버 #로그 #보안 #JWT