Binance API Key IP 화이트리스트 실전: 현물·선물 권한 분리, CIDR 마스크와 서버리스 출구 IP

biabalab 랩이 실측한 Binance API Key 보안 설정: 현물·선물·출금 권한 분리, IP 화이트리스트 CIDR 작성법, 서버리스 함수 출구 IP 획득, 90일 로테이션과 알림 스크립트, 권한 매트릭스 및 마스크 예시 표 첨부.

게시일 2026-07-08 · 약 12 분 · 보안 설정

한 문장 요약: Binance API Key의 보안은 「시크릿 + 권한 + IP 화이트리스트」 세 요소의 곱과 같으며, 어느 하나만 느슨해져도 현물, 선물, 심지어 출금까지 인터넷에 그대로 노출됩니다. 사전에 Binance 공식 사이트에서 계정 상태를 정비하고 Binance 공식 앱도 함께 준비해 두면 좋습니다. biabalab 랩은 2026년 6월 12개 API Key를 다양한 권한 조합으로 발급해 공격면을 측정했으며, 이 글은 그대로 베껴 쓸 수 있는 설정 템플릿 — 권한 매트릭스, CIDR 작성법, 서버리스 함수 출구 IP 획득 스크립트, 유출 후 지혈 절차 — 를 제공합니다.

1. 왜 API Key 유출의 파괴력이 계정 비밀번호보다 큰가

계정 비밀번호는 2FA도 있고 로그인 리스크 관리도 있고 원격지 로그인 알림도 있지만, API Key에는 2FA가 없고 「HMAC-SHA256 서명 + 요청 타임스탬프」밖에 없습니다. 유출된 뒤 벌어지는 일은 다음과 같습니다.

  1. 공격자는 밀리초 단위로 주문을 낼 수 있어, 알림을 보기도 전에 코인이 이미 펌핑되고 매도되어 사라진 상태가 됩니다.
  2. Key에 「출금」 권한이 켜져 있고 IP 화이트리스트가 없다면, 공격자는 자신의 주소로 직접 출금할 수 있습니다.
  3. 일부 거래소(Binance 포함)는 API로 계정 간 내부 이체를 허용하여 공격면이 한층 확대됩니다.

biabalab 팀의 입장은 명확합니다. 기본은 출금 미개방, 기본은 IP 화이트리스트 활성화, 기본은 90일 로테이션. 이 세 가지를 지킬 수 없다면 API Key를 쓰지 말고 웹에서 수동으로 거래하세요.

2. 권한 분리 매트릭스(그대로 베끼세요)

용도가 다르면 API Key도 각각 발급해야 하며, 하나의 열쇠로 모든 문을 열지 마세요. 다음 매트릭스는 랩에서 일상적으로 쓰는 설정입니다.

용도 현물 거래 선물 거래 이체 출금 조회 IP 화이트리스트 유효기간
조회 전용(Dashboard) 아니오 아니오 아니오 아니오 예 강제 90일
현물 그리드 봇 예 아니오 아니오 아니오 예 강제 90일
선물 헤지 전략 아니오 예 예 아니오 예 강제 30일
재무 집계 아니오 아니오 예 예 예 강제 + 주소 화이트리스트 30일
일회성 데이터 백필 아니오 아니오 아니오 아니오 예 강제 사용 후 즉시 삭제

핵심 원칙: 모든 Key는 IP 화이트리스트를 켠다(Binance는 최대 20개 IP 또는 20개 CIDR 지정 가능), 그리고 어떤 Key도 「모든 권한 활성화」로 두지 않는다. 「재무 집계」 하나만이 출금 권한을 필요로 하며, 그것도 반드시 주소 화이트리스트 보호와 함께여야 합니다.

Binance 공식 사이트의 API 관리 페이지에서 생성 시 항목별로 체크할 수 있으니 「귀찮다」는 이유로 전부 체크하지 마세요. 모바일에서 관리하려면 Binance 공식 앱도 미리 준비해 두면 편합니다.

3. IP 화이트리스트의 세 가지 작성법

Binance API 화이트리스트는 단일 IP, 쉼표로 구분된 다중 IP, CIDR 세 가지 형식을 지원합니다. 어떤 방식이 어떤 배포 환경에 맞는지 아래 표를 참고하세요.

배포 시나리오 권장 형식 예시 커버 수 비고
가정 고정 공인 IP 단일 IP 203.0.113.42 1 가장 엄격, 가용성 최저
가정 이중 ISP 다중 IP 203.0.113.42,198.51.100.7 2 주-부 이중 회선
소형 IDC /29 CIDR /29 203.0.113.40/29 8 동일 대역 서버
클라우드 인스턴스 풀 CIDR /28 198.51.100.16/28 16 오토스케일 그룹
서버리스 NAT 게이트웨이 출구 IP 목록 NAT IP 4~8개 ≤ 20 NAT마다 개별 등록
가정 광대역 DHCP 동적 비권장 — — VPS + 터널이 안정

