Skip to content

About

Snort 3 / Suricata detection rules for Java4Shell (CVE-2026-114938) with synthetic-pcap regression tests. Rules only, no exploit code.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

java4shell-detection

Java4Shell(CVE-2026-114938) 네트워크 탐지 룰(Snort 3·Suricata)과 그 회귀 시험만 다루는 저장소입니다. Snort 3 and Suricata network detection rules for Java4Shell (CVE-2026-114938), with a synthetic-pcap regression test. Rules only — no exploit code.

주의 / Disclaimer 이 룰은 CyberTissue가 공개된 기술 정보와 공개 PoC의 요청 모양을 바탕으로 직접 만들고 직접 시험한 것으로, 계속 업데이트 중입니다. 제3자 검증과 실제 운영 트래픽 오탐 확인은 거치지 않았으니 차단(drop) 대신 탐지(alert) 모드로 먼저 돌려 보세요. Emerging Threats 공식 룰과의 비교는 공식 룰과 비교에 있고, 두 룰은 함께 쓸 수 있습니다. These rules are self-made, self-tested, and continuously updated. They have not been validated by third parties or against production traffic, so run them in alert mode first. A comparison with the official Emerging Threats rules is in the section below; both rule sets can be used together.

취약점 요약

  • OpenJDK HotSpot의 x86-64 Base64 디코딩 최적화 코드(AVX-512 VBMI)가 입력 끝의 '=' 패딩을 처리하다 출력 길이를 잘못 계산해, 디코딩 결과 배열 끝 너머로 62바이트를 덮어쓴다. 발견·명명: Calif.
  • 영향: Java 17(17.0.6 이상)·21·25·27 계열, AVX-512 VBMI를 지원하는 x86-64 CPU(인텔 Xeon Ice Lake 이후, AMD Zen 4 이후). ARM은 해당 없음.
  • 수정: 2026-11-17 오라클·OpenJDK 보안 릴리스(17.0.21, 21.0.13, 25.0.5, 27.0.1 뒤에 ".1"이 붙은 빌드)와 각 배포판의 해당 빌드. Oracle CSPU Nov 2026 · OpenJDK advisory
  • 해설: CyberTissue 노트

룰

파일 엔진 sid
rules/snort3/java4shell.rules Snort 3 9114938(Authorization Basic), 9114939(Authorization Bearer), 9114940(URL 쿼리), 9114941(요청 본문, HUNT), 9114942(그 밖의 헤더, HUNT), 9114943(Cookie, HUNT), 9114944(Basic 안쪽 이중 인코딩, HUNT)
rules/suricata/java4shell.rules Suricata 7 9114938(Authorization Basic·Bearer), 9114940(URL 쿼리), 9114941(요청 본문, HUNT), 9114942(그 밖의 헤더, HUNT), 9114943(Cookie, HUNT), 9114944(Basic 안쪽 이중 인코딩, HUNT)

탐지 대상: 32자 이상의 Base64 값이 정상 패딩이 아닌 '='로 끝나는 요청(=, ==, ===, X=, X==, XY= 꼬리). URL-safe 문자(-, _)와 URL 인코딩(%2B, %2F, %3D)도 본다.

  • 9114938·9114939: Authorization 헤더(Basic·Bearer). JWT처럼 점(.)으로 나뉜 토큰은 각 조각을 따로 본다.
  • 9114940: URL 쿼리 파라미터 값(인코딩 전 원문을 본다).
  • 9114941(HUNT): 요청 본문(텍스트·폼·JSON). 정상 데이터에서 오탐이 날 여지가 가장 커서 사냥용으로 이름을 붙였다. 탐지 모드에서 먼저 돌려 본다.
  • 9114942(HUNT): Authorization과 표준 헤더(Host, User-Agent, Accept 계열, Content-Type, Referer, Origin, Sec-Fetch·Sec-Ch 계열 등)를 뺀 나머지 요청 헤더(예: X-Auth-Token, X-Api-Key). 직접 만든 인증 헤더로 Base64를 받는 애플리케이션을 겨냥한다.
  • 9114943(HUNT): Cookie 값.
  • 러프하게 "Base64처럼 생긴 값이 있으면 모두 탐지"하는 방식은 시험에서 정상 요청의 92%에 경보가 나 쓰지 않는다. 인증, 웹소켓 키, HTTP 서명, Digest, CSRF 토큰, 요청·추적 ID가 모두 Base64 문자로만 이루어져 있어 디코딩 없이는 구분할 수 없다. 그래서 모든 룰이 트리거의 핵심 특징(32자 이상 + 정상 패딩이 아닌 '=' 꼬리)만 본다.

공격 시도를 잡을 뿐 성공 여부는 알려 주지 않는다. sid는 지역 룰 범위로 임의로 붙인 값이니 환경에 맞게 바꾼다.

