한국의 은행 웹사이트 중에는 아직도 전용 보안 프로그램 몇 개가 PC에서 돌고 있어야 하는 곳이 있습니다. 페이지는 이 프로그램들과 인터넷을 거쳐 통신하지 않습니다. 정해진 localhost 포트로 호출해서 기기 정보, 설치 여부, 요청마다 붙는 스탬프, 암호화된 기기 로그를 요구합니다. 쓰고 있는 운영체제를 그 프로그램들이 더 이상 지원하지 않게 되기 전까지는 잘 돌아가는 구조죠.
제가 원한 것은 남의 바이너리나 인증서, 개인 키를 하나도 넣지 않고 그 호출에 답할 수 있는, 작고 유지보수하기 쉬운 호환 서비스였습니다. 결과물은 127.0.0.1에서만 수신하면서 은행 페이지가 기대하는 요청과 응답을 주고받는 Rust 프로그램 하나입니다. 저는 macOS와 Linux에서 쓰고 있습니다. Windows 빌드도 CI에서 같은 테스트를 통과하지만, 실제 Windows 기기에서 은행 페이지를 상대로 돌려 본 적은 아직 없습니다.
AI 도구는 두 가지를 서로 다른 일에 썼습니다. Kimi는 프로토콜을 파악하고 Python 구현이 실제 사이트에서 통하는지 확인하는 일을 도왔습니다. Claude는 그렇게 동작하게 된 Python을 Rust 프로그램으로 바꾸는 일을 도왔습니다. 어느 쪽도 다른 쪽을 대신하지 못했고, 둘 다 테스트를 대신하지는 못했습니다. 리버스 엔지니어링이 명세를 만들었고, 재작성은 그 명세를 지켜야 했습니다.
규칙부터 정했습니다#
이 프로젝트는 제 기기에서 상호운용성을 확보하려는 것이지, 은행의 통제를 뚫으려는 시도가 아닙니다. 프로그램이 지키는 규칙은 다음과 같습니다.
- 독점 실행 파일, 캡처한 개인 키, 벤더 인증서를 담지 않습니다.
- 알려 주는 기기 정보는 지금 기기의 실제 정보이고, 요청마다 새 값을 만듭니다.
- 모든 서비스는 루프백에만 머뭅니다. 로컬 인증 기관(CA)은 사용자마다 하나이고, 루프백 이름에만 서명할 수 있습니다.
- 구현하지 않은 동작은 거부합니다. 그럴듯한 가짜 성공 응답은 없습니다.
- 무엇이 받아들여지는지는 은행 서버가 정합니다. 제 쪽에서 복호화되는 페이로드는 단위 테스트일 뿐, 호환성의 증거가 아닙니다.
이 규칙들 덕분에 프로젝트는 더 안전해졌을 뿐 아니라 더 단순해졌습니다. 서버가 임의의 데이터를 받아들이게 만들 필요는 한 번도 없었습니다. 필요했던 것은 정상적인 흐름에서 서버가 사실 그대로의 데이터를 받아들일 만큼 정확한 클라이언트였습니다.
Kimi로 프로토콜 지도 그리기#
대체 구현을 쓰기 전에, 브라우저가 실제로 무엇을 하는지부터 알아야 했습니다.
Kimi는 로그인 페이지와 그 JavaScript를 읽고, localhost로 가는 요청을 추적하고, 호출을 역할별로 묶었습니다. 거래 스탬프를 다루는 프로그램이 하나 있고, 기기와 네트워크 정보를 모으는 프로그램이 하나 있습니다. 나머지는 설치 여부, 키보드 보안 지원 여부, 환경 검사 결과를 알려 줍니다. 어떤 호출은 HTTPS 위의 JSONP이고 어떤 호출은 WebSocket입니다. 포트 번호와 응답 형태는 바꿀 수 없습니다. 은행의 JavaScript가 이미 거기에 의존하고 있기 때문입니다.
이 단계의 산출물은 프로토콜 지도였고, 캡처한 트래픽 더미보다 훨씬 쓸모가 있습니다.
| 역할 | 페이지가 기대하는 것 |
|---|---|
| 스탬프 | 핸드셰이크, 요청별 스탬프, 인증서 설정, 암호화된 기기 로그 |
| 수집기 | 기기와 네트워크 정보 (HTTPS와 WebSocket) |
| 관리자 | 필수 프로그램 중 무엇이 설치돼 있는지와 그 버전 |
| 키보드와 키가드 | 버전, 상태 확인, keepalive 응답 |
| 스캐너 | 환경 검사에 대한 응답 |
동작마다 요청 파라미터, 응답을 감싸는 형식, 콘텐츠 타입, 콜백 동작, 실패했을 때의 모습을 적어 두었습니다. 그런 다음 관찰한 내용을 하나씩 작은 순수 함수로 줄였습니다. 여기는 솔트가 들어간 인코딩, 저기는 암호화 계층, 또 다른 곳은 순서가 정해진 기기 필드 목록, 이런 식입니다.
프로토콜이 정한 사실과 구현에서 고를 수 있는 것을 나눠 둔 것이 나중에 도움이 됐습니다. 포트 번호와 필드 이름은 프로토콜이 고정합니다. Python 모듈, Rust 크레이트, 에러 타입은 제가 고를 수 있는 부분이었습니다.
실행 가능한 명세로서의 Python#
첫 언어로 Python은 잘 맞았습니다. 암호화 라이브러리가 쓰기 편하고, 바이트를 다루기가 빠르고, 응답을 바꾼 뒤 곧바로 은행 페이지에서 다시 시험해 볼 수 있습니다. 그래서 처음 동작한 버전은 쓰고 버릴 목(mock)이 아니었습니다. 그때까지 알아낸 모든 것을 실행할 수 있는 형태로 담은 것이었습니다.
프로토콜 규칙마다 합성 입력을 쓰는 로컬 테스트를 붙였습니다. 한 은행의 암호화된 기기 로그의 경우, 테스트가 일회용 키와 인증서를 만들고, 인코더를 돌리고, 결과를 복호화해서 필드 순서와 값을 확인합니다. 덕분에 실제 계좌 근처에도 가지 않고 인코딩 실수를 꽤 많이 잡았습니다.
그러다 로컬에서 통과하는 것만으로는 부족하다는 걸 보여 준 실패가 하나 나왔습니다.
로컬에서만 맞았던 요청 ID#
로그 응답은 겉보기에 맞았고 테스트에서도 제대로 복호화됐는데, 은행은 보안 프로그램 검증 오류로 거부했습니다. 로그인 시도 횟수를 계속 쓰는 대신, Kimi는 은행의 정식 설치 프로그램이 내는 localhost 응답과 제 Python이 내는 응답을 새로 받아서 비교했습니다.
바깥 형식은 양쪽이 같았고, 암호화된 키의 형태도 같았습니다. 요청 ID가 달랐습니다. 정식 프로그램은 ID를 세션 키로 암호화한 다음 인코딩했습니다. 제 구현은 기기 로그는 암호화했지만 ID는 인코딩만 했습니다.
증거가 이만큼 분명하니 수정은 작았습니다. 회귀 테스트는 이제 로그에 대해 이미 하던 것처럼 생성한 키로 요청 ID도 복호화합니다. 다음 실제 시도에서 은행은 검증 오류를 더 이상 내지 않고 ID와 비밀번호 확인으로 넘어갔습니다. 그 뒤의 시도에서 로그인이 완료됐습니다.
에이전트가 리버스 엔지니어링을 할 때 따랐으면 하는 순서가 바로 이것입니다. 관찰하고, 정확한 가설을 하나 세우고, 한 가지만 바꾸고, 로컬에서 테스트하고, 그런 다음에야 엔드투엔드 확인을 한 번 합니다. 추측성 수정 열 개를 한꺼번에 부탁하는 것보다 훨씬 멀리 갑니다.
관찰에서 Rust 설계로, Claude와 함께#
Python이 동작하자 일의 성격이 달라졌고, 저도 그에 맞춰 도구를 바꿨습니다. Claude가 새로 발견할 것은 없었습니다. Claude의 일은 구조와 패키징을 개선하는 동안 동작을 그대로 지키는 것이었습니다.
Rust 코드는 프로토콜 자체의 경계를 따라 나뉩니다. 역할마다 모듈 하나, 기기의 실제 운영체제와 네트워크 정보를 다루는 모듈 하나, 암호화와 로컬 인증 기관을 다루는 모듈 하나, 명령줄용 모듈 하나입니다. 비동기 서버와 TLS는 Tokio, Hyper, Rustls가 맡습니다. 결과 타입을 명시해 두었기 때문에 잘못된 인증서, 잘못된 파라미터, 지원하지 않는 동작은 의도한 대로 실패합니다. 의존성은 락 파일로, 릴리스를 빌드하는 컴파일러는 툴체인 파일로 고정했습니다.
Rust를 쓰면 운영체제마다 네이티브 실행 파일이 하나씩 나오니, Python 런타임도 PyInstaller 번들도 필요 없습니다. 그 번들이 약한 고리였습니다. Intel Mac 빌드가 실행되지 않았는데, cryptography 패키지가 Intel용 휠(wheel)을 더 이상 배포하지 않아서 pip이 소스에서 컴파일했고, 그 결과 PyInstaller가 번들에 넣는 것과 다른 OpenSSL에 링크됐기 때문입니다. 이미 Python으로 작업하는 분들을 위해서는 작은 PyO3 패키지가 같은 Rust 프로그램을 모듈과 명령으로 제공합니다. 프로토콜 로직을 두 벌로 두지 않습니다.
여기서 ‘현대화’가 무엇을 뜻하는지는 솔직하게 적어 두겠습니다. 벤치마크를 보고 한 재작성이 아니고, 측정하지 않은 속도 향상을 주장할 생각도 없습니다. 목표는 더 작은 산출물, 동시성과 에러의 책임 소재가 분명한 구조, 재현 가능한 네이티브 빌드, 그리고 짊어지고 다닐 패키징을 줄이는 것이었습니다. 발견 단계에는 Python이 맞는 도구였습니다. 배포하고 유지보수하기에는 Rust가 저에게 더 편합니다.
계약: 구현은 새것, 동작은 그대로#
재작성은 무엇이 바뀌면 안 되는지 말할 수 있을 때만 안전합니다. 저는 그것을 세 단계로 확인했습니다.
Python이 만든 골든 바이트#
테스트 픽스처 폴더에 Python 버전의 출력이 들어 있습니다. 인코딩된 기기 레코드, 그것을 압축한 형태, 암호화 출력 일부, Python 버전이 발급한 인증 기관, 스탬프 몇 개입니다. Rust 테스트는 자기 결과를 이 바이트와 비교합니다.
이런 픽스처는 보통의 단위 테스트라면 슬그머니 다시 정의해 버릴 수 있는 질문에 답해 줍니다. 압축된 스트림이 Python 버전이 호출하던 C 라이브러리의 출력과 바이트 단위로 일치하는가? 필드 순서는 그대로인가? 이전 버전이 만든 인증 기관이, 새 버전이 서버 인증서를 갱신할 때도 여전히 동작하는가?
모든 역할을 아우르는 요청 코퍼스#
Python 서버와 Rust 서버를 나란히 띄워 놓고, 모든 역할과 전송 방식을 다루는 요청 37개짜리 코퍼스를 돌렸습니다. 거부되는 경우도 포함했습니다. JSON이 비슷한 것으로는 통과가 아니었습니다. 상태 줄, CORS 헤더, 콘텐츠 타입, 본문이 전부 똑같아야 했습니다.
거부 사례는 당연히 이 코퍼스에 들어가야 합니다. 기준 구현이 거부하는 요청에 성공을 돌려주는 대체 구현은 보안 동작을 바꾼 것이고, 저는 그것을 호환이라고 보지 않습니다.
실제 소켓과 빌드된 프로그램#
단위 테스트 위에 소켓 테스트와 릴리스 바이너리 스모크 테스트가 있습니다. 스모크 테스트는 실제 프로그램을 띄운 다음, 그 프로그램의 status 명령이 고정 포트 전부가 새 로컬 인증서로 응답하는 것을 확인해야 통과합니다. CI는 macOS, Linux, Windows에서 Rust 코드를 린트하고 테스트하며, Python 휠은 별도 작업으로 빌드합니다. 릴리스 워크플로는 대상마다 테스트를 다시 돌리고, 빌드하고, 빌드한 결과물을 스모크 테스트한 뒤에야 패키징합니다.
보안 강화도 호환성의 일부입니다#
기기 정보를 내주는 로컬 서비스는 비밀번호를 전혀 보지 않더라도 민감합니다. 어떤 웹사이트든 script 태그나 WebSocket에서 localhost 포트를 지목할 수 있고, CORS는 둘 다 막아 주지 않습니다.
그래서 이 프로그램은 모든 역할과 전송 방식에서 호출한 쪽을 확인합니다. Origin, Referer, Sec-Fetch-Site를 읽고, 예상하지 못한 Host는 거부하고, 허용 목록에 있는 은행 오리진에만 답합니다. 인증 기관은 127.0.0.1, localhost, 그리고 스탬프 페이지가 호출하는 호스트 이름 하나에만 서명할 수 있습니다. 개인 키는 사용자의 데이터 폴더에 머물고, 일회용 컨테이너로 돌릴 때는 키를 디스크에 아예 쓰지 않습니다.
키보드 암호화와 인증서 서명은 구현하지 않았으므로 명시적인 에러를 돌려줍니다. 암호화된 출력을 지어내는 곳도, 설치나 업데이트가 성공한 척하는 곳도 없습니다.
이 중 어느 것도 재작성 뒤에 덧붙인 것이 아닙니다. 이미 동작의 일부였으니 재작성이 그대로 가져가야 했습니다.
같은 방식을 쓰고 싶다면#
이 분담이 통한 이유는 단계마다 ‘완료’의 정의가 달랐기 때문입니다.
- 구현하기 전에 지도를 그립니다. 첫 번째 에이전트에게 브라우저 코드, localhost 호출, 상태를 들고 다니는 요청 순서를 읽게 하고, 관찰한 것과 아직 추측인 것을 구분해 둡니다.
- 작은 기준 구현을 만듭니다. 저에게는 Python이 맞았습니다. 반복이 빠르고, 변환 코드가 읽기 쉽고, 합성 데이터로 암호화 왕복 테스트를 할 수 있습니다.
- 실제 서비스는 아껴서 씁니다. 새로 받은 응답을 비교하고, 불일치를 하나로 좁히고, 살아 있는 서비스에 무작정 재시도하지 않습니다.
- 언어를 바꾸기 전에 동작을 픽스처로 고정합니다. 골든 바이트, 요청 코퍼스, 실패 사례입니다. 어느 것에도 비밀 정보가 들어가면 안 됩니다.
- 두 번째 에이전트는 그 계약을 기준으로 리팩터링하게 합니다. 모듈 경계, 타입이 있는 에러, 동시성, 패키징, CI를 부탁하고, 프로토콜을 다시 해석하게 하지는 않습니다.
- 배포하는 것을 테스트합니다. 모든 대상의 릴리스 바이너리를 말합니다. 라이브러리가 import되는지, 컴파일이 깨끗하게 되는지로는 알 수 없습니다.
- diff는 직접 읽습니다. 에이전트는 많은 맥락을 들고 있을 수 있지만, 법적으로 어디까지 할지, 위험을 얼마나 감수할지, 호환성이 무엇을 뜻해야 하는지는 정해 주지 못합니다.
탐색과 리팩터링을 동시에 진행한다면 git worktree를 따로 두는 것이 도움이 됩니다. 그러지 않으면 탐색용 수정과 구조 재작성이 테스트가 돌기도 전에 서로를 덮어쓸 수 있습니다. 이 이야기는 Claude Code worktree 사용법에 썼습니다.
다음에도 이렇게 하겠습니다#
가장 잘 통한 프롬프트는 “이 제품을 리버스 엔지니어링해 줘"나 “이걸 Rust로 다시 써 줘"가 아니었습니다. 더 좁은 일을 차례로 맡기는 쪽이었습니다.
- 이 요청의 정확한 인코딩을 알아내고, 로컬 왕복 테스트로 증명한다.
- 정식 응답과 기준 구현 응답의 차이를 추측 없이 설명한다.
- 구현을 교체하되 이 바이트는 그대로 둔다.
- 동작이 조금이라도 바뀌면 릴리스가 실패하게 만든다.
이 순서 덕분에 실패가 어디에 속하는지도 알 수 있었습니다. 프로토콜 불일치는 발견 단계로, 깨진 픽스처는 재작성으로, 패키징 실패는 릴리스로 돌아가면 됩니다. 두 도구 모두 다음에 할 일을 도구의 자신감이 아니라 증거가 정할 때 가장 쓸모 있었습니다. Python은 그 둘 사이에서 양쪽 모두에게 지켜야 할 구체적인 기준을 주었습니다.
