Java4Shell WAF 대응: GET·POST·PUT 요청에서 무엇을 차단해야 하는가

By PLURA

🛡️ Java가 디코딩하기 전에 차단해야 합니다

Java4Shell 대응의 핵심은 외부에서 들어온 비정상 Base64 값이 취약한 Java 디코더에 도달하기 전에 차단하는 것입니다. 웹방화벽에서 보호할 HTTP 경로와 검사 대상을 구체화하고, 실제 차단 효과를 확인하면서 Java 패치를 병행해야 합니다.

2026년 11월 17일 미국 태평양시간 기준으로 공개된 Java4Shell(CVE-2026-114938)은 Java의 하드웨어 가속 Base64 디코딩 경로에서 발생하는 메모리 손상 취약점입니다. 한국시간으로는 11월 18일입니다. 취약 코드가 포함된 미수정 런타임에서 x86-64의 AVX-512 VBMI 가속 경로가 사용되고, 공격자가 제어한 입력이 해당 디코더에 도달하는 조건이 맞으면 정보 노출·서비스 장애·원격 코드 실행으로 이어질 수 있습니다.12

위험도는 Calif의 CVSS 4.0 기준 9.2점(Critical)과 Oracle의 CVSS 3.1 기준 8.1점(High)을 평가 주체·버전과 함께 구분해 표기합니다. 실제 RCE의 인증 필요 여부와 성립 조건은 제품·입력 처리 경로에 따라 다르므로, Java를 사용한다는 사실만으로 모든 서비스의 무인증 RCE를 단정하지 않습니다.23

운영자에게 필요한 것은 “Base64를 검사한다”는 설명을 실제 정책으로 바꾸는 기준입니다. 어느 HTTP 메서드에서, 어느 위치의 값을, 어떻게 파싱하고, 언제 거부할 것인지가 정해져야 WAF에 규칙을 넣을 수 있습니다.

No. 결정할 항목 적용 기준
1 HTTP 메서드 서비스가 허용하는 모든 메서드에 검사 적용
2 요청 위치 헤더·쿠키·쿼리·경로와 요청 본문
3 본문 해석 Content-Type에 맞는 파서로 개별 값 추출
4 차단 조건 알려진 비정상 패딩과 지정 Base64 필드의 문법 위반
5 차단 시점 원본 Java 서버에 요청을 전달하기 전
6 검사 실패 파싱 실패·검사 한도 초과를 정상 통과로 처리하지 않음
7 근본 조치 실행 중인 Java 런타임의 보안 업데이트

WAF에서 공격 입력을 통제하고, 보호가 확인된 서비스를 운영하면서 Java 패치를 진행합니다. 이때 보호 여부는 규칙 등록 화면이 아니라 실제 검사 결과와 원본 서버 미도달로 확인해야 합니다.


🔎 GET·POST·PUT은 어디를 검사해야 할까요?

같은 payload 값도 쿼리, 폼, JSON 등 서로 다른 위치로 전달될 수 있습니다. WAF는 요청의 전송 형식을 해석한 다음 애플리케이션이 사용할 값을 검사해야 합니다.

아래는 NGINX + libModSecurity v3 기준의 검사 위치입니다. phase:1은 요청 헤더를 읽은 단계, phase:2는 본문을 읽은 뒤의 단계입니다.4

No. 요청 형태 검사 대상 시점
1 GET /api?payload=... ARGS_GET, REQUEST_HEADERS, REQUEST_COOKIES phase 1
2 POST /api?payload=... POST에 포함된 쿼리도 ARGS_GET으로 검사 phase 1
3 POST + 폼·JSON 본문 파싱된 개별 값 ARGS phase 2
4 PUT + 폼·JSON 본문 POST와 같은 ARGS phase 2
5 PATCH + 폼·JSON 본문 POST와 같은 ARGS phase 2
6 DELETE, HEAD, OPTIONS 헤더·쿠키·쿼리 검사. 허용된 본문이 있으면 추가 검사 phase 1·2
7 본문이 포함된 GET 헤더·쿠키·쿼리와 본문을 각각 검사 phase 1·2
8 모든 메서드의 /api/<Base64url 값> 경로 세그먼트에 담긴 값 phase 1

본문 검사 규칙에는 POST 메서드 조건을 붙이지 않습니다. PUT·PATCH도 같은 JSON·폼 입력을 받을 수 있기 때문입니다. 지원하지 않는 메서드나 본문은 해당 API의 허용 정책에 따라 거부하면 됩니다.

또한 ARGS_GET·ARGS_POST의 이름과 HTTP 메서드를 구분해야 합니다. 쿼리는 POST 요청에도 ARGS_GET으로 들어가고, 폼 본문의 처리는 PUT·PATCH에도 적용됩니다. JSON까지 포함하는 본문 검사에는 ARGS를 사용합니다.5


🧩 Content-Type을 해석한 뒤 개별 값을 검사합니다

본문 전체에서 문자열을 검색하는 것과, JSON·폼을 파싱한 뒤 값을 검사하는 것은 결과가 다릅니다. 예를 들어 JSON의 \u003d는 파싱 후 =가 됩니다. Java에 전달되는 값과 같은 표현을 검사하려면 해당 파서가 먼저 동작해야 합니다.