CIDR 빠른 환산: /32 = IP 1개, /31 = 2, /30 = 4, /29 = 8, /28 = 16, /27 = 32. Binance는 한 항목 최대 /24(256개)까지 허용하며 초과 시 오류가 나지만, 실제 업무에는 그렇게 넓은 대역이 필요 없습니다.

3.1 가정 광대역 환경의 방법

가정 광대역 IP는 대개 통신사 DHCP라 며칠에 한 번 바뀝니다. biabalab 팀은 가정용 회선을 Binance API에 직결하지 말고 저사양 VPS(월 5~10달러)를 임대해 집에서 VPS로 SSH 접속한 뒤 VPS에서 API를 호출하는 것을 권장합니다. 화이트리스트에는 VPS의 정적 IP만 등록하면 됩니다.

3.2 서버리스 함수 환경의 방법

서버리스 함수(Tencent SCF / Aliyun FC / AWS Lambda)는 기본적으로 랜덤 출구 IP를 사용하므로 화이트리스트에 등록하기 어렵습니다. 올바른 방법은 다음과 같습니다.

  1. 서버리스 함수를 VPC 안에 배치하고 NAT 게이트웨이를 연결합니다.
  2. NAT 게이트웨이에 1~4개의 탄력적 공인 IP(EIP)를 바인딩합니다.
  3. 이 1~4개의 EIP를 모두 Binance API 화이트리스트에 추가합니다.
  4. 서버리스 함수의 모든 아웃바운드 트래픽이 NAT를 통과하도록 하여 IP가 안정적으로 유지됩니다.

이렇게 하면 추가 이점도 있습니다. 향후 서버리스 사본이 100개까지 늘어나도 화이트리스트에 영향이 없습니다. 출구 IP는 NAT의 그 몇 개뿐이니까요.

4. API Key 생성 6단계

  1. Binance 로그인 → 프로필 → API 관리로 이동.
  2. 「Create API」 클릭, 「System generated」 선택(자체 약한 시크릿 생성 방지).
  3. 이름을 「용도+날짜」로 지정(예: spot-grid-20260707), 향후 일괄 정리에 편리.
  4. 2FA 코드 + 이메일 코드를 입력.
  5. Key 생성 후 즉시 「Restrict access to trusted IPs only」를 활성화하고 화이트리스트를 채우고 권한을 체크.
  6. API Key와 Secret Key를 시크릿 관리자(1Password / Bitwarden / Vault)에 복사한 뒤 페이지를 닫습니다. Secret Key는 한 번만 표시되며 페이지를 닫으면 복구할 수 없고, 그때는 삭제 후 재생성해야 합니다.

Q: Secret Key를 저장하지 못했다면? A: 해당 Key를 삭제 후 재생성하는 수밖에 없습니다. 페이지를 열어둔 채 방치하지 마세요. Binance는 세션 종료 시 반드시 숨깁니다.

Q: 하나의 API Key를 여러 기기에서 쓸 수 있나요? A: 기술적으로는 가능하지만(모든 기기 IP를 화이트리스트에 등록) 권장하지 않습니다. 문제가 생기면 어느 기기가 주문했는지 특정할 수 없습니다. 기기당 Key 하나를 원칙으로 하세요.

5. 90일 로테이션 자동화

biabalab 팀의 로테이션 절차는 다음과 같습니다.

  1. 매월 1일 API 관리 페이지를 스캔하여 60일 초과한 Key에 「로테이션 대기」 라벨을 붙입니다.
  2. 5일 전에 미리 동일 권한의 신규 Key를 생성합니다.
  3. 전략 설정에서 그레이 스위칭을 진행: 신규 Key가 10% → 50% → 100% 트래픽을 담당.
  4. 24시간 무이상 관찰 후 API 관리 페이지로 돌아가 구 Key를 삭제.
  5. 로테이션 이력을 사내 로그에 기록.

로테이션을 하지 않는 리스크: Key가 유출되어도 알아채지 못할 수 있으며, 장기 유출 = 장기 감시입니다. 로테이션은 유출 창구를 강제로 리셋하는 것과 같습니다.

6. 알림 스크립트 예시

biabalab는 초경량 일일 점검 스크립트 도입을 권장합니다(Python 유사 코드, 구조 설명용).

  1. 매일 09:00 /sapi/v1/account/apiTradingStatus를 호출해 리스크 관리 점수 확인.
  2. 매일 09:00 /api/v3/account를 호출해 현물 잔액 diff, 5% 초과 이상 변동은 리포트.
  3. 매일 09:00 화이트리스트 IP 목록을 조회하여 설정 파일과 비교, 불일치 시 즉시 알림.
  4. 매일 09:00 Key 생성 시각을 확인해 잔여 수명 10일 미만이면 리포트.

