Brotli / HTTP2Shell(CVE-2026-111497) 오프라인 노출 및 인벤토리 검사기로, 검증된 에코시스템 전반을 지원합니다. Python 3.10+ 환경에서 동작하며 의존성이나 익스플로잇 페이로드가 필요하지 않습니다.

증거와 함께하는 Brotli 디코더 노출 평가.
http2shell-check는 CVE-2026-111497에 대해 보고된 버전과 컴포넌트 인벤토리를 평가합니다. 이는 HTTP2Shell 또는 Node2Shell이라고도 불리는 Google Brotli 디코더 취약점입니다. 이 이름들은 동일한 근본 결함을 가리킵니다. HTTP/2는 필요하지 않습니다.
네이티브 Brotli, Node.js, Bun, Python Brotli/brotlicffi, Brotli4j, Envoy, Istio, 그리고 정확한 Debian 소스 패키지 스냅샷을 다룹니다. 독립 실행형 Python 검사기는 네트워크 요청을 하지 않고, 디코더를 임포트하지 않으며, 익스플로잇 페이로드를 전송하지 않습니다. 버전 비교는 분류이며 증명이 아닙니다. 익스플로잇 가능성은 항상 not_tested이며, 보고된 수정 버전은 검증된 배포 패치가 아닙니다.
Windows, Linux 또는 macOS에서 Python 3.10+가 필요합니다. 설치할 것은 없습니다. 검사기와 그 테스트는 표준 라이브러리만 사용합니다. python을 사용할 수 없는 경우 python3를 사용하십시오.
git clone https://github.com/CompleTetech-Security/http2shell-check.git
cd http2shell-check
# Assess explicit versions
python http2shell_check.py --component brotli=1.2.0 --format json
python http2shell_check.py --component python-brotli=1.2.1 --component bun=1.4.3
# Assess an inventory and write an offline HTML report
python http2shell_check.py --inventory examples/inventory.json --format html --output report.html
# Assess the current Python environment's installed packages
python collect_python.py > runtime.json
python http2shell_check.py --inventory runtime.json --format json
기존 출력 파일은 --force가 주어지지 않으면 거부됩니다. 실제 인벤토리와 보고서는 Git 외부에 보관하세요. 검사기 파일은 다른 곳에 복사해도 작동합니다. HTML 보고서에 로고를 넣으려면 --logo approved-logo.png를 지정하세요.
최소 하나의 입력을 제공하세요. --component, --inventory, --pip-list, --node-inventory는 반복 및 조합이 가능하며, 각각 독립적인 관측을 생성합니다.
| 입력 | 소스 |
|---|---|
--component PRODUCT=VERSION | 명령줄에서 제공되는 단일 버전. |
--inventory PATH | 표준 다중 컴포넌트 JSON 인벤토리. |
--pip-list PATH | python -m pip list --format=json의 출력; Brotli/brotlicffi 항목만 평가됩니다. |
--node-inventory PATH | 기존 node2shell-check collector v1 파일. |
공통 옵션:
| 옵션 | 기본값 | 동작 |
|---|---|---|
--format csv|json|html | csv | 출력 형식; 모든 형식은 동일한 컴포넌트 발견 사항과 보고서 메타데이터를 담습니다. |
--output PATH | stdout | 완료된 보고서를 원자적으로 게시합니다. |
--force | 꺼짐 | 기존 출력 파일을 교체합니다. 입력, 검사기, 로고 파일은 보호됩니다. |
--brand NAME | CompleteTech LLC | HTML 조직 레이블. |
--logo PATH | 기본 브랜드의 경우 번들된 assets/logo.png(있는 경우) | 최대 1 MiB의 PNG를 삽입합니다. 사용자 지정 브랜드는 기본 로고를 생략합니다. |
--fail-on-finding | 꺼짐 | potentially_affected 또는 unsupported_runtime 결과에 대해 종료 코드 1을 반환합니다. |
--version, --help | 도구 버전 또는 사용법을 출력합니다. |
표준 인벤토리 스키마, 어댑터 세부 정보, 필드 제한, 전체 옵션 및 종료 코드 참조는 docs/REFERENCE.md에 있습니다. 제품 식별자와 버전 규칙은 방법론에 있습니다. 알 수 없는 식별자는 추측된 일치가 아닌 알 수 없는 커버리지를 생성합니다.
| 코드 | 의미 |
|---|---|
0 | 운영 오류 없이 보고서가 작성되었습니다. |
1 | --fail-on-finding 사용 시, 최소 하나의 결과가 potentially_affected 또는 unsupported_runtime입니다. |
2 | 운영 실패: 잘못된 인수, 또는 입력, 수집, 출력 오류. 다른 입력의 유효한 관측은 가능한 한 유지됩니다. |
130 | 중단됨. |
평가 중 중단되면 완료된 컴포넌트 관측이 complete=false로 게시됩니다. 출력 중 중단되면 기존 대상이 보존되며 새 보고서가 남지 않을 수 있습니다. 운영 오류는 평가 결과가 아니며, 부분 보고서는 완전한 보고서가 아닙니다.
HTML 보고서는 오프라인 단일 파일로, 스크립트가 없습니다. 삽입된 로고, 요약 집계, 우선순위가 지정된 컴포넌트 관측, 증거, 미지 항목, 커버리지 격차, 교정 조치, 브랜치 수정, 소스 링크를 포함합니다. 라이트 및 다크 테마에 적응하며 깔끔하게 인쇄됩니다. 사용자 지정 브랜딩에는 --brand "Your Organization" --logo approved-logo.png를 사용하세요.

