ngx_http_userid_module
ngx_http_userid_module 모듈은 클라이언트 식별에 적절한 쿠키를 설정합니다. 수신 및 설정된 쿠키는 임베디드 변수 $uid_got과 $uid_set를 사용하여 로깅됩니다. 이 모듈은 Apache의 mod_uid 모듈과 호환됩니다.
예제 구성
userid on;
userid_name uid;
userid_domain example.com;
userid_path /;
userid_expires 365d;
userid_p3p 'policyref="/w3c/p3p.xml", CP="CUR ADM OUR NOR STA NID"';
Directives
Syntax: userid on | v1 | log | off;
Default: userid off;
Context: http, server, location
쿠키 설정과 수신한 쿠키의 로깅을 활성화하거나 비활성화합니다.
on
버전 2 쿠키 설정과 수신된 쿠키의 로깅을 활성화합니다.
v1
버전 1 쿠키 설정과 수신된 쿠키의 로깅을 활성화합니다.
log
쿠키 설정을 비활성화하고, 수신된 쿠키의 로깅은 활성화합니다.
off
쿠키 설정과 수신된 쿠키의 로깅을 비활성화합니다.
Syntax: userid_domain name | none;
Default: userid_domain none;
Context: http, server, location
쿠키를 설정할 영역을 정의합니다. none 매개변수는 쿠키에 대한 도메인 설정을 비활성화합니다.
Syntax: userid_expires time | max | off;
Default: userid_expires off;
Context: http, server, location
브라우저가 쿠키를 저장하는 기간을 설정합니다. 매개변수 max는 쿠키가 “31 Dec 2037 23:55:55 GMT”에 만료되도록 합니다. 매개변수 off는 쿠키가 브라우저 세션이 끝나면 만료되도록 합니다.
Syntax: userid_flags off | flag ...;
Default: userid_flags off;
Context: http, server, location
This directive appeared in version 1.19.3.
매개변수가 off가 아닐 경우, 쿠키에 하나 이상의 추가 플래그를 정의합니다. secure
, httponly
, samesite=strict
, samesite=lax
, samesite=none
.
Syntax: userid_mark letter | digit | = | off;
Default: userid_mark off;
Context: http, server, location
매개변수가 off가 아닐 경우, 쿠키 마킹 메커니즘을 활성화하고 마크로 사용할 문자를 설정합니다. 이 메커니즘은 클라이언트 ID를 저장하면서 userid_p3p 및/또는 쿠키 만료 기간을 추가하거나 변경하는 데 사용합니다. 마크는 영문자(대소문자 구분), 숫자, “=” 문자를 사용할 수 있습니다.
마크를 설정한 경우, 쿠키에 전달된 클라이언트 ID를 base64로 표시한 것에서 첫 패딩 기호와 비교합니다. 둘이 일치하지 않는 경우, 쿠키는 지정된 마크, 만료 시간, “P3P” 헤더를 포함하여 다시 전송됩니다.
Syntax: userid_name name;
Default: userid_name uid;
Context: http, server, location
쿠키 이름을 설정합니다.
Syntax: userid_p3p string | none;
Default: userid_p3p none;
Context: http, server, location
쿠키와 함께 전송된 “P3P” 헤더 필드의 값을 설정합니다. 명령이 특수 값 none으로 설정되면 응답에서 “P3P” 헤더를 전송하지 않습니다.
Syntax: userid_path path;
Default: userid_path /;
Context: http, server, location
쿠키를 설정할 경로를 정의합니다.
Syntax: userid_service number;
Default: userid_service IP address of the server;
Context: http, server, location
여러 서버(서비스)에서 ID를 발급한 경우, 각 서비스는 자신의 number를 할당해서 클라이언트 ID가 고유하게 유지되도록 해야 합니다. 버전 1 쿠키의 경우, 기본값이 0입니다. 버전 2 쿠키의 경우, 기본값은 서버 IP 주소의 마지막 4자리에서 구성된 숫자입니다.
임베디드 변수
ngx_http_userid_module 모듈은 다음의 임베디드 변수를 지원합니다.
$uid_got
쿠키 이름 및 수신된 클라이언트 ID.
$uid_reset
변수를 “0”이 아니고 비어 있지 않은 문자열을 설정할 경우, 클라이언트 ID를 재설정합니다. 또한, 특수 값 “log”는 재설정 ID에 대한 메시지 출력을 error_log로 보냅니다.
$uid_set
쿠키 이름 및 전송된 클라이언트 ID.