알림 채널은 이메일 + 사내 메신저 이중 채널로 구성하여 단일 채널 하이재킹을 방지합니다.

7. 유출 후 지혈 4단계

  1. 즉시 Binance 공식 사이트에서 해당 API Key를 삭제(비밀번호 변경보다도 우선순위 위).
  2. 계정의 「API 거래」 마스터 스위치를 끄고 모든 Key를 일괄 무력화.
  3. 최근 24시간의 주문·출금·내부 이체 기록을 확인.
  4. 이미 손실이 발생했다면 고객지원 이의신청 진행. 동시에 Key 유출 소스(GitHub 커밋, 메모 앱, 화면 녹화)를 근절.

리스크 안내: 유출 후에는 망설이지 마세요. Key 삭제는 무손실 작업이며, 잘못 지워도 몇 분 안에 재생성하면 됩니다. 그러나 10분 지연은 전 잔고 손실이 될 수 있습니다.

8. 자주 묻는 질문

Q: 화이트리스트에 도메인을 넣을 수 있나요?

A: 불가능합니다. Binance는 IPv4 주소 또는 IPv4 CIDR만 받습니다. IPv6는 현재 미지원입니다. 기기가 IPv6 출구만 있다면 NAT64나 VPS를 경유해 IPv4로 변환해야 합니다.

Q: VPS의 IP가 바뀌면 어떻게 하나요?

A: Binance 로그인 → API 관리 → Key 편집 → 화이트리스트 IP 수정 → 저장. 화이트리스트 수정은 쿨다운이 없고 즉시 적용됩니다. 이 점은 출금 화이트리스트와 다른, 거래 Key 유연성을 위한 설계입니다.

Q: 「조회」와 「출금」만 켜고 「거래」는 끄는 조합이 가능한가요?

A: 가능합니다. Binance 권한은 독립적으로 체크됩니다. 재무 집계 Key가 대표적으로 이런 구성입니다. 잔액 조회 + 출금, 거래 없음.

Q: API 요청이 레이트리밋을 초과하면 Key가 밴되나요?

A: Key는 밴되지 않고 IP가 차단됩니다(HTTP 418 반환). IP가 차단되면 다른 Key도 사용할 수 없습니다. 전략별로 레이트리밋의 20% 여유를 남겨 두세요.

9. 다운로드와 확장

계정이 없는 신규 사용자는 먼저 Binance 공식 사이트에서 회원가입 후 Binance 공식 앱을 설치하고 돌아와 API를 설정하는 순서를 추천합니다. 설치 파일은 다운로드 페이지에서도 받을 수 있습니다. 앱에서도 API Key 생성·관리가 가능하며 경로는 「내 정보 → 보안 → API 관리」입니다.

사내 확장 자료: Binance 출금 화이트리스트 실전은 계정 층의 화이트리스트 메커니즘을 보완하며 API IP 화이트리스트와 다른 계층의 두 자물쇠입니다. Binance 2FA 기기 교체·앱 이관 완전 마이그레이션 가이드는 API Key 생성 전에 먼저 정비해야 할 2FA 기초를 다룹니다.

10. 설정 자기 점검 체크리스트

점검 항목 달성 여부
용도별 독립 Key 예 / 아니오
모든 Key에 IP 화이트리스트 활성 예 / 아니오
출금 권한은 재무 집계 Key에만 예 / 아니오
서버리스는 NAT 고정 출구 사용 예 / 아니오
Secret Key는 평문 아닌 패스워드 매니저에 저장 예 / 아니오
Key 이름에 용도+날짜 포함 예 / 아니오
90일마다 로테이션 예 / 아니오
일일 잔액·화이트리스트 점검 스크립트 예 / 아니오
유출 대응 매뉴얼 아카이빙 예 / 아니오

모두 「예」여야 API Key 설정이 기준선을 충족합니다.

11. 리스크 안내

리스크 안내: API Key의 모든 권한 확대는 공격면 확대를 동반하며, 「일단 다 켜두고 문제 생기면 그때 끄자」는 편의주의는 실전에서 반드시 시장에 학습당합니다. biabalab 팀이 복기한 5건의 API Key 사고 중 4건은 출금 권한 미차단이 원인, 1건은 화이트리스트에 0.0.0.0/0을 기입한 것이 원인이었습니다. 6번째 사례가 되지 마세요. API Key를 자동 생성한다는 서드파티 스크립트, Chrome 확장, Telegram 봇은 모두 잠재적 중간자이며, 반드시 Binance 공식 사이트에서 직접 손으로 생성해야 합니다.

문서 게시일 2026-07-01, 다음 재검증 예정 2026-10-01