Binance API Key 생성과 IP 화이트리스트 바인딩 실전
Binance에서 API Key를 처음부터 만들고 IP 화이트리스트를 바인딩하는 전 과정: 권한 체크, 203.0.113.0/24 같은 IPv4 대역 표기법, 90일 만료 로테이션 메커니즘, 그리고 키 유출 시 응급 절차까지 한 번에 정리합니다.
Binance에서 API Key를 만드는 올바른 순서는 다음과 같다. 우선 로그인해 2FA를 통과한 다음 「계정 → API 관리」로 들어가 새 API를 만들고 이름을 붙인다. 곧바로 IP 화이트리스트를 체크하고 고정 아웃바운드 IPv4 대역(예: 203.0.113.0/24)을 입력한다. 그런 뒤 필요한 권한(읽기 전용 / 현물 거래 / 출금 등)만 골라 체크하며 기본값은 읽기 전용이 안전하다. 마지막으로 API Secret을 저장해 오프라인으로 백업한다. 새로 생성된 모든 API Key는 90일 유효 기간을 갖고, 만료되면 반드시 로테이션을 해야 한다. 필요한 절차를 지금 시작하려면 Binance 공식 사이트에서 API 관리 페이지로 이동하고, 모바일에서 확인이 필요할 때는 Binance 공식 앱을 함께 준비해 두면 편하다.
웹 개발자의 관점에서 API Key는 계정의 권한 일부를 스크립트, 트레이딩 봇, 데이터 대시보드에 넘겨주는 「실체가 있는 물리 열쇠」다. 유출되면 그 순간 계정 권한의 일부를 넘겨준 것과 같다. 권한은 최소로, IP 화이트리스트는 가장 엄격하게, 로테이션 주기는 가장 짧게 두는 것이 3대 철칙이다. 이 글은 전 과정을 단계별로 분해하고 IPv4 대역 표기, 권한 계층, 유출 대응까지 한 번에 정리한다.
API Key 생성 전 준비
네트워크 아웃바운드 IP를 먼저 파악
IP 화이트리스트를 걸려면 나 자신 혹은 프로그램이 안정된 아웃바운드 IPv4를 가지고 있어야 한다. 그렇지 않으면 IP가 바뀔 때마다 다시 화이트리스트를 수정해야 한다. 대표적인 세 가지 상황은 다음과 같다.
- 가정용 회선: 대부분 동적 IP이므로 DDNS 또는 VPN으로 고정 필요. 가정 회선 IP 직접 바인딩은 권장하지 않음
- 클라우드 서버: 아웃바운드 IP가 대체로 고정. 클라우드 벤더가 할당한 공인 IPv4를 그대로 사용
- 사내 네트워크: 아웃바운드가 단일 IP인지 NAT 풀인지 네트워크 관리자와 확인 필요
고정 IP가 아직 없다면 우선 API Key를 만들어 두되 거래 권한은 활성화하지 않고 읽기 전용만 열어 두고, IP가 확정된 뒤 단계적으로 권한을 확장한다.
명명과 용도는 1:1로 대응
용도가 다른 스크립트에는 별도의 API Key를 발급해 한 개의 키가 여러 시나리오를 겸하지 않게 한다. 명명 예시:
| Key 이름 | 용도 | 권한 | 비고 |
|---|---|---|---|
read-only-portfolio |
자산 대시보드 잔액 조회 | 읽기 전용 | 시간당 폴링 |
spot-bot-btc-usdt |
현물 그리드 봇 | 현물 거래 | 단일 페어 |
data-export |
매일 체결 내역 내보내기 | 읽기 전용 | 1회성 실행 |
treasury-withdraw |
정기 배치 출금 콜드월렛 이체 | 출금 | 거래 권한 금지 |
이렇게 분리해 두면 한 개가 유출되어도 그 하나만 폐기하면 되고 다른 스크립트에는 영향이 없다. 감사할 때도 각 키의 마지막 호출 시각을 개별적으로 추적하기 편하다.
2FA와 이메일 인증 사전 준비
API Key 생성·수정·삭제 모든 단계에서 2FA 코드와 이메일 확인이 필요하다. 최근에 2FA 이전을 했다면(참조 /posts/biabaweb-2fa-migration/) 새 인증기가 안정적으로 동작하고 있는지 먼저 확인한다.
권한 계층 선택 방법
Binance API Key의 권한은 위에서 아래로 몇 단계로 나뉘며, 최소 권한 원칙에 따라 체크할 것을 권장한다.
권한 계층 요약
| 권한 | 가능한 동작 | 리스크 | 추천 시나리오 |
|---|---|---|---|
| 읽기 전용 | 잔액·주문·체결 조회 | 낮음 | 대시보드, 세무 보고 내보내기 |
| 현물 거래 | 주문 생성·취소 | 중 | 그리드/차익 봇 |
| 선물 거래 | 진입·청산·레버리지 조정 | 높음 | 선물 전략 |
| 마진 대출 | 대출·상환 | 높음 | 마진 전략 |
| 출금 | 온체인 출금 개시 | 매우 높음 | 재무 출금 스크립트 |
| 만능 지갑 | 복합 권한 | 매우 높음 | 권장하지 않음 |
읽기 전용의 기본 동작
읽기 전용만 체크했을 때 이 API Key는 GET 계열 인터페이스만 호출할 수 있다. 이런 키는 유출되더라도 잔액과 이력만 노출될 뿐 자금을 움직일 수 없어, 화이트리스트와 결합하면 자산 손실 리스크가 거의 없다. 데이터 분석 목적이라면 여기까지만이 정답이다.
출금 권한의 추가 요구 사항
출금 권한을 체크하는 순간 Binance는 다음을 강제한다. IP 화이트리스트 사전 바인딩 필수, 계정 수준의 출금 화이트리스트와 병행 필수(참조 /posts/biabaweb-withdrawal-whitelist/), 건당 및 24시간 한도는 계정 수준의 출금 한도와 공유. 「자동 출금」 스크립트를 돌리려면 이 두 화이트리스트가 동시에 활성화되어 있어야 한다.
Q: 처음에는 읽기 전용으로 검증한 뒤 나중에 거래 권한으로 바꿔도 되나요? A: 가능하며, 실제로 강력히 권장하는 순서입니다. 먼저 읽기 전용으로 일주일 돌려 IP가 바뀌는지, 스크립트가 안정적인지 관찰한 뒤 문제없으면 단계적으로 권한을 열어 갑니다. 권한 확장 시에는 2FA와 이메일 확인이 다시 요구됩니다.
Q: 한 개의 Key에 읽기 전용과 현물 거래를 동시에 체크하면 중첩인가요, 교체인가요? A: 중첩입니다. 읽기 전용 권한은 모든 Key에 기본으로 열려 있고, 거래 권한을 체크하면 그 위에 주문 능력이 추가됩니다.
IP 화이트리스트 표기법
IP 화이트리스트는 쉼표로 구분해 여러 항목을 넣을 수 있고 형식은 단일 IP, 다중 IP, CIDR 대역을 지원한다.
자주 쓰는 표기 예시
- 단일 IPv4:
203.0.113.55 - 다중 IPv4:
203.0.113.55,203.0.113.56 - IPv4 서브넷:
203.0.113.0/24(203.0.113.0 부터 203.0.113.255) - 소규모 대역:
203.0.113.0/29(연속된 8개 IP)
표기 시 주의 사항:
- 마스크가 클수록(숫자가 작을수록) 커버되는 IP가 많아지고 위험하다. 일반적으로 /24를 넘지 않는다
- IPv6 화이트리스트에 IPv4를 넣거나 반대로 넣는 것은 불가. 실제 아웃바운드 프로토콜에 맞춰 기입한다
- 도메인이나 DDNS 호스트명은 지원하지 않는다. 반드시 숫자 IP여야 한다
- 대역 사이는 반드시 영문 쉼표로 구분하고 사이에 공백을 두지 않는다
클라우드 서버 아웃바운드 확인
클라우드 서버에 배포한 경우, SSH 접속 후 제3자 IP 확인 서비스를 호출해 공인 아웃바운드 IP를 확인한다. 예를 들어 순수 텍스트 IP 반환 엔드포인트에 접근하는 식이다. 콘솔에 표시된 「공인 IP」에 의존하지 말자. 일부 클라우드는 인바운드와 아웃바운드 IP가 별도로 할당되는 경우가 있기 때문이다.
CIDR 대역 선택 가이드
호스트의 /32(단일 IP) 혹은 /29(8개 IP, 클라우드 벤더 오토스케일 대비)를 우선 사용한다. 진짜 대규모 스케일링 시나리오가 아니면 /24는 쓰지 않는다. 절대 0.0.0.0/0을 쓰거나 IP 화이트리스트를 비워 두지 않는다. 비워 두면 모든 IP의 호출을 허용하는 것이라 극도로 위험하다.
화이트리스트가 실제로 걸렸는지 검증
바인딩 완료 후, 화이트리스트 밖의 머신에서 이 API Key로 아무 인터페이스나 호출해 본다. 명확한 -2015 에러 또는 「Invalid API-key, IP, or permissions」 유사 메시지가 떠야 정상이다. 이 에러가 나오면 화이트리스트가 유효한 것이고, 여전히 호출된다면 저장이 안 됐거나 IP가 바인딩되지 않은 상태다.
90일 만료와 로테이션
2023년부터 Binance는 거래 또는 출금 권한이 활성화된 API Key에 90일 유효 기간을 강제 적용한다. 만료되면 Key는 자동으로 읽기 전용으로 강등되며, 사용자가 수동으로 갱신하거나 로테이션해야 한다.
올바른 로테이션 방식
- 만료 7일 전, 권한·IP·비고를 동일하게 유지한 새 API Key를 만든다
- 새 Key의 Access Key / Secret Key를 스크립트에 배포하고 환경 변수를 전환한다
- 24시간 관찰해 새 Key가 정상 작동하는지 확인한다
- 만료 즉시 예전 Key를 삭제한다. 「혹시 몰라서」 남겨 두지 않는다
이렇게 하면 신·구 Key가 24시간 병행되어 전환이 끊기지 않고, 예전 Key는 만료 즉시 폐기되어 유출 면이 줄어든다.
자동 갱신에 의존하지 말 것
Binance가 「유효 기간 연장」 버튼을 제공하지만, 자동 갱신에 의존한다는 것은 Access Key / Secret Key가 영원히 바뀌지 않는다는 뜻이다. 과거에 한 번이라도 유출이 있었다면 그것이 장기 리스크 원천으로 남는다. 정기 로테이션이 가장 효과적인 키 위생이다.
출금 화이트리스트와의 결합
이 Key에 출금이 걸려 있다면, Key를 로테이션할 때 출금 화이트리스트를 다시 만들 필요는 없다. 계정 수준의 주소록은 Key와 무관하기 때문이다. 다만 전체 플로우를 다시 한 번 예행연습해야 한다. 새 Key + 기존 화이트리스트 주소로 소액 출금을 한 번 돌려 링크가 무결한지 확인한 뒤 물량을 늘린다.
키 유출 응급 대응
API Key 유출을 발견하거나 의심될 때, 아래 순서로 실행하면 5분 안에 손실을 최소화할 수 있다.
- 「계정 → API 관리」를 열어 의심되는 Key를 삭제
- 모든 세션 로그아웃 (로그인 페이지에서 「다른 기기 로그아웃」 체크)
- 즉시 계정 로그인 비밀번호 변경
- 「보안 → 로그인 이력」과 「보안 → 조작 로그」에서 이상 여부 확인
- 「자금 이력」에서 무단 거래나 출금 여부 확인
- 계정 침해가 의심되면 2FA 재설정(선택)
- Binance 공식 사이트에서 티켓을 접수해 상황을 설명
- 1주일 내 화이트리스트·2FA·API·연결 이메일에 대한 종합 보안 순회 점검
사후 회고
Key는 어떻게 유출됐는가? 흔한 경로는 다음과 같다.
- GitHub 퍼블릭 저장소에 커밋
- 설정 파일에 기록한 뒤 그 파일을 채팅 앱에 업로드
- Key가 포함된 배포 스크립트를 여러 머신에 배포
- 퇴사자 권한 회수 누락
- 스크린 캡처 / 로그 업로드 기능이 있는 개발 도구 사용
각 유출마다 근본 원인을 분석하고 프로세스를 개선해 다음을 예방한다.
리스크 안내: SNS에서 먼저 접근해 「API 그리드를 대신 만들어 주겠다」고 말하는 계정은 전부 피싱이다. Access Key 또는 Secret Key를 개인 메시지로 보내라는 어떤 행동도 예외 없이 사기다. Binance 공식 앱은 반드시 공식 배포 채널에서 받고, 진위 판별 룰은 /posts/binance-anti-phishing-real-fake/ 를 참고한다.
자주 묻는 질문
하나의 계정에서 최대 몇 개의 API Key를 만들 수 있나요?
메인 계정은 최대 30개의 API Key를 생성할 수 있고 서브 계정은 별도로 카운트됩니다. 실제로는 동시에 활성인 Key를 5개 이내로 유지하고, 초과분은 정기적으로 정리해 운영 부담을 줄이는 것이 좋습니다.
서브 계정에서도 독립적으로 API Key를 만들 수 있나요?
가능합니다. 서브 계정은 API 리스트와 IP 화이트리스트를 독립 관리하며 권한도 메인 계정과 완전히 격리됩니다. 기관 수준의 격리에 매우 유용합니다. 서브 계정 하나에 전략 하나, Key 하나에 IP 하나 식으로 나눌 수 있습니다.
Secret Key를 잊어버렸다면?
복구할 수 없습니다. API Secret Key는 생성 시점에만 한 번 표시되고 Binance는 평문을 보관하지 않으므로 분실 시 삭제 후 재생성만 가능합니다. 생성 즉시 비밀번호 관리자나 암호화 파일에 반드시 기록해야 하는 이유입니다.
API Key를 남의 IP에서 쓸 수 있나요?
IP 화이트리스트가 바인딩되어 있다면 불가능합니다. 공격자가 Access Key와 Secret Key를 손에 넣더라도 화이트리스트 밖의 머신에서는 즉시 실패합니다. 이것이 IP 화이트리스트의 핵심 가치입니다.
만료 후에도 예전 Key를 계속 쓰고 싶다면?
가능하지만 읽기 전용으로 강등됩니다. 거래·출금 권한을 회복하려면 수동으로 「연장」을 누르고 2FA 검증을 다시 통과해야 합니다. 프로덕션 환경에서는 권장하지 않으며, 능동적으로 새 Key로 로테이션하는 편이 낫습니다.
API 요청 속도 제한이 화이트리스트에 따라 달라지나요?
아니오. 속도 제한은 계정 수준 쿼터에 기반하며 IP 화이트리스트와 무관합니다. 리미트를 자주 건드린다면 호출 빈도를 최적화하거나 쿼터 상향을 요청해야 하며, IP를 여럿 바인딩한다고 해결되지 않습니다.
화이트리스트에 CIDR 대역을 넣을 수 있나요?
가능합니다. 203.0.113.0/24 같은 표기로 씁니다. 다만 서브넷이 클수록 위험하므로 /32로 충분하면 /24를 쓰지 말고, /29로 충분하면 /24를 쓰지 말아야 합니다.
여러 클라우드 리전에 배포된 경우 화이트리스트를 어떻게 관리하나요?
리전별로 독립된 API Key를 발급해 해당 리전의 아웃바운드 IP만 바인딩할 것을 권장합니다. 이렇게 하면 리전 전환 시 해당 Key만 다루면 되고 장애 조사도 빠릅니다. Key 하나에 여러 클라우드 대역을 묶는 것은 조사도 어렵고 공격면도 넓어져 피하는 것이 좋습니다. 화이트리스트 세팅 뒤 실제 확인은 Binance 공식 사이트에 로그인해 API 페이지에서 하고, 모바일에서 급히 삭제할 필요가 있다면 Binance 공식 앱의 API 관리 메뉴에서도 처리할 수 있습니다.
문서 발행일 2026-07-01, 다음 재검토 예정일 2026-10-01.