React2Shell 취약점 스캐너

React Server Components(RSC) 및 Next.js 원격 코드 실행 취약점(CVE-2025-55182 및 CVE-2025-66478)을 탐지하는 안전하고 비침습적인 스캐너입니다.

개요

이 스캐너는 조직이 자신의 웹 서비스가 React2Shell 취약점에 노출되어 있는지 식별할 수 있도록 돕습니다. 이 취약점은 React Server Components와 Next.js를 사용하는 애플리케이션에 영향을 미치며, 공격자가 특수하게 조작된 multipart 양식 데이터를 통해 원격 코드 실행을 달성할 수 있게 합니다.

중요: 이 스캐너는 안전한 부수 채널(side-channel) 탐지 방법만 사용하며 대상 시스템에서 코드를 실행하지 않습니다.

기능

• 안전한 탐지 방법

  • 변형된 페이로드를 이용한 부수 채널 탐지
  • 코드 실행 없이 취약한 RSC 파싱 감지
  • 실시간 시스템 테스트에 적합한 프로덕션 안전성

• 유연한 스캔 옵션

  • 단일 URL 또는 파일에서 대량 스캔
  • 멀티스레드 동시 스캔
  • 사용자 지정 경로 테스트(예: /_next, /api)
  • 사용자 지정 헤더 지원

• 출력 옵션

  • 색상화된 터미널 출력
  • 취약한 호스트에 대한 JSON 내보내기
  • 상세 분석을 위한 자세한(verbose) 모드
  • 자동화를 위한 조용한(quiet) 모드

설치

요구 사항

• Python 3.9 이상
• pip 패키지 관리자

종속성 설치

pip install -r requirements.txt

또는 수동으로 설치:

pip install requests tqdm urllib3

사용법

기본 스캔

단일 URL 스캔:

python scanner.py -u https://example.com

파일에서 여러 호스트 스캔:

python scanner.py -l hosts.txt

고급 옵션

사용자 지정 경로로 스캔:

python scanner.py -u https://example.com --path /_next --path /api

파일에서 경로 목록으로 스캔:

python scanner.py -u https://example.com --path-file paths.txt

사용자 지정 헤더:

python scanner.py -u https://example.com -H "Authorization: Bearer token" -H "X-Custom: value"

멀티스레드 스캔:

python scanner.py -l hosts.txt -t 20

결과를 JSON으로 내보내기:

python scanner.py -l hosts.txt -o results.json

모든 결과 내보내기(취약하지 않은 호스트 포함):

python scanner.py -l hosts.txt -o results.json --all-results

출력 제어

자세한(verbose) 모드(모든 호스트에 대한 세부 정보 표시):

python scanner.py -l hosts.txt -v

조용한(quiet) 모드(취약한 호스트만 표시):

python scanner.py -l hosts.txt -q

색상 비활성화:

python scanner.py -l hosts.txt --no-color

입력 파일 형식

호스트 파일 (hosts.txt)

한 줄에 하나의 호스트. #로 시작하는 줄은 무시됩니다.

https://example.com
http://test.example.org
another-site.com
# 이것은 주석입니다

경로 파일 (paths.txt)

한 줄에 하나의 경로. 경로는 앞에 /가 없으면 자동으로 추가됩니다.

/_next
/api
/actions
# 주석 줄은 무시됩니다

명령줄 옵션

탐지 로직

안전한 부수 채널 탐지

스캐너는 다음과 같은 비침습적 탐지 방법을 사용합니다:

• 특수하게 제작된 비악성 multipart 양식 데이터 페이로드를 전송
• 취약한 RSC(React Server Components) 파싱에서 오류 응답을 유도
• 여러 취약점 지표를 탐색

탐지 패턴

1. JavaScript 오류 메시지

   • SyntaxError - 양식 데이터의 잘못된 JSON 파싱을 나타냄
   • Unexpected token - 취약한 RSC 역직렬화를 시사
   • ReferenceError / TypeError - 안전하지 않은 객체 속성 접근을 드러냄

2. RSC 특정 오류 응답

   • text/x-component 콘텐츠 유형을 가진 HTTP 500 상태 코드
   • RSC 헤더 존재(Vary: RSC, Next-Router-State-Tree)
   • 응답 본문의 오류 다이제스트(예: {"digest":"..."})
   • RSC 페이로드 지표($@, 오류 객체)

