거래소 API 키 보안과 접근 IP 제한

가상화폐 자동매매 봇을 운영할 때 가장 치명적인 보안 사고는 거래소 API Key 유출로 인한 자산 탈취입니다.

해커들이 GitHub 공개 저장소를 1초 단위로 자동 스캔하여 API 키가 커밋되는 즉시 외부 지갑으로 코인을 전량 출금해 버리거나, 호가창이 얇은 비주류 코인으로 자전거래를 일으켜 계좌를 털어가는 피해 사례가 빈번하게 발생하고 있습니다.

내 자산을 100% 안전하게 보호하기 위한 3중 보안 방어선과 프로덕션 운영 수칙을 상세히 다룹니다.

퀀트 트레이딩 3중 보안 방어선

[ 1차 방어선: 출금 권한 원천 배제 ]
거래소 관리 화면에서 "출금" 권한 체크 해제
➔ 키가 만에 하나 유출되더라도 외부 지갑으로 코인 이체 불가!
 
[ 2차 방어선: 거래소 접근 IP 제한 ]
거래소의 허용 IP 정책과 연동해 인가된 위치에서만 주문 승인
➔ 해커가 키를 획득해도 해커의 컴퓨터에서는 접속 자체가 차단됨!
 
[ 3차 방어선: AES-256-GCM 환경변수 암호화 ]
소스 코드나 Git 저장소에 키를 적지 않고 대시보드 시크릿 스토리지에 암호화 보관
➔ 개발자의 코드 어디에도 평문 비밀번호가 남지 않음!

제1원칙: 출금 권한 원천 차단

거래소에서 API Key를 생성할 때 부여할 수 있는 권한 목록입니다:

제2원칙: 거래소 접근 IP 제한 활용

일반 가정집 인터넷이나 모바일 핫스팟은 공유기를 껐다 켤 때마다 IP가 바뀌는 유동 IP이므로, 거래소의 IP 화이트리스트 기능을 안정적으로 쓰기 어렵습니다.

DashCloud 프로젝트는 데이터센터 회선에서 아웃바운드 연결을 사용하므로 가정용 유동 IP보다 안정적입니다. 다만 대시보드에 프로젝트별 고정 아웃바운드 IP를 표시하는 기능은 아직 제공되지 않습니다. 업비트처럼 허용 IP 등록이 필수인 거래소를 연동해야 한다면 [email protected]로 문의해 주세요.

IP 화이트리스트를 선택적으로 지원하는 거래소(바이낸스 등)라면, 여유가 될 때 허용 IP를 등록해 두는 것만으로도 키 유출 시 피해를 크게 줄일 수 있습니다.

제3원칙: 코드 내 하드코딩 금지 및 환경변수 격리

코드 파일에 비밀 키를 문자열로 적어두는 행위는 매우 위험합니다.

# 코드에 키를 박아두면 git push 하는 순간 전 세계에 유출됩니다!
API_KEY = "x-api-key-abcdef123456789"
SECRET = "secret-key-xyz987654321"

import os
import sys
 
# DashCloud 대시보드에서 AES-256으로 암호화되어 주입된 환경변수 로드
API_KEY = os.environ.get("EXCHANGE_ACCESS_KEY")
SECRET_KEY = os.environ.get("EXCHANGE_SECRET_KEY")
 
if not API_KEY or not SECRET_KEY:
    print("환경변수에 거래소 API 키가 설정되지 않았습니다!")
    sys.exit(1)

키 유출 의심 시 3분 비상 대응 매뉴얼

만약 실수로 깃허브 공개 저장소에 키를 커밋했거나 유출이 의심된다면 즉시 다음 단계를 밟으세요:

1. 거래소 사이트 접속 ➔ API Key 즉시 삭제: 수정하지 말고 해당 키를 즉각 삭제하여 모든 유령 세션을 무력화합니다.
2. 거래소 열려있는 주문 취소 및 자산 확인: 모바일 앱에서 원치 않는 이상 주문이 나갔는지 확인하고 미체결 주문을 일괄 취소합니다.
3. 새 API Key 발급 및 DashCloud 환경변수 교체: 새 키를 발급받아(출금 권한 제외, 허용 IP 등록) DashCloud 대시보드 환경변수를 갱신하고 재시작합니다.

다음 추천 문서