Python 'ValueError: Signature expired' 오류 해결 방법 총정리

파이썬 개발 중 'ValueError: Signature expired' 오류를 마주치셨나요? 이 오류는 일반적으로 인증 토큰이나 서명의 유효 기간이 만료되었을 때 발생합니다. 특히 AWS, JWT 토큰, 서명된 URL 등을 다룰 때 자주 등장하는 문제입니다. 이 글에서는 이 오류의 원인과 해결 방법을 상세히 알아보겠습니다.

ValueError: Signature expired란 무엇인가?

'ValueError: Signature expired'는 파이썬에서 디지털 서명이나 토큰의 유효 기간이 지났을 때 발생하는 예외입니다. 보안을 위해 많은 시스템이 시간 제한이 있는 서명을 사용하며, 이 시간이 지나면 서명은 더 이상 유효하지 않습니다. 주요 발생 환경은 다음과 같습니다:

AWS S3 presigned URL 사용 시
JWT(JSON Web Token) 인증 처리 시
시간 제한이 있는 API 인증 토큰 사용 시
OAuth 인증 프로세스 중

오류의 주요 원인

이 오류가 발생하는 주된 원인은 다음과 같습니다:

서버와 클라이언트 간 시간 불일치: 시스템 시간이 정확하지 않을 때 발생합니다.
만료된 토큰 사용: 실제로 토큰이 만료된 후 사용을 시도할 때 발생합니다.
잘못된 만료 시간 설정: 토큰 생성 시 만료 시간을 너무 짧게 설정한 경우입니다.
타임존 문제: 서로 다른 시간대 설정으로 인한 시간 불일치가 원인일 수 있습니다.

해결 방법: 서명 만료 오류 해결하기

1. 시스템 시간 동기화

# 리눅스/맥 환경에서 시간 동기화
# 터미널에서 실행
# sudo ntpdate pool.ntp.org

# 파이썬에서 시간 확인
import datetime
print(datetime.datetime.now())

시스템 시간이 정확한지 확인하고, NTP 서버와 동기화하는 것이 중요합니다.

2. JWT 토큰 만료 시간 연장

import jwt
import datetime

# 만료 시간을 더 길게 설정
payload = {
    'exp': datetime.datetime.utcnow() + datetime.timedelta(hours=24),
    'iat': datetime.datetime.utcnow(),
    'sub': 'user123'
}

secret = 'your_secret_key'
token = jwt.encode(payload, secret, algorithm='HS256')

JWT 토큰 생성 시 exp (만료 시간)을 충분히 길게 설정합니다.

3. AWS S3 presigned URL 수정

import boto3
from botocore.config import Config

# 설정에서 서명 만료 시간 연장
s3_client = boto3.client(
    's3',
    config=Config(signature_version='s3v4')
)

# URL 생성 시 만료 시간을 더 길게 설정 (초 단위)
presigned_url = s3_client.generate_presigned_url(
    'get_object',
    Params={'Bucket': 'my-bucket', 'Key': 'my-file'},
    ExpiresIn=3600  # 1시간
)

AWS S3 presigned URL의 만료 시간을 적절히 조정합니다.

4. 토큰 갱신 매커니즘 구현

def get_valid_token():
    # 토큰이 만료되었는지 확인
    try:
        # 토큰 검증 로직
        decoded_token = jwt.decode(current_token, secret, algorithms=['HS256'])
        return current_token
    except jwt.ExpiredSignatureError:
        # 만료된 경우 새로운 토큰 발급
        return generate_new_token()

토큰이 만료되었을 때 자동으로 갱신하는 로직을 구현합니다.

개발 환경별 주의사항

로컬 개발 환경

로컬 개발 환경에서는 컴퓨터의 시간 설정이 정확한지 확인해야 합니다. 특히 가상 머신을 사용할 때 시간 동기화에 문제가 있을 수 있습니다.

클라우드 환경

AWS Lambda나 Docker 컨테이너 같은 클라우드 환경에서는 시스템 시간이 자동으로 동기화되는지 확인하세요. 간혹 컨테이너화된 환경에서 시간 동기화 문제가 발생할 수 있습니다.

결론

'ValueError: Signature expired' 오류는 대부분 시간 관련 설정이나 만료된 인증 정보를 사용할 때 발생합니다. 시스템 시간 동기화, 적절한 만료 시간 설정, 자동 갱신 메커니즘 구현 등을 통해 이 문제를 해결할 수 있습니다. 보안과 편의성 사이의 균형을 잘 맞추는 것이 중요하며, 토큰의 만료 시간은 보안 요구사항에 맞게 설정해야 합니다.

파이썬에서 서명 만료 오류를 효과적으로 처리함으로써 더 안정적인 애플리케이션을 구축하시길 바랍니다!

Arong's Town

이 블로그 검색