Binance API 키 권한 잠금|Biabafox 빠른 조회
Biabafox가 Binance API 키의 5가지 권한(읽기/현물/선물/마진/출금)을 세분화하고, IP 화이트리스트 조회표 + 고위험 시나리오 함정 회피 + 키 유출 6단계 응급 절차를 제공합니다.
API 키는 계정에서 가장 유출되기 쉬우면서도 가장 회복하기 어려운 자격 증명입니다. 결론부터: Binance API 키의 보안 원칙은 한 문장으로 요약됩니다. "읽기만 필요하다면 절대 거래 권한을 주지 말고, 단일 IP로 제한할 수 있다면 절대 전체 네트워크 접근을 허용하지 말고, 명확한 필요와 위험 이해가 없다면 절대 출금 권한을 체크하지 마시오." Biabafox는 Binance API 권한의 5대 유형, IP 화이트리스트 메커니즘, 7가지 고위험 시나리오, 6단계 유출 응급 절차를 한 편의 조회표로 압축하여 30분 안에 재현 가능한 API 보안 조작 규범을 구축하도록 돕습니다.
아직 API 키가 없다면 먼저 Binance 공식 사이트에서 계정 실명 인증과 2FA를 완료하거나 다운로드 페이지의 Binance 공식 앱으로 보안 설정을 진행하십시오. 본문은 이러한 사전 작업이 완료되었다고 가정합니다.
시나리오와 독자 프로파일
- 적용 시나리오: 퀀트 거래, 데이터 분석, 시세 대시보드, 거래소 간 차익, 마켓 메이킹
- 난이도: 중상(권한 모델, IP 대역, 서명 메커니즘 관여)
- 예상 시간: 단일 키 생성 + 권한 계획 15분, 응급 훈련 30분
- 대상 사용자: 퀀트 사용자, 개발자, 기관 API 연동, 시세 도구 저자
- 필요 기기: 안정된 IP의 서버 한 대 + 관리용 PC 한 대
- 네트워크: API 측 고정 공용 IP, 관리 측은 Binance 공식 사이트에 정상 접속 가능
- 위험 등급: 높음(유출 시 전 자산 손실 가능)
- 비용: 0원
- 대체 방안: 웹/앱 수동 조작만 사용(안전하지만 자동화 불가)
- 흔한 실수: 권한 한 번에 모두 부여, IP 화이트리스트 없음, secret을 코드 저장소에 기입
- 검증 방법: 읽기 전용 키로 주문 시도 시 오류, IP 제한 키를 다른 IP에서 사용 시 오류
5가지 권한 빠른 조회표
Biabafox는 Binance 실제 옵션에 따라 권한을 약한 것부터 강한 순서로 5가지로 분류했습니다.
| 권한 | 할 수 있는 것 | 유출 후 손실 상한 | 활성화 권장 시나리오 | 권장 조합 |
|---|---|---|---|---|
| 읽기 | 시세, 계정 잔액, K선 조회 | 프라이버시 유출 | 데이터 분석, 시세 대시보드 | IP 없이도 사용 가능 |
| 현물 거래 | 주문, 취소, 체결 | 코인이 저유동성 코인으로 악의 교체 | 현물 퀀트 | IP 화이트리스트 필수 |
| 마진 거래 | 대출, 상환, 마진 주문 | 청산 트리거 | 마진 전략 | IP 화이트리스트 필수 |
| 선물 거래 | USDT 마진/코인 마진 선물 주문 | 리스크 컨트롤 없이 전액 청산 | 선물 퀀트 | IP 화이트리스트 + 리스크 컨트롤 필수 |
| 출금 | 화이트리스트 주소로 직접 출금 | 전 자산 이체됨 | 극소수 커스터디 시나리오 | 강제 IP + 화이트리스트 잠금 |
A: Biabafox의 반복 강조: 99%의 퀀트 사용자는 출금 권한이 필요 없으며, 이 항목을 비워두면 90% 이상의 자산 위험을 잘라낼 수 있습니다. secret이 유출되더라도 공격자는 최대 계정에서 마구잡이 주문만 할 수 있으며 코인을 이체할 수 없습니다. 이것이 API 보안의 제1원칙입니다.
권한 조합의 3가지 층위
용도별로 흔한 세 가지 키 조합을 분해합니다.
- 읽기 전용 키: "읽기"만 체크, IP 화이트리스트 없이도 사용 가능. 시세 대시보드, 계정 잔액 표시에 적합
- 거래 키: "읽기 + 현물/선물" 체크, 반드시 고정 IP 바인딩. 퀀트 봇에 적합
- 출금 키: 봇이 Binance에서 콜드 지갑으로 자동 이체해야 하는 경우에만 생성. 강제 IP + 강제 출금 화이트리스트 잠금
IP 화이트리스트 빠른 조회
IP 화이트리스트는 API 보안의 두 번째 자물쇠이며, 권한 잠금과 동등하게 중요합니다.
| IP 구성 | 지원 API 권한 | 유효 기간 |
|---|---|---|
| IP 미설정 | "읽기"만 사용 가능 | 90일 자동 만료 |
| 단일 IP 설정 | 전체 권한 | 장기 유효 |
| 다중 IP 설정(콤마 구분) | 전체 권한 | 장기 유효 |
| IP 대역 설정 | 지원 안 함 | 없음 |
| IPv6 설정 | 지원 | 장기 유효 |
흔한 배포 시나리오 대조
| 배포 위치 | 권장 IP 구성 | 비고 |
|---|---|---|
| 알리바바 클라우드/텐센트 클라우드 독립 공용 IP | 단일 고정 IP | 가장 권장 |
| AWS EIP | 단일 고정 IP | 가장 권장 |
| Cloudflare Workers | 출구 프록시 통해 고정 | 중계 필요 |
| 가정용 동적 IP | DDNS + 매일 갱신 | 프로덕션 비추천 |
| 모바일 네트워크 | 완전 비추천 | IP가 몇 분마다 변경 |
A: Biabafox의 권고: 고정 IP 없는 환경에는 거래 권한 있는 API 키를 배포하지 마시오. 임시 테스트로 읽기 권한만 필요하다면 완료 후 삭제. 저렴함을 노려 가정 PPPoE 다이얼업 IP에서 돌리는 것보다 고정 IP 서버에 옮겨 서비스하는 것이 낫습니다.
90일 만료 메커니즘
Binance는 2023년부터 IP 제한 없는 키에 강제로 90일 유효 기간을 부여합니다.
- 최초 생성 후 90일 자동 비활성화(읽기 권한도 비활성화)
- 만료 7일 전부터 이메일 알림 시작
- 갱신 시 2FA 재인증 필요
- IP 화이트리스트 추가 시 만료 기간 없음(권장 방법)
7가지 고위험 시나리오 함정 회피
Biabafox가 커뮤니티 API 유출 사건을 회고한 결과, 가장 흔한 7가지입니다.
| 시나리오 | 위험 등급 | 수정 방법 |
|---|---|---|
| secret을 Git 저장소에 직접 기입 | 매우 높음 | 즉시 키 삭제 + 환경 변수 주입 |
| 스크린샷으로 코드 공유 시 API 비밀키 노출 | 높음 | 즉시 키 삭제 + 이력 메시지 확인 |
| 공용 Discord/Telegram 그룹에 로그 게시 | 높음 | 로그 마스킹 + 즉시 키 삭제 |
| 동일 키를 여러 전략에 공유 | 중 | 전략마다 하나씩, 추적 용이 |
| IP 화이트리스트 없이 "어떤 IP도 접근 가능" | 매우 높음 | 즉시 IP 추가 또는 키 삭제 |
| 일상 퀀트용으로 출금 권한 체크 | 매우 높음 | 즉시 출금 권한 취소 |
| 거래 키를 비밀번호 관리자 "비고" 필드에 저장 | 중 | 암호화 비고로 이동 + 정기 순환 |
secret 저장의 3가지 절대 규칙
- 절대 코드 저장소에 넣지 않음(
.gitignore로는 부족,git-secrets로 스캔) - 프로덕션 환경은 환경 변수 또는 키 관리 서비스(KMS, Vault) 사용
- 로컬 개발은
.env파일 사용,.env는 절대 push 금지
유출 응급 6단계 절차
secret 유출이 의심되면 Biabafox는 5분 이내에 다음 순서로 처리할 것을 권장합니다.
| 단계 | 조작 | 시간 예산 |
|---|---|---|
| 1 | Binance 공식 사이트 로그인 → API 관리 → 의심 키 즉시 비활성화 | 30초 |
| 2 | 계정 비밀번호 변경 + 모든 세션 강제 로그아웃 | 1분 |
| 3 | 최근 24시간 주문, 이체, 출금 기록 확인 | 2분 |
| 4 | 서브 계정과 선물 계정 이상 여부 확인 | 1분 |
| 5 | 비정상 주문 있으면 Binance 상담원에 연락하여 계정 동결 | 수동 |
| 6 | 유출 경로 회고 및 강화(IP 화이트리스트, 권한 축소) | 사후 |
A: Biabafox의 반복 강조: 처리 순서는 "먼저 키 비활성화, 그다음 조사"이며 순서를 바꾸지 마시오. 공격자가 실시간으로 조작 중일 수 있으며, 30초 망설이면 악성 주문 한 건입니다.
사후 회고의 4가지 필수 확인 지점
- Git commit 이력(
git log --all -p | grep -i api) - 클라우드 드라이브/이메일 첨부 파일 "key", "secret" 검색
- 팀 협업 도구(Slack, Notion) 이력
- 로컬 셸 history, IDE 클립보드 캐시
자주 묻는 질문
Q1: 읽기 전용 키도 프라이버시가 유출될 수 있나요?
A: 유출됩니다. 읽기 전용 키는 계정 잔액, 주문 이력, 이체 기록을 읽을 수 있으며 이러한 데이터 자체가 피싱범에게 가치가 있습니다. Biabafox의 권장: 읽기 전용 키도 IP 화이트리스트 추가하십시오.
Q2: Binance는 HMAC-SHA256 이외의 서명 방식을 지원하나요?
A: 지원합니다. 2024년 이후 Binance는 Ed25519 서명을 도입했으며 키 길이가 더 짧고 서명 검증이 빠르고 양자 공격에 강합니다. Biabafox의 견해: 새 키는 Ed25519를 우선 선택, 특히 고빈도 퀀트 시나리오에서.
Q3: 서브 계정도 별도로 API 키를 발급할 수 있나요?
A: 가능합니다. 서브 계정 API는 주계정과 독립적이며 권한도 서브 계정 수준으로 세분화할 수 있습니다. Biabafox의 강력 권고: 전략 자금을 서브 계정으로 격리하여 키가 유출되더라도 손실이 서브 계정 잔액 내로 제한되도록 하십시오.
Q4: API 키가 불법 사용되고 있는지 어떻게 감지하나요?
A: Binance는 API 호출 로그를 제공하며 최근 30일간 각 키의 호출 소스 IP, 빈도, 이상 오류를 볼 수 있습니다. 매주 한 번 점검을 권장합니다. 소스 IP가 자신의 서버가 아니면 즉시 비활성화.
Q5: API 출금 권한과 계정 출금 화이트리스트는 어떤 관계인가요?
A: 중첩 관계입니다. API 출금 권한은 계정 수준 출금 화이트리스트 내 주소로만 출금할 수 있습니다. 그래서 API 출금 권한을 부여하더라도 공격자는 화이트리스트 주소로만 출금할 수 있고 자유롭게 이체할 수 없습니다. 이중 잠금의 전형적 조합입니다.
Q6: 집에 고정 IP가 없으면 퀀트를 완전히 못 하나요?
A: 아닙니다. 세 가지 선택 방안: (1) 월 5-10달러의 VPS를 임대해 고정 IP 사용, (2) Cloudflare Tunnel로 중계하여 모든 요청이 고정 출구를 통과하도록, (3) DDNS + Binance API로 IP 화이트리스트 정기 갱신(Binance는 API로 IP 화이트리스트 수정 지원, 다만 별도의 관리 키 필요). Biabafox는 방안 1을 권장하며 가장 편합니다.
Q7: 하나의 계정에 몇 개의 API 키를 만들 수 있나요?
A: 일반 계정은 30개, 기관 계정은 더 많이 만들 수 있습니다. Biabafox의 권장: 전략별, 팀원별, 용도별 각각 하나씩 만들어 감사와 폐기가 용이하도록. 사용 후 즉시 삭제하고 "나중에 쓸 수도 있으니" 남기지 마시오.
Q8: 유출 후 계정이 악의 주문된 것을 회수할 수 있나요?
A: 일반적으로 코인 가격 손실은 회수 불가입니다. IOC 주문으로 시장가보다 낮게 체결되거나 덤핑 등 이상 행위의 경우 Binance는 30일 내 이의 신청을 지원할 수 있지만 최종 반환 여부는 주문이 "악의 조작"에 해당하는지에 따라 다릅니다. Biabafox는 성공과 실패 사례를 각각 반반씩 보았으며, 가장 확실한 것은 사전 예방입니다.
위험 안내
API 키가 악의 사용되면 손실은 보통 몇 분 안에 완료되며, 계정을 수동으로 조작하는 공격보다 더 빠르고 은밀합니다. Biabafox의 강력 권고: 거래 권한 있는 모든 키는 반드시 고정 IP 바인딩, 출금 권한 체크 회피, 30일마다 한 번 점검, 90일마다 secret 순환하십시오. 암호화폐 투자 자체에는 시장 변동 위험이 있고, 퀀트 전략도 프로그램 버그로 손실이 발생할 수 있습니다. 본문은 "키 보안"이라는 한 고리만 해결하며 전략 손익은 다루지 않습니다. Binance 공식 사이트 또는 Binance 공식 앱의 정규 경로로 API 키를 관리하십시오.
내부 링크 내비게이션: 더 많은 입구 선택은 다운로드 페이지를 참조하시고, API 관리에 앱과 웹 중 무엇을 쓸지 망설인다면 PC와 웹 빠른 선택을 먼저 보고 결정하십시오.
문서 발행일 2026-07-10, 다음 재검토 예정일 2026-10-10.