합성 예제 열기. 스크린샷은 실제 생성된 출력을 보여주며, 어떤 대상도 스캔되지 않았습니다. 좁은 레이아웃과 인쇄 미리보기도 참조하세요.
| 상태 | 의미 |
|---|---|
potentially_affected | 보고된 버전이 검증된 영향 구간 또는 정확한 벤더 패키지와 일치합니다. 실제 배포된 사본과 입력 경로를 검증하세요. |
fixed_version_reported | 버전이 적용 가능한 규칙을 충족합니다. 배포된 패치 상태와 안전성은 검증되지 않은 상태로 남습니다. |
unsupported_runtime | 지원되지 않는 구버전 Node.js 라인은 업그레이드 또는 벤더 검토가 필요합니다. 이는 CVE 확인이 아닙니다. |
unknown | 누락, 분쟁, 조건부, 사용자 지정, 상충 또는 미커버 증거는 검토가 필요합니다. |
알 수 없는 결과는 종료 코드 1을 트리거하지 않지만 눈에 띄게 집계됩니다. 명령이 성공했다고 해서 보안 평가가 깨끗한 것은 아니며, 보고서 건수는 자산 안전성에 대한 판정이 아닙니다. 각 구성 요소 사본은 개별적으로 평가되므로, 수정된 결과가 영향을 받은 사본이나 알 수 없는 사본을 지우는 일은 결코 없습니다.
규칙은 내장되어 있으며 2026-10-25 기준입니다. 이는 오프라인 스냅샷이며 자동으로 갱신되는 피드가 아닙니다. 아래의 각 제품 식별자는 자체 규칙에 따라 평가됩니다:
| 식별자 | 구성 요소 |
|---|---|
brotli | 네이티브 Google Brotli (브랜치별로 독립적으로 수정됨) |
node, bun | Node.js 및 Bun 런타임 |
python-brotli, brotlicffi | PyPI 패키지 |
brotli4j | Java Brotli4j (Maven) |
envoy, istio | Envoy 프록시 및 Istio 메시 |
debian-brotli | 정확한 Debian brotli 소스 패키지 스냅샷 |
식별자별 영향을 받은 버전과 수정된 버전은 방법론에 표로 정리되어 있으며, 그 근거가 되는 1차 출처는 검증된 출처 매트릭스에 있습니다.
주요 경계:
제공되지 않는 것: 완전한 탐색, SBOM 수집, 로드된 코드 증명, 수동적 웹사이트 스캔, 도달 가능성 테스트.
이 도구는 node2shell-check를 보완하며, 해당 도구의 Node.js 인터페이스와 소유권은 변경되지 않습니다. 범위 및 템플릿 동등성을 참조하십시오.
collect_python.py는 실행되는 인터프리터에서 설치된 패키지 메타데이터만 읽습니다. Brotli나 애플리케이션 코드를 임포트하지 않습니다. 검사 권한이 있는 환경에서만 실행하십시오.