IDNA 표준을 위한 Python 문자열 정규화 (stringprep vs. idna)

2025-11-17

stringprep 모듈은 RFC 3454에 정의된 Stringprep 프로토콜을 구현한 것입니다. 이 프로토콜은 특히 도메인 이름이나 사용자 이름과 같은 문자열을 국제적인 환경에서 안전하게 비교하고 사용할 수 있도록 정규화하는 규칙을 제공합니다.

stringprep.in_table_c3(code) 함수는 입력된 유니코드 코드 포인트(code)가 Table C.3에 포함되어 있는지 여부를 부울 값(True/False)으로 반환합니다.

Table C.3 (Non-ASCII Characters Used for Locale-Specific Functions) 이 테이블에 있는 문자들은 일반적으로 특정 지역 설정(locale)에서 특수한 기능을 수행할 수 있는 비-ASCII 문자들입니다. Stringprep 프로토콜에서는 이러한 문자들이 문자열의 비교나 유효성 검사 과정에서 제한되거나 특별히 처리될 필요가 있습니다.

import stringprep

# 예시 1: Table C.3에 포함된 문자 (유니코드 U+FFFC, Object Replacement Character)
# 이 문자는 stringprep에서 'prohibited'로 간주될 수 있습니다.
code_c3 = 0xFFFC 
print(f"코드 0x{code_c3:X}가 Table C.3에 포함됩니까? {stringprep.in_table_c3(code_c3)}")

# 예시 2: Table C.3에 포함되지 않은 일반 문자 (유니코드 U+0061, 'a')
code_not_c3 = ord('a')
print(f"코드 0x{code_not_c3:X}가 Table C.3에 포함됩니까? {stringprep.in_table_c3(code_not_c3)}")

stringprep 모듈 자체는 Python 3의 IDNA 처리에서 더 이상 권장되지 않거나 대체되었습니다. 따라서 이 함수를 직접 사용하는 것에서 문제가 발생하기보다는, 모듈의 가용성과 최신 표준과의 호환성에서 문제가 생길 수 있습니다.

문제 Python 3.3 이후로 stringprep 모듈은 공식적으로 deprecated(지원 중단)되었습니다. Python 환경에 따라 아예 모듈이 없거나, 최신 IDNA 표준을 반영하지 못할 수 있습니다. 해결책 최신 텍스트 처리 및 IDNA 표준 준수를 위해서는 stringprep 대신 encodings.idna 모듈이나, 더 일반적으로는 idna 라이브러리(PyPI를 통해 설치)를 사용해야 합니다.

문제
stringprep는 IDNA2003 표준을 기반으로 하며, 최신 IDNA2008 표준과는 문자 처리 규칙이 다릅니다. 이는 도메인 이름의 정규화와 비교에서 호환성 문제를 일으킬 수 있습니다. 해결책
idna 라이브러리를 사용하여 stringprep의 정규화 과정을 대체해야 합니다. 이 라이브러리는 최신 표준을 준수합니다.

대부분의 경우, 도메인 이름 또는 사용자 이름과 같은 문자열을 정규화하고 처리할 때는 stringprep의 개별 함수 대신 최신 IDNA 라이브러리의 encode 또는 decode 함수를 사용하여 전체 정규화 프로세스를 수행합니다.

idna는 Python의 표준 라이브러리는 아니지만, IDNA2008 표준을 가장 잘 구현하고 있어 널리 사용됩니다. (설치
pip install idna)

import idna

# 1. 인코딩: 유니코드 도메인 이름을 ASCII 호환 형식 (Punycode)으로 변환
unicode_domain = "테스트.예시"

try:
    # IDNA2008 표준에 따라 정규화 및 인코딩을 수행합니다.
    punycode_domain = idna.encode(unicode_domain).decode('ascii')
    print(f"유니코드 도메인: {unicode_domain}")
    print(f"Punycode 변환: {punycode_domain}")
    
    # 2. 디코딩: Punycode를 다시 유니코드로 변환
    decoded_domain = idna.decode(punycode_domain)
    print(f"디코드 결과: {decoded_domain}")

except idna.IDNAError as e:
    # 정규화 규칙을 위반하는 문자가 포함되어 있을 경우 에러가 발생합니다.
    print(f"IDNA 처리 오류 발생: {e}")