Node.js rawBody를 통한 Webhook HMAC 검증 무결성 확보

Context

Webhook 검증 시 HTTP 요청 본문의 원본 바이트(Raw Bytes) 보존이 필수적인 상황 분석. Python Werkzeug 기반 프레임워크의 Sequential Stream 처리 구조로 인한 데이터 변형 및 스트림 소멸 문제 식별.

Technical Solution

• Node.js 런타임의 Asynchronous Readable Stream 기반 네트워크 요청 처리 방식 채택
• 프레임워크 수준에서 요청 본문을 가공 전 Native JavaScript Buffer로 캡처하는 Native Cache 구조 활용
• 가공되지 않은 원본 데이터(req.rawBody)와 파싱된 JSON 객체(req.body)를 분리하여 제공하는 Decoupled Architecture 설계
• HMAC-SHA256 서명 검증 시 Mutation 위험이 없는 rawBody를 직접 참조하여 바이트 수준의 무결성 보장
• 애플리케이션 로직에서는 편의성을 위해 파싱된 req.body를 사용하는 이원화된 데이터 접근 전략 수립