바이낸스 API Key를 생성하면 시스템에서 IP 화이트리스트를 설정하라고 안내합니다. 이것은 무엇이고, 어떻게 설정하며, 설정하지 않으면 어떤 위험이 있을까요?
API 기능을 사용하려면 먼저 바이낸스 가입을 하고 실명 인증을 완료해야 합니다. API 관리는 바이낸스 앱 또는 웹 버전의 계정 설정에서 찾을 수 있습니다.
IP 화이트리스트란?
IP 화이트리스트는 "허용 목록"입니다. 목록에 있는 IP 주소만 API Key를 사용하여 요청을 보낼 수 있습니다. 다른 IP는 API Key와 Secret Key를 가지고 있어도 호출할 수 없습니다.
API 보안의 가장 중요한 방어선입니다. IP 화이트리스트를 설정하면 API 키가 유출되어도 공격자가 사용할 수 없습니다.
설정 방법
1단계: IP 주소 확인
퀀트 봇이 클라우드 서버에서 실행 중인 경우:
- 서버 콘솔에 로그인하여 공인 IP 확인
- 서버에서 실행: curl ifconfig.me
로컬 컴퓨터에서 프로그램을 실행하는 경우:
- whatismyip.com 등의 웹사이트에서 공인 IP 확인
- 주의: 가정용 인터넷 IP는 변경될 수 있음
2단계: 바이낸스에서 IP 화이트리스트 추가
- 바이낸스 웹에 로그인
- "계정 설정" → "API 관리" 이동
- 화이트리스트를 설정할 API Key 찾기
- "제한 편집" 또는 "수정" 클릭
- "IP 접근 제한" 영역에서 "신뢰할 수 있는 IP만 접근 허용" 선택
- IP 주소 입력
- 여러 IP 추가 가능(한 줄에 하나 또는 쉼표로 구분)
- 설정 저장, 보안 인증 완료
3단계: 테스트
설정 완료 후 프로그램으로 API 호출이 정상적으로 되는지 테스트하세요. 권한 오류가 반환되면 IP가 올바르게 입력되었는지 확인하세요.
여러 IP를 추가할 수 있나요?
가능합니다. 여러 서버나 사용 시나리오가 있다면 필요한 IP를 모두 화이트리스트에 추가할 수 있습니다.
IP 대역(CIDR 형식)도 지원하지만, 가능한 한 정확한 IP로 제한하는 것이 더 안전합니다.
가정용 인터넷 IP가 변경되면?
많은 가정용 인터넷은 동적 IP를 사용하여 재접속 시마다 IP가 변합니다. 이런 경우 몇 가지 방법이 있습니다:
방법 1: IP 화이트리스트 미설정. 보안은 낮아지지만 다른 조치로 보완 가능 — 출금 권한 비활성화, API Key 정기 교체, 계정 2FA 활성화.
방법 2: 고정 IP 클라우드 서버 사용. 프로그램을 클라우드 서버에 배포하면 IP가 고정됩니다. 권장 방법.
방법 3: 통신사에 고정 IP 요청. 일부 통신사에서 추가 요금으로 가정용 인터넷에 고정 IP를 할당.
방법 4: IP 변경 시마다 수동 업데이트. 번거롭지만 가능한 방법.
화이트리스트 설정 후 연결이 안 되면?
일반적인 원인:
IP 입력 오류: 화이트리스트의 IP와 실제 사용 IP가 일치하는지 확인하세요. 실제 출구 IP가 생각한 것과 다를 수 있으며, 특히 VPN이나 프록시를 사용하는 경우 그렇습니다.
IP 변경: 동적 IP가 변경되면 이전 IP가 무효가 됩니다. 현재 IP를 다시 확인하고 화이트리스트를 업데이트하세요.
IPv4/IPv6 혼동: IPv4와 IPv6 주소를 구분하세요. 현재 대부분의 API 연결은 IPv4를 사용합니다.
방화벽 또는 프록시: 네트워크가 프록시 서버를 통해 나갈 수 있으며, 실제 출구 IP는 프록시 서버의 IP입니다.
IP 화이트리스트 미설정 시 위험
화이트리스트 없이는 API Key를 가진 누구나 호출할 수 있습니다:
- 읽기 권한만 있는 경우: 공격자가 보유 자산과 거래 기록을 볼 수 있음
- 거래 권한이 있는 경우: 공격자가 거래를 조작하여 직접 손실 발생 가능
- 출금 권한이 있는 경우: 공격자가 자산을 직접 출금할 수 있음
IP 화이트리스트가 만능은 아니지만 대부분의 원격 공격을 차단할 수 있습니다.
클라우드 서버 보안 권장사항
퀀트 프로그램용 클라우드 서버를 사용한다면 API 화이트리스트 외에도 주의할 점:
- 서버 자체 보안: 강력한 비밀번호, SSH 키 로그인, 방화벽
- 서버에 API 키를 평문으로 저장하지 말고 환경 변수나 암호화 저장 사용
- 서버 시스템과 의존성 정기 업데이트
- 서버의 비정상 로그인과 네트워크 활동 모니터링
정리
IP 화이트리스트 설정은 몇 분이면 되지만 API 보안을 크게 향상시킵니다. 고정 IP 서버가 있다면 설정하지 않을 이유가 없습니다. 동적 IP인 경우 편의성과 보안을 고려하여 결정하되, 최소한 출금 권한은 활성화하지 마세요.