스캐너는 상세한 오류 메시지(이전 버전)와 구조화된 RSC 오류 응답(최신 버전)을 모두 탐지하여 다양한 Next.js 구현에 걸쳐 포괄적인 적용 범위를 보장합니다.

중요: 이 방법은 대상 시스템에서 어떤 코드도 실행하지 않습니다. 오류 응답을 관찰하여 시스템이 취약한지 여부만 감지합니다.

예제 워크플로

단일 애플리케이션 빠른 점검

python scanner.py -u https://myapp.com

포괄적인 조직 스캔

# 모든 도메인이 포함된 호스트 파일 생성
python scanner.py -l organization-hosts.txt -t 20 -o scan-results.json

여러 경로 스캔

# 공통 Next.js 엔드포인트로 paths.txt 생성
python scanner.py -l hosts.txt --path-file paths.txt -o results.json

인증 헤더로 스캔

python scanner.py -u https://myapp.com -H "Cookie: session=abc123" -H "Authorization: Bearer token"

결과 해석

취약 상태

스캐너는 다음을 감지하면 호스트를 VULNERABLE로 표시합니다:

• 취약한 RSC 파싱을 나타내는 구문 오류
• 양식 데이터 처리 중 예기치 않은 토큰 오류
• 안전하지 않은 속성 접근을 드러내는 참조 또는 유형 오류
• RSC 특정 헤더와 콘텐츠가 있는 HTTP 500 오류
• RSC 응답 형식의 오류 다이제스트
• 취약한 Next.js/RSC 구현의 특징적인 오류 패턴

"취약"의 의미

스캐너가 취약점을 감지하면 다음을 의미합니다:

1. 서버가 변형된 RSC 페이로드를 처리 중입니다 - 특수하게 제작된 양식 데이터를 React Server Components로 수락하고 파싱을 시도하고 있습니다
2. 잘못된 입력 검증 - 애플리케이션이 처리를 시작하기 전에 multipart 양식 데이터를 제대로 검증하지 않습니다
3. RCE 가능성 - 취약한 구성에서 공격자는 이를 악용하여 원격 코드 실행을 달성할 수 있습니다
4. 프로토타입 오염 벡터 - 파싱 취약점은 프로토타입 오염 공격에 활용될 수 있습니다

위험 수준

• CRITICAL: RSC 오류 응답을 보여주는 서버는 악성 페이로드를 적극적으로 처리하고 있습니다
• 영향: 원격 코드 실행, 데이터 도난, 서버 장악
• 악용 가능성: 공개적으로 알려진 익스플로잇이 존재합니다

종료 코드

• 0: 취약점이 발견되지 않음
• 1: 하나 이상의 취약점이 감지됨

보안 고려 사항

1. 권한: 소유하거나 테스트에 대한 명시적 허가를 받은 시스템만 스캔하십시오
2. 안전한 탐지: 이 스캐너는 안전한 부수 채널 탐지만 사용하며 코드를 실행하지 않습니다
3. 속도 제한: 대상에 과부하를 주지 않도록 스레드 수(-t)를 조정하십시오
4. SSL 검증: 테스트에 필요한 경우가 아니면 SSL 검증을 활성화된 상태로 유지하십시오
5. 프로덕션 안전성: 이 스캐너는 프로덕션 시스템에서 사용해도 안전하도록 설계되었습니다

완화 조치

애플리케이션이 취약한 것으로 발견된 경우:

1. 즉시 조치:

   • Next.js를 최신 패치 버전으로 업데이트
   • 모든 React Server Components 검토 및 업데이트
   • 양식 데이터에 대한 입력 검증 구현

2. 장기 보안:

   • 의심스러운 multipart 페이로드를 차단하도록 WAF 규칙 활성화
   • 비정상적인 서버 액션 요청 모니터링
   • 보안 헤더 구현
   • 정기적인 보안 감사

3. 참고 자료:

   • CVE-2025-55182
   • CVE-2025-66478

면책 조항

이 도구는 승인된 보안 테스트 전용입니다. 컴퓨터 시스템에 대한 무단 접근은 불법입니다. 저자는 이 프로그램의 오용 또는 손해에 대해 책임을 지지 않습니다.