No. Content-Type 본문 처리 검사 변수
1 application/x-www-form-urlencoded URLENCODED 파서가 이름과 값 분리 ARGS
2 application/json, application/*+json JSON 파서가 문자열 값 추출 ARGS
3 multipart/form-data multipart 파서가 일반 필드 추출 ARGS
4 application/xml, text/xml, application/*+xml XML 텍스트와 속성 값 추출 XML://text(), XML://@*
5 원시 본문 알려진 패턴 보조 검색 REQUEST_BODY

URLENCODED·MULTIPART는 Content-Type에 따라 자동 선택됩니다. JSON·XML은 phase 1에서 프로세서를 지정해야 합니다. multipart의 일반 필드와 업로드 파일 내부도 구분해야 합니다. 파일 안의 압축 데이터나 별도 포맷까지 ARGS에서 해석되는 것은 아닙니다.6

JSON·XML 파서 선택 예제

아래 코드는 제공한 전체 설정의 발췌입니다. 실제 적용에는 뒤에서 설명하는 검사 한도·오류 처리 규칙도 함께 필요합니다.

SecRuleEngine On
SecRequestBodyAccess On

SecRule REQUEST_HEADERS:Content-Type "@rx ^application/(?:[a-z0-9.+_-]+\+)?json(?:[ \t]*;|[ \t]*$)" \
    "id:11901,phase:1,t:none,t:lowercase,pass,nolog,ctl:requestBodyProcessor=JSON"

SecRule REQUEST_HEADERS:Content-Type "@rx ^(?:(?:application|text)/xml|application/[a-z0-9.+_-]+\+xml)(?:[ \t]*;|[ \t]*$)" \
    "id:11902,phase:1,t:none,t:lowercase,pass,nolog,ctl:requestBodyProcessor=XML"

Content-Type: application/json이라는 헤더가 있다는 사실만으로 JSON 검사 완료를 판단하면 안 됩니다. 배포된 엔진의 JSON·XML 지원과 실제 파싱된 변수를 확인해야 합니다.


🧬 어떤 Base64를 차단해야 할까요?

정상 Base64에도 끝의 =나 ==가 사용됩니다. 따라서 =가 있다는 이유만으로 차단하지 않습니다. 문자 개수, 마지막 단위, 패딩 위치와 개수를 함께 검사해야 합니다. Java 디코더는 일부 정상 입력의 패딩 생략도 허용하므로 서비스가 허용하는 문법을 먼저 정해야 합니다.7

디코딩 예외를 처리하는 것만으로는 이 취약점을 완화할 수 없습니다. Java가 최종적으로 IllegalArgumentException을 발생시켜 입력을 거부하더라도, 취약한 가속 경로에서 메모리 손상이 먼저 발생할 수 있기 때문입니다. 입력 검사는 취약한 디코더를 호출하기 전에 수행해야 합니다. 애플리케이션의 오류 응답만으로 보호를 판단하지 않고, WAF의 거부 기록과 원본 서버 미도달을 함께 확인하는 이유도 여기에 있습니다.28

Calif의 분석은 64개 단위 처리 후 남는 입력에서 다음과 같은 비정상 꼬리가 문제가 될 수 있음을 설명합니다. X, Y는 데이터 문자이며, 아래는 전체 공격 문자열의 종류가 아니라 마지막 꼬리의 형태입니다.2

No. 비정상 꼬리 공통 탐지식에 포함
1 = 포함
2 == 포함
3 X= 포함
4 X== 포함
5 XY= 포함
6 === 포함

WAF 정책은 두 단계로 구성합니다.

  1. 공통 패턴 검사: 여러 입력 위치에서 공개된 비정상 패딩 패턴을 찾습니다.
  2. 지정 필드 문법 검사: Base64를 받는 API와 필드가 확인되면 정상 문법을 벗어난 값 전체를 거부합니다.

Microsoft도 헤더·쿼리·본문 등 입력 위치에 따른 WAF 규칙을 공개했습니다. 아래 SecRule은 공개 자료를 바탕으로 구성한 참조 구현이며, 특정 공급자가 배포한 제품 규칙을 그대로 옮긴 것은 아닙니다.1


⚙️ 공통 규칙: 헤더·쿠키·쿼리와 본문을 검사합니다

① 모든 메서드의 헤더·쿠키·쿼리

SecRule REQUEST_HEADERS|REQUEST_COOKIES|ARGS_GET "@rx (?:\A|[^A-Za-z0-9+/_=-])(?:[A-Za-z0-9+/_-]{64})+(?:[A-Za-z0-9+/_-]{0,2}=|[A-Za-z0-9+/_-]?==|===)(?=\z|[^A-Za-z0-9+/_=-])" \
    "id:11910,phase:1,t:none,deny,status:403,log,msg:'Java4Shell known malformed Base64 token in headers cookies or query',tag:'CVE-2026-114938'"

GET 쿼리, POST에 붙은 쿼리, Authorization 헤더와 쿠키 값 등에서 해당 패턴을 찾으면 요청 전체를 403으로 거부합니다. 쿠키와 쿼리는 원시 이름=값 문자열만 검색하지 않고 파싱된 값도 검사합니다.

② POST·PUT·PATCH의 JSON·폼 본문

SecRule ARGS "@rx (?:\A|[^A-Za-z0-9+/_=-])(?:[A-Za-z0-9+/_-]{64})+(?:[A-Za-z0-9+/_-]{0,2}=|[A-Za-z0-9+/_-]?==|===)(?=\z|[^A-Za-z0-9+/_=-])" \
    "id:11930,phase:2,t:none,deny,status:403,log,msg:'Java4Shell known malformed Base64 token in parsed arguments',tag:'CVE-2026-114938'"

이 규칙에는 메서드 조건이 없습니다. 앞에서 선택한 파서가 JSON·폼·multipart 일반 필드의 값을 ARGS에 넣으면 같은 규칙이 적용됩니다. 허용된 GET 본문도 같은 처리 대상입니다.

③ URL 경로와 XML

경로에 들어가는 Base64url과 XML 값은 대상 변수를 따로 지정합니다.

SecRule REQUEST_FILENAME "@rx (?:\A|/)(?:[A-Za-z0-9_-]{64})+(?:[A-Za-z0-9_-]{0,2}=|[A-Za-z0-9_-]?==|===)(?=/|\z)" \
    "id:11911,phase:1,t:none,deny,status:403,log,msg:'Java4Shell known malformed Base64url path segment',tag:'CVE-2026-114938'"

SecRule XML://text()|XML://@* "@rx (?:\A|[^A-Za-z0-9+/_=-])(?:[A-Za-z0-9+/_-]{64})+(?:[A-Za-z0-9+/_-]{0,2}=|[A-Za-z0-9+/_-]?==|===)(?=\z|[^A-Za-z0-9+/_=-])" \
    "id:11931,phase:2,t:none,deny,status:403,log,msg:'Java4Shell known malformed Base64 token in XML value',tag:'CVE-2026-114938'"

경로 규칙은 Base64url 값이 한 경로 세그먼트 전체를 차지하는 경우를 검사합니다. 표준 Base64의 /, 애플리케이션 고유의 URL 재작성·재디코딩은 실제 라우팅에 맞춘 별도 정책이 필요합니다.

이 예제의 경로 처리는 보안 수정이 적용된 libModSecurity v3, 최소 3.0.12 이후 구현을 전제로 합니다. 이전 버전에는 경로 분리·디코딩 순서에 따른 별도 우회 문제가 있습니다. 운영에는 공급자가 보안 수정을 유지하는 버전을 사용해야 합니다.9

④ 정규식 앞에 디코딩을 무조건 추가하지 않습니다

공통 검색식은 표준 Base64와 Base64url 문자 집합을 넓게 포함합니다. 전체 Base64 문법이나 JWT의 서명을 검증하는 식은 아니므로 정상 트래픽의 매칭 여부를 확인해야 합니다.

파싱된 쿼리·폼·JSON 값에는 t:none을 사용합니다. 이미 해석된 값에 URL 디코딩을 다시 일괄 적용하면 애플리케이션과 해석이 달라질 수 있습니다. t:base64Decode를 먼저 수행하면 검사하려는 원래 패딩 구조도 사라집니다.

현재 경로 변수 REQUEST_FILENAME도 percent-decoded 경로를 담으므로, 이 예제에서는 추가 URL 디코딩을 하지 않습니다.5

⑤ 64의 배수 조건을 유지하는 이유

공통식의 (?:[A-Za-z0-9+/_-]{64})+를 (?:[A-Za-z0-9+/_-]{4}){16,}로 바꾸면 탐지 범위가 넓어집니다. 그러나 더 많은 비정상 문자열에 일치한다는 사실만으로 기존 식에 같은 취약점의 우회가 있다고 판단할 수는 없습니다.

OpenJDK의 원인 설명에 따르면 L_finalBit은 64바이트 처리 후 남은 1~63바이트 전체를 처리합니다. 출력 길이의 초기값은 floor(잔여 길이 / 4) × 3이며, 잔여 길이가 4보다 짧아 초기값이 0인 상태에서 패딩 길이를 빼면 음수가 됩니다. 최종 수정도 length < 4인 경우 Java의 일반 처리 경로로 보내는 가드를 추가합니다.810

다음은 데이터 문자 뒤에 X=를 붙였을 때의 계산입니다. 해당 벡터 처리 경로에 도달했다고 가정한 원인 비교이며, 모든 문자열이 실제 공격에 성공한다는 뜻은 아닙니다.

No. X= 앞 데이터 문자 수 전체 길이 64바이트 처리 후 잔여 길이 패딩 반영 출력 길이
1 64 66 2 floor(2/4) × 3 − 1 = −1
2 68 70 6 floor(6/4) × 3 − 1 = 2
3 72 74 10 floor(10/4) × 3 − 1 = 5

68·72자 접두부의 경우에는 잔여 6·10바이트를 기준으로 계산합니다. 마지막 불완전한 4문자 단위만 다시 떼어 동일한 음수 계산을 수행한다는 설명은 위 구현과 맞지 않습니다. 이 문서의 공통식은 64의 배수 조건을 유지합니다. 68·72자 뒤의 비정상 패딩 등 더 넓은 문법 위반은 아래의 지정 필드 검사로 거부합니다.


🎯 실제 Base64 필드에는 정상 문법을 적용합니다

Base64를 디코딩하는 핵심 API에는 공통 패턴 검사와 지정 필드의 전체 문법 검사를 함께 적용해야 합니다. 공통 패턴만으로는 잘못된 패딩 뒤에 추가 데이터가 붙는 경우 등 모든 문법 위반을 다루지 못합니다.

예를 들어 64개의 데이터 문자 + X= + 추가 데이터 같은 형태는 공통식의 오른쪽 경계 조건과 일치하지 않을 수 있습니다. 이 경계를 없애면 정상 패딩의 일부만 탐지하는 오탐이 생길 수 있으므로 유지하고, 패딩 뒤 데이터와 중간 패딩은 지정 필드 전체의 허용 문법으로 거부합니다. 이를 흔히 Tail Injection이라고 부르더라도, 공통식의 비검출이 곧 실제 Java4Shell 악용 가능성을 입증하는 것은 아닙니다. 디코더에 최종 전달되는 값과 실행 경로는 별도 확인 대상입니다.

예를 들어 /api/decode가 다음 세 형식을 지원하고, payload를 표준 Base64로 처리한다고 가정하겠습니다. 아래 값 TQ==는 정상적인 간단한 예시입니다.

No. 전송 방식 정상 요청 예 필드 검사 대상
1 GET 쿼리 /api/decode?payload=TQ%3D%3D ARGS:payload
2 POST·PUT·PATCH 폼 payload=TQ%3D%3D ARGS:payload
3 POST·PUT·PATCH JSON {"payload":"TQ=="} ARGS:json.payload

이 경우 다음 규칙을 추가합니다.

SecRule REQUEST_FILENAME "@streq /api/decode" \
    "id:11951,phase:2,t:none,deny,status:403,log,msg:'Invalid standard Base64 in designated payload field',tag:'CVE-2026-114938',chain"
    SecRule ARGS:payload|ARGS:json.payload "!@rx \A(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}(?:==)?|[A-Za-z0-9+/]{3}=?)?\z" "t:none"

chain으로 경로를 먼저 확인하고, 해당 API의 payload가 허용 문법에 맞지 않으면 차단합니다. GET·POST·PUT별로 같은 정규식을 복제할 필요가 없습니다. 실제 API 경로와 필드명을 지정하면 됩니다.

이 문법은 정상 패딩과 패딩 생략을 허용하며, 빈 값도 허용합니다. 필수 값·빈 값 금지·중복 파라미터 처리는 API 계약에 따라 추가해야 합니다. JSON 중첩 필드의 실제 변수명, 같은 디코더로 연결되는 별칭과 rewrite 경로도 확인해야 합니다.

Base64url 필드는 문자 집합을 분리합니다

SecRule REQUEST_FILENAME "@streq /api/token" \
    "id:11952,phase:2,t:none,deny,status:403,log,msg:'Invalid Base64url in designated token field',tag:'CVE-2026-114938',chain"
    SecRule ARGS:token|ARGS:json.token "!@rx \A(?:[A-Za-z0-9_-]{4})*(?:[A-Za-z0-9_-]{2}(?:==)?|[A-Za-z0-9_-]{3}=?)?\z" "t:none"

표준 Base64와 Base64url은 허용 문자 집합이 다릅니다. Java의 MIME 디코더는 일부 비알파벳 문자를 무시하므로, MIME 입력에는 위의 일반 필드 규칙을 그대로 적용하지 않습니다.11

또한 전체 JWT는 하나의 Base64url 값이 아닙니다. Bearer라는 접두어만 보고 위 규칙을 모든 인증 토큰에 적용해서도 안 됩니다. 토큰 형식에 맞는 구성요소 검사와 서버의 인증·서명 검증은 별도로 유지해야 합니다.

JSON 배열·중첩 객체는 실제 변수명으로 지정합니다

위의 기본 예제는 payload와 token이 단일 문자열인 API를 가정합니다. payload의 문자열 배열을 받아 각 원소를 디코딩하는 API라면 배열 원소도 지정 필드 검사에 포함해야 합니다. 공통 규칙 11930은 이미 ARGS 전체를 검사하지만, 단일 대상인 ARGS:json.payload만으로는 배열 원소의 전체 문법 검사까지 수행되지 않습니다.

확인한 libModSecurity v3의 공식 구현은 배열 경로에 .array_와 인덱스를 붙입니다. 다음 이름을 기준으로 대상식을 작성하되, 배포된 엔진에서 무해한 테스트로 실제 생성 이름을 확인합니다. .0, .1 형식으로 단정해서는 안 됩니다.1213

No. JSON 구조 확인한 v3 구현의 대상 이름
1 {"payload":"TQ=="} ARGS:json.payload
2 {"payload":["TQ==","TWE="]} ARGS:json.payload.array_0, ARGS:json.payload.array_1
3 {"items":[{"payload":"TQ=="}]} ARGS:json.items.array_0.payload

단일 문자열과 바로 아래의 문자열 배열을 함께 지원한다면, 11951의 하위 규칙을 다음으로 교체합니다. 같은 ID의 시작 규칙을 추가로 복제하는 방식이 아닙니다.

    SecRule ARGS:payload|ARGS:json.payload|ARGS:/\Ajson\.payload\.array_[0-9]+\z/ "!@rx \A(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}(?:==)?|[A-Za-z0-9+/]{3}=?)?\z" "t:none"

이 대상식은 객체 배열·다차원 배열·모든 중첩 필드를 자동으로 포함하지 않습니다. 실제 JSON 경로를 확인해 필요한 필드만 추가합니다. 문자열 타입, 필수 값, 빈 배열, 중복 키와 허용 객체 구조는 API 스키마에서 검증해야 합니다. 단일 문자열만 받는 API라면 배열을 허용하도록 바꾸지 말고 스키마에서 거부합니다.

경로 별칭도 같은 디코더로 연결되는지 확인합니다

REQUEST_FILENAME의 percent decoding과 애플리케이션의 최종 라우팅은 별개입니다. @streq /api/decode는 정확한 경로만 검사하므로, 다른 경로도 같은 디코더에 연결된다면 그 경로까지 동일한 필드 정책이 필요합니다.

t:normalizePath는 연속 슬래시와 .·.. 경로 요소를 정리합니다. 끝 슬래시나 ;jsessionid를 모두 제거하는 변환자는 아닙니다. NGINX의 location 매칭에도 자체 URI 정규화가 적용되므로 WAF의 경로 조건과 결과가 같다고 가정하지 말고 실제 설정을 대조해야 합니다.1415

No. 경로 형태 적용 기준
1 /api//decode, /api/./decode, /api/x/../decode 동일한 API로 라우팅되는 환경이면 경로 조건의 t:normalizePath 적용 검토
2 /api/decode/ 같은 핸들러로 연결됨을 확인한 경우에만 끝 슬래시 허용
3 /api/decode;jsessionid=1 프레임워크·컨테이너의 허용·제거·거부 동작을 확인해 명시적으로 처리
4 /api;a=b/decode와 다른 matrix parameter 서비스가 지원하는 경로 계약에 맞춰 처리. 일괄 제거하지 않음
5 rewrite·별칭 URL 같은 디코더에 연결되는 모든 실제 경로에 정책 적용

중복 슬래시·dot segment가 정규화되고 끝 슬래시도 같은 API로 처리되는 환경을 확인했다면, 11951의 시작 조건은 다음과 같이 바꿀 수 있습니다. 바로 아래의 Base64 값 검사에는 계속 t:none을 사용합니다.

SecRule REQUEST_FILENAME "@rx \A/api/decode/?\z" \
    "id:11951,phase:2,t:none,t:normalizePath,deny,status:403,log,msg:'Invalid standard Base64 in designated payload field',tag:'CVE-2026-114938',chain"

경로 범위를 바꿀 때는 필드 규칙 11951·11952와 Content-Type·Content-Encoding 규칙 11954~11956을 함께 맞춰야 합니다. 제공한 field-policy-normalized-array.conf.example에는 이 조건부 경로 처리와 payload 직접 배열 검사를 모두 반영했습니다. 기본 field-policy.conf.example과 둘 중 하나만 선택하며, 두 파일은 같은 규칙 ID를 사용하므로 함께 Include하지 않습니다. 세미콜론·matrix parameter와 추가 rewrite 경로는 이 대체 예제가 자동 처리하지 않으므로, 허용하는 별칭에 같은 정책을 추가하거나 미지원 경로 형식을 거부합니다.


🚧 검사 한도와 파싱 실패도 정책에 포함합니다

본문 일부만 검사한 뒤 나머지를 전달한다면 공격 값이 검사 밖에 놓일 수 있습니다. 파싱에 실패한 요청을 그대로 허용하는 구성에서도 애플리케이션과 WAF의 해석 차이가 생깁니다.

아래는 1 MiB 본문, 인자 1000개를 사용하는 예제 설정입니다. 정상 대용량 업로드를 제공하는 서비스는 실제 허용 범위에 맞춰 값을 조정해야 합니다.

SecRequestBodyLimit 1048576
SecRequestBodyNoFilesLimit 1048576
SecRequestBodyLimitAction Reject
SecArgumentsLimit 1000

SecRule INBOUND_DATA_ERROR "@eq 1" \
    "id:11920,phase:2,t:none,deny,status:413,log,msg:'Request body inspection limit exceeded'"

SecRule REQBODY_ERROR "@eq 1" \
    "id:11921,phase:2,t:none,deny,status:400,log,msg:'Request body parsing failed'"

SecRule &ARGS "@ge 1000" \
    "id:11923,phase:2,t:none,deny,status:400,log,msg:'Argument inspection limit reached'"

SecArgumentsLimit와 인자 수 거부 규칙의 숫자는 함께 바꿉니다. 위 설정은 보수적으로 1000개에 도달한 요청부터 거부합니다. 본문 검사 한도 초과는 엔진이 먼저 처리하면 403, 오류 규칙에서 처리하면 413이 될 수 있습니다. 중요한 결과는 검사하지 못한 요청을 원본 서버로 보내지 않는 것입니다.165

전체 예제에는 중복 Content-Type, URLENCODED 오류, multipart 엄격 검사 실패, 정규식 실행 오류·한도 초과를 거부하는 규칙도 포함했습니다. 이 오류 규칙은 관련 탐지 규칙과 함께 배치해야 합니다.

지정 API에는 허용 Content-Type도 정해야 합니다. JSON·폼만 받는 API라면 본문이 있는데 Content-Type이 없거나 미지원 형식인 경우 거부합니다. 압축 본문을 지원한다면 압축 해제와 검사 순서를 일치시켜야 하며, 지원하지 않는 API에서는 거부합니다. 파일의 두 예시 API는 JSON·폼만 허용하고 미지원 압축을 거부하도록 작성했습니다.

본문 크기 제한은 Base64 문법 검사를 대신하지 않습니다. 작은 입력도 취약 경로에 도달할 수 있으므로, 정상 서비스에 맞는 크기 제한과 입력 값 검사를 함께 적용해야 합니다.2

Rule ID 요약

기존 CRS와 통합할 때는 아래 ID의 충돌 여부와 적용 순서를 확인합니다. 1195111956은 서비스의 경로·필드 계약에 맞춰 선택한 예제이며, 1198111987은 테스트 환경에서만 임시로 사용하는 스모크 규칙입니다.

No. Rule ID 기능 Phase 동작·상태 코드
1 11903 중복 Content-Type 거부 1 차단·400
2 11901 JSON 본문 프로세서 선택 1 pass·차단 없음
3 11902 XML 본문 프로세서 선택 1 pass·차단 없음
4 11910 헤더·쿠키·쿼리의 공통 패턴 1 차단·403
5 11911 Base64url 경로 세그먼트 1 차단·403
6 11919 phase 1 정규식 오류·한도 초과 1 차단·400
7 11920 본문 검사 한도 초과 2 차단·413, 엔진 선행 거부 시 403 가능
8 11921 본문 파싱 실패 2 차단·400
9 11922 multipart 엄격 검사 실패 2 차단·400
10 11923 인자 수 한도 도달 2 차단·400
11 11924 URLENCODED 파싱 오류 2 차단·400
12 11930 파싱된 ARGS의 공통 패턴 2 차단·403
13 11931 XML 텍스트·속성의 공통 패턴 2 차단·403
14 11932 원시 본문의 보조 패턴 검색 2 차단·403
15 11990 공통 본문 규칙 뒤 정규식 오류 확인 2 차단·400
16 11951 지정 payload의 표준 Base64 문법 2 차단·403
17 11952 지정 token의 Base64url 문법 2 차단·403
18 11954 지정 API 본문의 Content-Type 누락 2 차단·415
19 11955 지정 API 본문의 미지원 Content-Type 2 차단·415
20 11956 지정 API의 미지원 Content-Encoding 1 차단·415
21 11999 지정 필드 규칙 뒤 정규식 오류 확인 2 차단·400
22 11981~11983 쿼리·헤더·쿠키 파서 스모크 1 테스트용 차단·403
23 11984~11986 폼·JSON·XML 파서 스모크 2 테스트용 차단·403
24 11987 JSON 직접 배열 원소 파서 스모크 2 테스트용 차단·403

⏱️ 요청을 전달하기 전에 검사 결과를 확정해야 합니다

Java4Shell의 현재 요청을 차단하려면 WAF가 검사 결과를 확정한 뒤 원본 Java 서버로 요청을 전달해야 합니다. 요청을 먼저 전달하고 별도 프로세스나 AI가 나중에 분석하는 구성은 해당 요청의 디코더 도달을 사전에 막지 못합니다.

No. 처리 방식 해당 요청에 대한 효과
1 요청 검사 완료 후 동기 차단 공격 입력이 Java 서버에 도달하기 전에 거부
2 요청을 먼저 전달한 뒤 비동기 분석 후속 요청 차단·서버 조사·격리에 활용
3 응답 단계 차단 검사한 응답의 외부 전달 억제. 이미 발생한 서버 처리를 되돌리지는 못함
4 서버 행위 분석·EDR 연계 Java 프로세스와 파일·계정·외부 연결의 이상 행위 확인

PLURA-WAF 운영에서도 본문 임계 초과·URL 예외 정책이 실제로 어떤 전달 순서를 만드는지 확인해야 합니다. 취약한 디코더로 이어지는 경로에는 요청 단계의 동기 차단이 적용되어야 합니다. 비동기 분석과 서버 행위 분석은 그 이후의 조사와 대응에 활용합니다.

NGINX에서는 보호 대상에 WAF를 연결합니다.

modsecurity on;
modsecurity_rules_file /etc/nginx/modsecurity/main.conf;
proxy_request_buffering on;

ModSecurity의 main.conf에는 공통 규칙 파일을 포함합니다.

Include /etc/nginx/modsecurity/java4shell.conf

SecRule은 NGINX 설정 본문이 아니라 연결된 ModSecurity 파일에 넣습니다. 요청 버퍼링만 켜는 것으로 차단이 완성되지는 않습니다. SecRuleEngine On과 phase 2의 실제 차단이 함께 동작해야 합니다.1718

기존 CRS와 설정을 유지하며 통합하고 규칙 ID 충돌을 확인합니다. 특히 phase 1의 allow나 allow:request는 뒤의 본문 검사 전체를 생략시킬 수 있습니다. Include 순서만으로 해결되지 않으므로 전체 허용·skip·ctl:ruleEngine=Off·ctl:requestBodyAccess=Off 예외를 함께 점검해야 합니다.19

정상 트래픽을 확인하며 단계적으로 적용합니다

헤더·쿠키 전체를 검색하는 11910은 레거시 토큰과 사용자 정의 헤더에서도 일치할 수 있습니다. 다음 순서로 적용 범위와 오탐을 확인합니다.

  1. 테스트 환경에서 정상 요청을 대조합니다. 로그인·세션 갱신·API·업로드와 대표적인 헤더·쿠키를 포함하고, Base64를 실제로 디코딩하는 경로를 확인합니다.
  2. 보호를 유지한 상태에서 제한적으로 관측합니다. 운영에서 특정 규칙을 잠시 탐지 전용으로 관측해야 한다면 먼저 JVM 패치·검증된 임시 완화 또는 다른 검증된 차단 계층으로 해당 경로를 보호하고, 관측 범위와 종료 시점을 정합니다. 전체 SecRuleEngine을 DetectionOnly로 바꾸면 파싱 실패·검사 한도 초과의 차단까지 비활성화될 수 있으므로 이 문서의 Fail-Closed 구성으로 볼 수 없습니다.1916
  3. 예외는 확인한 대상에 한정합니다. 규칙 ID·정확한 헤더/쿠키 이름·API 범위를 기록하고, 해당 값이 디코더에 전달되는지 확인한 뒤 필요한 대상만 조정합니다. Cookie 원문 헤더와 파싱된 REQUEST_COOKIES가 함께 검사될 수 있으므로 실제 매칭 변수를 확인합니다. 전체 요청 허용이나 보호 API의 일괄 검사 해제는 피합니다.
  4. 차단 전환과 재검증을 완료합니다. 정상 요청의 통과, 의도한 규칙 ID의 거부, 원본 서버 미도달을 확인하고 예외의 담당자·검토 기한을 남깁니다.

🧪 규칙 등록 이후에는 무엇을 검증해야 할까요?

정규식의 일치 결과와 실제 HTTP 요청의 차단 결과는 구분해 확인해야 합니다.

제공한 기본 설정의 7개 규칙에서 정규식을 추출해 오프라인 PCRE2로 검사한 결과, 2,864개 사례의 일치·불일치 결과가 설정한 기대값과 일치했습니다. 기존 2,464건에 68·72자 접두부, 패딩 뒤 추가 데이터, 대응하는 정상 값 등 400건을 추가했습니다. 정상 Base64, 공개된 비정상 꼬리, 경로 세그먼트, 지정 필드의 허용 문법과 탐지 범위를 확인하기 위한 알려진 비검출 사례를 포함합니다.

No. 검증 범위 결과·확인 사항
1 정규식 매칭 기본 설정 7개 규칙, 2,864개 매칭 사례의 기대값 일치
2 ModSecurity 설정 로드·chain·변환·대상 선택 해당 검사 수치에 포함되지 않음. 대체 경로·배열 설정도 실제 배포 환경에서 확인
3 GET·POST·PUT·PATCH의 파서 동작 무해한 테스트 문자열이 올바른 변수와 규칙 ID에 도달하는지 확인
4 실제 요청 거부 WAF의 응답과 원본 서버 미도달을 함께 확인
5 서비스 영향 정상 로그인·API·업로드가 의도대로 동작하는지 확인

이 결과는 실제 JVM 취약점 재현이나 모든 변형 공격 차단을 검증한 수치가 아닙니다. 정규식 결과 파일에는 알려진 비검출 범위도 별도로 기록했습니다.

68·72자 접두부와 패딩 뒤 데이터의 일부 사례는 공통식의 비검출을 기대값으로 기록하고, 지정 필드 문법에서는 거부 조건임을 확인했습니다. 비검출 사례의 검사 통과는 공격 차단 성공이나 안전한 입력 판정을 뜻하지 않습니다. 이 수치에는 JSON 배열 변수의 생성, 대상 선택, 경로 정규화와 실제 upstream 차단이 포함되지 않습니다.

공격 입력 없이 JSON 파서를 확인하는 방법

별도 테스트 WAF에서 다음 임시 규칙을 사용하면 무해한 문자열로 JSON 파싱과 해당 규칙의 동작을 확인할 수 있습니다. 이 규칙은 검증 후 제거합니다.

SecRule ARGS:json.payload "@streq PLURA_WAF_PARSER_TEST" \
    "id:11985,phase:2,t:none,deny,status:403,log,msg:'Parser smoke: JSON payload'"

다음 주소는 별도로 구성한 로컬 테스트 WAF 예시입니다. 실제 테스트 주소를 사용하고, /__waf_parser_test는 테스트용 upstream으로 연결합니다.

WAF_TEST_ORIGIN='http://127.0.0.1:18080'

curl --noproxy '*' -i -X PUT \
  -H 'Content-Type: application/json' \
  --data '{"payload":"PLURA_WAF_PARSER_TEST"}' \
  "$WAF_TEST_ORIGIN/__waf_parser_test"

curl --noproxy '*' -i -X PATCH \
  -H 'Content-Type: application/merge-patch+json' \
  --data '{"payload":"PLURA_WAF_PARSER_TE\u0053T"}' \
  "$WAF_TEST_ORIGIN/__waf_parser_test"

두 요청은 JSON 파싱 후 같은 값을 가집니다. 403 응답, 규칙 ID 11985, 원본 서버 미도달이 함께 확인되어야 합니다. 다른 규칙이 먼저 거부한 403을 JSON 파서 성공으로 판단하면 안 됩니다. 정상 문자열 요청은 테스트용 upstream에 도달하는지도 비교합니다.

같은 방식으로 GET 쿼리, POST·PUT 폼, 쿠키, 헤더, XML을 확인합니다. nginx -t의 성공은 설정 문법 확인이며 파서와 차단 동작의 확인까지 대신하지는 않습니다.

JSON 배열의 이름과 대상 선택도 별도로 확인합니다

배열을 지원하는 API에는 다음 임시 규칙을 사용합니다. marker인 UExVUkFfQVJSQVlfVEVTVA==는 짧고 정상적인 Base64이므로 지정 필드의 허용 문법과 충돌하지 않습니다.

SecRule ARGS:/\Ajson\.payload\.array_[0-9]+\z/ "@streq UExVUkFfQVJSQVlfVEVTVA==" \
    "id:11987,phase:2,t:none,deny,status:403,log,msg:'Parser smoke: JSON array payload',logdata:'%{MATCHED_VAR_NAME}'"
curl --noproxy '*' -i -X PUT \
  -H 'Content-Type: application/json' \
  --data '{"payload":["TQ==","UExVUkFfQVJSQVlfVEVTVA=="]}' \
  "$WAF_TEST_ORIGIN/__waf_parser_test"

기대하는 결과는 403, 규칙 ID 11987, 일치 변수 ARGS:json.payload.array_1, 테스트용 upstream 미도달입니다. marker를 첫 번째 원소로 옮기면 array_0인지 확인합니다. 배열 대상식만 정규식 엔진에서 검사한 결과로는 실제 JSON 파서가 그 변수를 생성했음을 입증할 수 없습니다.

경로 별칭은 같은 테스트 환경에서 정상적인 짧은 값으로 실제 라우트를 먼저 확인합니다. 그 뒤 payload에 @처럼 짧은 문법 위반 값을 넣어 해당 별칭에서 11951이 거부하는지 확인하고, Content-Type·Content-Encoding 거부도 같은 별칭에 적용되는지 확인합니다. 시험에는 취약 JVM 대신 테스트용 upstream을 사용하며, 경로가 클라이언트에서 먼저 정규화되지 않도록 전송된 요청 경로도 확인합니다.


✅ WAF 보호와 Java 업데이트를 함께 완료합니다

이 규칙이 검사하는 범위는 WAF가 실제로 해석할 수 있는 HTTP 입력입니다. MIME·중첩 인코딩·업로드 파일 내부·압축 본문·WebSocket 업그레이드 이후 메시지에는 별도 처리가 필요합니다. Java가 외부 서버에서 받는 데이터와 내부 메시지 등 인바운드 WAF를 거치지 않는 경로도 있습니다.20

Calif는 악성 서버에 TLS로 접속하는 Java 프로그램의 클라이언트 측 악용 사례도 보고했습니다. 외부에 서비스 포트를 열지 않은 프로그램도 해당 실행 조건과 입력 경로를 점검해야 하며, 인바운드 WAF 밖에서 데이터를 받는 클라이언트 런타임의 패치·완화도 확인해야 합니다.2

따라서 운영에서는 다음 작업을 병행합니다.

No. 담당 영역 완료 기준
1 WAF 보호 API와 입력 위치를 지정하고 원본 서버 전달 전 차단 확인
2 애플리케이션 Base64 필드·디코더 종류·허용 형식과 중첩 처리 경로 확인
3 Java 런타임 수정 버전 적용 또는 검증된 JVM 임시 완화 후 재시작·실제 반영 확인
4 운영·관제 정상 서비스 영향과 Java 프로세스의 이상 행위 확인

즉시 패치하기 어려운 환경은 공급자가 안내한 JVM 임시 완화를 검토하고, 실제 서비스가 사용하는 런타임에 적용됐는지 확인합니다. 내장 JDK/JRE와 컨테이너도 수정 대상에서 빠지지 않아야 합니다.1

실행 중인 서비스의 빌드와 옵션을 확인합니다

셸에서 실행한 java -version은 그 셸이 선택한 Java의 정보입니다. 서비스가 다른 경로나 컨테이너의 Java를 사용한다면 이 결과만으로 패치 완료를 판단할 수 없습니다. 실행 경로와 배포판·전체 빌드를 확인하고, 지원되는 환경에서는 대상 프로세스의 PID로 다음 정보를 조회합니다.21

No. 확인 대상 명령 예시
1 실행 중인 JVM의 버전·빌드 jcmd <PID> VM.version
2 JVM 시작 명령과 전달된 인수 jcmd <PID> VM.command_line
3 현재 JVM 플래그 값 jcmd <PID> VM.flags -all

<PID>는 해당 서비스 프로세스의 실제 PID로 바꿉니다. jcmd는 대상 JVM과 같은 머신에서 동일한 유효 사용자·그룹 권한으로 사용하며, 컨테이너는 해당 실행 환경과 PID를 확인해야 합니다. 도구가 없거나 진단 연결이 제한되면 서비스 관리자·컨테이너 설정과 실제 프로세스 실행 경로를 대조합니다. 재시작 후에는 새 프로세스의 빌드와 완화 옵션을 다시 확인해야 합니다.21

Java 8도 배포판과 빌드를 구분합니다

Java 메이저 버전만으로 점검 대상을 제외하지 않습니다. Oracle의 해당 CVE 영향 목록에는 Java 8 Enterprise Performance Pack의 8u511b33-perf도 포함됩니다. 2026년 11월 수정 릴리스는 8u513-perf, 전체 버전은 1.8.0_513-perf-b4입니다. 일반 Java 8과 EPP의 -perf 빌드를 구분하고, 다른 OpenJDK 배포판에는 각 공급자의 해당 CVE 권고와 수정 빌드 기준을 적용합니다.322

운영·관제에서는 비정상 Base64 입력의 반복이나 JVM 비정상 종료를 조사 단서로 사용합니다. 이 현상만으로 RCE 성공을 확정하지 않고, 같은 시각의 WAF 로그·원본 전달 여부·Java 오류·프로세스·파일·외부 연결 기록을 대조합니다.

📌 대응 원칙

Java4Shell WAF 대응은 검사할 위치, 허용할 문법, 차단할 시점을 구체적으로 정하는 작업입니다. GET·POST·PUT·PATCH의 입력을 적절히 파싱하고, 알려진 비정상 패딩과 지정 필드의 문법 위반을 Java에 전달하기 전에 거부해야 합니다.

WAF는 검사 가능한 공격 입력의 도달을 막습니다. Java 패치는 취약한 실행 경로를 수정합니다. 두 조치를 병행하고 실제 동작으로 완료 여부를 확인해야 합니다.


📦 규칙과 검증 자료

실습 자료 java4shell-waf-rules.zip에는 다음 파일이 포함되어 있습니다. 이 글의 코드는 전체 설정의 주요 발췌이며, 실제 적용에는 전체 설정을 통합해야 합니다.

No. 파일 내용
1 java4shell.conf 파서 선택, 공통 탐지, 검사 한도·오류 거부
2 field-policy.conf.example API 경로와 Base64 필드 문법 검증
3 field-policy-normalized-array.conf.example 확인된 경로 정규화·끝 슬래시와 payload 직접 배열의 조건부 대체 예제
4 nginx-integration.conf.example NGINX 연결 설정
5 tests/parser-smoke.conf.example JSON 배열을 포함한 무해한 파서 확인 규칙
6 tests/verify_patterns.py 오프라인 PCRE2 검증기
7 tests/regex-results.json 검사 결과와 미검증 범위
8 README.md, SHA256SUMS 적용 설명과 파일 무결성 확인

📚 PLURA-Blog


📚 참고 자료


  1. Microsoft — Addressing Java4Shell CVE-2026-114938: upgrade guidance and Azure WAF mitigations. HTTP 입력 위치별 WAF 규칙과 런타임 업데이트. ↩︎ ↩︎ ↩︎

  2. Calif — Java4Shell. 취약점 원인, 마지막 단위와 비정상 패딩 처리, JVM 완화. ↩︎ ↩︎ ↩︎ ↩︎ ↩︎ ↩︎

  3. Oracle — November 2026 Critical Security Patch Update. Java SE Risk Matrix의 CVE-2026-114938 개별 행, CVSS 3.1 평가와 영향 제품·빌드. ↩︎ ↩︎

  4. ModSecurity — Processing Phases. ↩︎

  5. ModSecurity — transaction.cc. URI, ARGS와 본문 처리 구현. ↩︎ ↩︎ ↩︎

  6. ModSecurity — Variables. ↩︎

  7. Oracle Java SE 17 — Base64.Decoder. 패딩 생략과 정상 패딩 요구. ↩︎

  8. OpenJDK — PR #32781, AVX-512 Base64 decoder overwrites output buffer on short padded tail. 잔여 길이와 출력 길이 계산에 관한 원인 설명. ↩︎ ↩︎

  9. OWASP ModSecurity — CVE-2024-1019. 경로 해석에 관한 이전 버전의 우회 문제와 수정 범위. ↩︎

  10. OpenJDK — 최종 수정 커밋 5177a70. length < 4에서 일반 처리 경로로 분기하는 수정. ↩︎

  11. Oracle Java SE 17 — Base64. Basic·URL-safe·MIME 구분. ↩︎

  12. ModSecurity — JSON 파서 구현. 배열 이름에 .array_와 인덱스를 추가하는 구현. ↩︎

  13. ModSecurity — Issue #2942, JSON 변수명 차이. v2·v3 차이와 v3 json.foo.array_0.bar에 관한 관리자 설명. ↩︎

  14. ModSecurity — Transformation Functions. normalizePath와 변환 적용 범위. ↩︎

  15. NGINX — location. location 매칭 전 URI 정규화. ↩︎

  16. ModSecurity — Configuration Directives. 본문·인자 한도와 검사 설정. ↩︎ ↩︎

  17. ModSecurity-nginx 공식 connector. ↩︎

  18. NGINX — proxy_request_buffering. ↩︎

  19. ModSecurity — Actions. allow·chain·ctl 동작. ↩︎ ↩︎

  20. Cloudflare — How Cloudflare WAF helps protect against Java4Shell. WAF 보호 범위와 인바운드 HTTP 밖의 경로. ↩︎

  21. Oracle — The jcmd Command. 실행 중인 JVM의 버전·명령행·플래그 조회와 실행 권한 조건. ↩︎ ↩︎

  22. Oracle — Java SE 8u513 Enterprise Performance Pack Release Notes. EPP 수정 릴리스의 전체 빌드 문자열. ↩︎