Microsoft MVP성태의 닷넷 이야기
웹: 33. HTTP 쿠키에 한글 값을 설정하는 방법 [링크 복사], [링크+제목 복사],
조회: 28764
글쓴 사람
정성태 (techsharer at outlook.com)
홈페이지
첨부 파일
 

(시리즈 글이 3개 있습니다.)
.NET Framework: 473. WebClient 객체에 쿠키(Cookie)를 사용하는 방법
; https://www.sysnet.pe.kr/2/0/1792

웹: 33. HTTP 쿠키에 한글 값을 설정하는 방법
; https://www.sysnet.pe.kr/2/0/11017

웹: 38. HTTP Cookie의 expires 시간 형식(RFC7231)
; https://www.sysnet.pe.kr/2/0/11892




HTTP 쿠키에 한글 값을 설정하는 방법

웹 응용 프로그램에서 HTTP 쿠키에 한글을 담는 경우 글자가 깨집니다.

[asp.net] local에서 cookies값이 읽혀지지 않는 경우
; https://www.sysnet.pe.kr/3/0/4746
; https://www.sysnet.pe.kr/3/0/4747

"개발자 도구(F12)" 네트워크로 한글을 설정한 쿠키 값을 담은 응답을 살펴보면 깨져나옵니다.

cookie_mbytes_1.png

사실, 뷰어에서 깨져서 표현된 것일뿐 원래는 정상적으로 데이터를 내려보낸 것이나 다름없습니다. 일례로 HTTP 응답 데이터는 단순하게 다음과 같이 Set-Cookie 헤더를 발행합니다.

HTTP/1.1 200 OK
Cache-Control: private
Content-Type: text/html; charset=utf-8
Server: Microsoft-IIS/10.0
X-AspNet-Version: 4.0.30319
Set-Cookie: UserName=홍길동; path=/
X-Powered-By: ASP.NET
Date: Tue, 09 Aug 2016 01:51:58 GMT
Connection: close
Content-Length: 1643

그리고 '홍길동'의 바이트 값은 "0xed 0x99 0x8d 0xea 0xb8 0xb8 0xeb 0x8f 0x99"로 utf-8 인코딩된 값입니다.

서버에서 제대로 내려보내줬으니, 이제 문제는 브라우저로 내려갑니다. 하지만, "http://stackoverflow.com/questions/1969232/allowed-characters-in-cookies" 글에도 나오듯이 HTTP Cookie는 RFC 문서 자체에,

Newer rfc6265 published in April 2011:

cookie-header = "Cookie:" OWS cookie-string OWS
cookie-string = cookie-pair *( ";" SP cookie-pair )
cookie-pair  = cookie-name "=" cookie-value
cookie-value = *cookie-octet / ( DQUOTE *cookie-octet DQUOTE )

cookie-octet = %x21 / %x23-2B / %x2D-3A / %x3C-5B / %x5D-7E
                   ; US-ASCII characters excluding CTLs,
                   ; whitespace DQUOTE, comma, semicolon,
                   ; and backslash

이미 유니코드에 대한 배려가 없습니다. 브라우저 입장에서 한글 처리를 안했다고 해서 표준에 어긋나는 것이 아닙니다.

결국, 이 문제를 해결하려면 허용하는 문자 범위 내에서 값을 인코딩/디코딩하는 식으로 해야 합니다. 즉, base64나 urlencode 등의 방식으로 처리하는데, ASP.NET의 경우 간편하게 UrlEncode/UrlDecode를 사용해 주면 해결됩니다.

protected void btnSetCookis_Click(object sender, EventArgs e)
{
    HttpCookie cookie = new HttpCookie("UserName");
    Response.Cookies["UserName"].Value = HttpUtility.UrlEncode("홍길동");
}

protected void btnGetCookis_Click(object sender, EventArgs e)
{
    if (Request.Cookies["UserName"] != null)
    {
        lblCookies.Text = HttpUtility.UrlDecode(Request.Cookies["UserName"].Value);
    }
}

물론, 클라이언트 측 javascript에서 해당 텍스트를 복원하려면 그에 맞는 디코딩을 해야 합니다. (이런 이유 때문에 base64보다는 urlencode 방식이 더 낫습니다.)




그런데, 허용된 문자로 인코딩하기 전에 문자열 자체는 그 표현 방식에 따른 인코딩이 선행되어야 합니다. 가령 utf-8, utf-16의 방식으로 문자열 인코딩이 정해져야 하는데, 그건 어떻게 제어할까요?

ASP.NET의 경우 web.config의 globalization 설정에서 그것이 결정됩니다.

<?xml version="1.0" encoding="utf-8"?>

<configuration>

    <system.web>
    
      <compilation debug="true" targetFramework="4.5" />
      <httpRuntime targetFramework="4.5" />
        <globalization requestEncoding="utf-8"
                 responseEncoding="utf-8"
                 fileEncoding=""
                 culture=""
                 uiCulture=""
                 enableClientBasedCulture="false"
                 responseHeaderEncoding="utf-8"
                 resourceProviderFactoryType=""
                 enableBestFitResponseEncoding="false" />

    </system.web>

</configuration>

위의 설정값은 생략한 경우의 기본값을 나열하고 있습니다. 즉, asp.net은 쿠키 값을 비롯해 HTTP 응답 헤더의 모든 내용을 기본적으로 utf-8 인코딩을 합니다. (그래서, 이 글의 예제에 나온 '홍길동'의 바이트 값이 "0xed 0x99 0x8d 0xea 0xb8 0xb8 0xeb 0x8f 0x99"로 된 것입니다.)