알려진 공백

tests/known_gaps.json에 있는 케이스는 현재 판이 놓친다.

  • 32자 미만 값. 표준 헤더로 분류해 뺀 헤더(Referer, Origin 등) 안의 값.
  • multipart 업로드 안의 파일 내용, 압축(gzip 등)된 요청 본문, 엔진의 본문 검사 한도를 넘는 큰 본문.
  • 암호화된 HTTPS: TLS를 복호화하는 프록시·WAF·IDS 뒤에 둬야 보인다.
  • 네트워크 룰로 못 보는 경로는 JVM 쪽에서 메운다: java.util.Base64$Decoder의 IllegalArgumentException 폭증, hs_err_pid*.log 크래시 파일, 원인 모를 재시작.

회귀 시험

bash tests/run.sh RESULTS.md
  • tests/fixtures.py가 합성 pcap을 만든다(문서용 주소, 네트워크 전송 없음). 묶음:
    • synthetic: 공개 트리거 모양과 변형, 정상 인증·본문·쿼리, 범위 밖 참고 케이스
    • poc-shape: 공개 PoC 저장소의 소스를 읽어 요청 모양만 옮긴 케이스(PoC는 실행하지 않는다)
    • benign-bulk: 무작위 정상 Basic·Bearer 300건(오탐 측정)
  • Suricata(jasonish/suricata:7.0)와 Snort 3(ciscotalos/snort3) 컨테이너를 --network none으로 돌려 문법 검사와 pcap 실행을 하고, tests/score.py가 채점한다.
  • 통과 기준: 공격형 케이스를 모두 잡고(알려진 공백 제외) 정상 케이스 오탐 0. 알려진 공백을 새로 잡으면 종료 코드 2로 알린다.
  • 룰 파일 첫 줄 주석의 판 번호(# java4shell-detection vX.Y.Z)가 CHANGELOG 최신 판과 같은지 먼저 본다. 릴리스 첨부 파일과 저장소 파일은 같은 내용이다.
  • 최근 결과: RESULTS.md. GitHub Actions가 push마다 같은 시험을 돈다.

공식 룰과 비교

Emerging Threats Open에 2026-11-18자로 Java4Shell 룰 6개(sid 2072829~2072834)가 올라왔다. 같은 시험 pcap을 Suricata 7.0에 돌려 비교했다(2026-11-19, 주소 변수만 any로 바꿈. 공식 룰 원문은 이 저장소에 넣지 않는다). Talos(Snort) 공식 룰은 아직 없다.

룰 묶음 공격형 32건 정상 340건 오탐
이 저장소 v0.6.x(Suricata) 32 0
ET 기본 활성 3개(PoC User-Agent, A×64+=, A×128+=) 16 0
ET 6개 전부(주석 처리된 HUNTING 3개 포함) 22 56
  • ET 기본 활성 룰은 공개 PoC의 고정 문자열(A 반복 뒤 =)을 찾는다. 다른 글자로 된 값, B=·BC=처럼 꼬리 글자가 붙은 모양, URL 인코딩 %3D, 64자가 아닌 길이(32·35·49자), JWT 조각 안 트리거를 놓친다. 대신 오탐이 없다.
  • ET의 주석 처리된 HUNTING 3개(URI·헤더·본문)는 64자 이상 Base64 뒤 = 꼬리를 보지만 전체 길이를 4로 나눈 나머지를 따지지 않아, 정상 패딩(...XYZ=)이 붙은 헤더·본문에서도 울린다(위 56건, 대부분 정상 Basic·Bearer 헤더). ET도 이 룰을 기본으로 끄고 신뢰도 Low로 표시했다.
  • 이 시험 데이터는 이 저장소 룰을 만들며 함께 만든 것이라 이 저장소 쪽에 유리할 수 있다. 운영 트래픽 기준 비교는 아니다.
  • 두 묶음은 함께 쓸 수 있다. ET의 User-Agent 룰(공개 PoC 도구 이름)은 이 저장소에 없는 단서다.

보강 방식

CyberTissue가 공개 PoC·보고서·공식 룰을 계속 모니터링한다. 새 요청 모양이 나오면 poc-shape 케이스로 옮기고, 룰을 고쳐 회귀 시험을 통과하면 반영하고 릴리스 태그를 붙인다. 바뀐 내용은 CHANGELOG와 CyberTissue 노트에 적는다.

이 저장소에는 룰, 합성 시험 데이터 생성기, 채점기만 둔다. 익스플로잇 코드·페이로드·PoC 사본은 두지 않는다.

출처

License

MIT

About

Snort 3 / Suricata detection rules for Java4Shell (CVE-2026-114938) with synthetic-pcap regression tests. Rules only, no exploit code.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages