환경 구성 및 초기 패킷 분석
MiniMax의 Hailuo AI 웹 클라이언트와 서버 간의 통신을 자동화하기 위해서는 요청 헤더에 포함되는 동적 인증 파라미터를 정확히 생성해야 합니다. 분석 환경으로는 Chrome DevTools와 Burp Suite를 사용합니다. Burp Suite의 Repeater 기능을 통해 요청 헤더의 특정 값을 변조하며 서버의 응답을 관찰함으로써, 인증에 필수적인 핵심 파라미터를 선별합니다.
검색 앵커를 활용한 난독화 코드 우회
패킷 분석을 통해 식별된 주요 파라미터는 다음과 같습니다.
Token: 서버에서 발급하는 정적 인증 값Yy: 클라이언트 사이드에서 동적으로 생성되는 서명 값unix_v,character_id,chat_id: 서명 생성에 사용되는 독립 변수- API 엔드포인트:
/v4/api/chat/msg
난독화된 프론트엔드 번들 파일에서 Token이나 Yy와 같은 일반적인 키워드를 직접 검색할 경우, 날짜 포맷팅 로직(예: yy년)이나 다른 라이브러리 코드로 인해 심각한 노이즈가 발생합니다. 이를 우회하기 위해 API 엔드포인트 경로인 /v4/api/chat/msg를 고유한 검색 앵커(Search Token)로 설정합니다.
해당 문자열을 포함하는 636-f83c0591c5b62750.js 파일을 특정하고, 이 파일 내에서 Token과 Yy가 함께 참조되는 컨텍스트를 분석합니다. 약 5,000줄에 달하는 난독화 코드이므로, 정적 분석만으로는 데이터 흐름을 파악하기 어렵습니다. 이때 LLM을 보조 도구로 활용하여 navigator 객체 및 deviceMemory 속성이 참조되는 의심스러운 함수를 1차적으로 필터링합니다.
브레이크포인트 및 데이터 흐름 추적
필터링된 함수와 URL 쿼리 스트링을 조합하는 로직에 브레이크포인트를 설정합니다. 대상 코드는 다음과 같은 단축 평가 및 문자열 포맷팅 구조를 가집니다.
return (null == e ? void 0 : e.includes("?")) ? "".concat(e, "&").concat(n) : "".concat(e, "?").concat(n)
여기서 Call Stack을 추적하며 Step In 기능을 활용해 Yy 값이 파생되는 원본 문자열 조합 로직에 도달합니다. 동적 디버깅 과정에서 다음 세 가지 주요 변수의 역할을 규명할 수 있습니다.
t: 호스트 도메인을 제외한 API URL 경로 (예:/v4/api/chat/msg)u: 페이로드 본문 데이터를 직렬화한yyBody객체i: 요청 시점의 Unix 타임스탬프 (unix_v와 일치)
yyBody 변수가 초기화되는 모든 지점에 브레이크포인트를 추가하여 할당 프로세스를 역추적합니다. 분석 결과, 이 변수는 U, character_id, chat_id 세 가지 값을 조합하여 생성됨을 확인했습니다. 이 중 character_id와 chat_id는 요청 페이로드에서 추출 가능하지만, U 변수는 런타임 시점에서 undefined 상태를 유지하므로 빈 문자열("")로 처리합니다.
요청 페이로드 및 서명 재구성
파라미터의 종속 관계를 파악한 후, 최종적으로 지문(Fingerprint) 역할을 하는 Yy 값이 MD5 해시 알고리즘을 통해 생성된다는 사실을 확인했습니다. 이를 바탕으로 Python 환경에서 API 요청을 자동화하는 로직을 다음과 같이 재구성할 수 있습니다. 난독화된 변수명을 의미 있는 식별자로 변경하고, 데이터 정제 및 인코딩 로직을 구조화했습니다.
import hashlib
import urllib.parse
import re
import time
def sanitize_message(raw_text):
"""프론트엔드의 커스텀 개행 문자 제거 로직 재현"""
return re.sub(r'(\r\n|\n|\r)', '', raw_text)
def build_signature_payload(bot_id, session_id, unknown_param=""):
"""yyBody 객체의 직렬화 구조 재구성"""
return f"{unknown_param}{bot_id}{session_id}"
def generate_fingerprint(api_path, payload, timestamp):
"""MD5 기반의 클라이언트 서명(Yy) 생성"""
raw_string = f"{api_path}|{payload}|{timestamp}"
return hashlib.md5(raw_string.encode('utf-8')).hexdigest()
def prepare_api_request(message, bot_id, session_id, server_token):
current_timestamp = int(time.time())
api_endpoint = "/v4/api/chat/msg"
# 1. 메시지 데이터 정제 및 공식 URL 인코딩 적용
clean_message = sanitize_message(message)
encoded_message = urllib.parse.quote(clean_message)
# 2. 서명 페이로드 및 최종 지문(Fingerprint) 계산
sig_payload = build_signature_payload(bot_id, session_id)
auth_signature = generate_fingerprint(api_endpoint, sig_payload, current_timestamp)
# 3. 요청 헤더 조립
headers = {
"Authorization": f"Bearer {server_token}",
"X-Signature": auth_signature,
"X-Timestamp": str(current_timestamp)
}
return headers, encoded_message
위 로직을 통해 msgContent의 개행 문자를 제거하고 URL 인코딩을 수행한 후, 생성된 auth_signature와 서버에서 발급받은 Token을 HTTP 헤더에 삽입하여 /v4/api/chat/msg 엔드포인트로 POST 요청을 전송하면 자동화된 통신이 완료됩니다.