이 값을 살짝 바꿔보면,

responseHeaderEncoding="ks_c_5601-1987"

Set-Cookie의 "홍길동" 부분의 바이트 값은 이렇게 바뀝니다.

0xc8 0xab 0xb1 0xe6 0xb5 0xbf

그런데, 이렇게 놓고 하면 URL Encoding같은 작업을 하지 않아도 (Edge 웹 브라우저에서) 잘 됩니다. 아마도, 마이크로소프트 계열의 웹 브라우저는 HTTP 헤더에 대한 디코딩을 Encoding.ASCII가 아닌 시스템 기본 인코딩 설정(Encoding.Default)로 처리하기 때문으로 보입니다. 이로 인해 한글 설정이 된 윈도우에 설치된 Edge 웹 브라우저에서는 한글 값을 가진 쿠키를 정상적으로 처리하는 것입니다. 당연히, 다른 웹 브라우저에서의 이런 동작을 (설령 될지언정) 기대할 수는 없습니다.

이 정도면, 대충... 쿠키에 대한 인코딩 동작 방식이 눈에 들어오실 것입니다. ^^




[이 글에 대해서 여러분들과 의견을 공유하고 싶습니다. 틀리거나 미흡한 부분 또는 의문 사항이 있으시면 언제든 댓글 남겨주십시오.]







[최초 등록일: ]
[최종 수정일: 9/28/2024]

Creative Commons License
이 저작물은 크리에이티브 커먼즈 코리아 저작자표시-비영리-변경금지 2.0 대한민국 라이센스에 따라 이용하실 수 있습니다.
by SeongTae Jeong, mailto:techsharer at outlook.com

비밀번호

댓글 작성자
 




[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...
NoWriterDateCnt.TitleFile(s)
14006정성태8/23/20255Linux: 121. Linux - snap 패키지 관리자로 설치한 소프트웨어의 디렉터리 접근 제한
14005정성태8/21/2025456오류 유형: 982. sudo: unable to load /usr/libexec/sudo/sudoers.so: libssl.so.3: cannot open shared object file: No such file or directory
14004정성태8/21/2025495오류 유형: 981. dotnet 실행 시 No usable version of the libssl was found
14003정성태8/21/2025600닷넷: 2357. C# 14 - (9) 새로운 지시자 추가 (Ignored directives)
14002정성태8/20/20251096오류 유형: 980. C# - appsettings.json 파일의 설정값이 적용 안 된다면?
14001정성태8/19/20251347닷넷: 2356. .NET SDK 10 - 단일 소스 코드 파일을 빌드/실행하는 기능을 "dotnet" 명령어에 추가
14000정성태8/18/20251137오류 유형: 979. ERROR: failed to solve: failed to read dockerfile: open Dockerfile: no such file or directory
13999정성태8/15/20251431닷넷: 2355. C# 14 - (8) null 조건부 연산자 개선 - 대입문에도 사용 가능파일 다운로드1
13998정성태8/14/20251303닷넷: 2354. C# 14 - (7) 확장 메서드에 정적 메서드와 속성 지원을 위한 전용 구문 추가파일 다운로드1
13997정성태8/14/20251415Linux: 120. docker 컨테이너로 매핑된 볼륨에 컨테이너 측의 사용자 ID를 유지하면서 복사하는 방법
13996정성태8/13/2025965오류 유형: 978. Unable to find the requested .Net Framework Data Provider.
13995정성태8/13/2025963개발 환경 구성: 754. Visual C++ - 리눅스 빌드를 위한 Ubuntu 18 docker 컨테이너 설정
13994정성태8/12/2025926오류 유형: 977. SQL Server - User, group, or role '...' already exists in the current database. (Microsoft SQL Server, Error: 15023)
13993정성태8/11/20251456오류 유형: 976. Microsoft.ML.OnnxRuntimeGenAI 패키지 사용 시 "cublasLt64_12.dll" which is missing. (Error 126: "The specified module could not be found.") 오류
13992정성태8/11/20251597닷넷: 2353. C# - Foundry Local을 이용한 gpt-oss-20b 모델 사용파일 다운로드1
13991정성태8/9/20251428오류 유형: 975. winget - Foundry Local 패키지 업데이트가 안 되는 문제
13990정성태8/8/20251094Windows: 283. Time zone 설정이 없는 Windows Server 2025
13989정성태8/8/20251585닷넷: 2352. C# - Windows S-mode 환경인지 체크하는 방법파일 다운로드1
13988정성태8/8/20251705오류 유형: 974. 비주얼 스튜디오 업데이트 시 잠김 파일 경고 - Visual Studio Standard Collector Service 150 (VSStandardCollectorService150)
13987정성태8/7/20251357닷넷: 2351. C# 14 - (6) event와 생성자에도 partial 메서드 적용파일 다운로드1
13986정성태8/6/20251388닷넷: 2350. C# 14 - (5) 람다 매개 변수에 접근자가 있는 경우에도 타입 생략 가능파일 다운로드1
13985정성태8/6/20251917오류 유형: 973. "wsl --install" 명령어 수행 시 "The server name or address could not be resolved"
13984정성태8/6/20251612Windows: 282. 윈도우 운영체제에 추가된 ssh 서버(Win32-OpenSSH)
13983정성태8/4/20251870오류 유형: 972. Microsoft.Data.SqlClient 6.1.0 버전부터 .NET 8 이상만 지원
13982정성태8/2/20252036개발 환경 구성: 753. CentOS 7 컨테이너 내에서 openssh 서버 호스팅
[1]  2  3  4  5  6  7  8  9  10  11  12  13  14  15  ...