Bybit API 액세스를 위한 IP 화이트리스트를 구성하는 방법은 무엇입니까?

Bybit API IP 화이트리스트 구성 개요

1. Bybit는 프로덕션 환경에서 사용되는 모든 API 키에 대해 엄격한 네트워크 수준 인증을 요구합니다. 요청 원본 지점을 제한하려면 각 API 키를 정의된 IPv4 주소 집합과 연결해야 합니다.

2. IP 화이트리스트는 인증이나 권한 확인이 이루어지기 전에 거래소의 게이트웨이 계층에서 시행됩니다. 화이트리스트에 없는 IP의 요청은 즉시 HTTP 403 Forbidden 응답을 받습니다.

3. Bybit는 IPv6 화이트리스트를 지원하지 않습니다. 구성 중에는 IPv4 주소 또는 CIDR 표기법(예: 203.0.113.42/32 또는 192.0.2.0/24)만 허용됩니다.

4. 단일 API 키는 개별 주소 및 서브넷 범위를 포함하여 최대 20개의 개별 IPv4 항목을 보유할 수 있지만, 중복되는 CIDR 블록은 제출 시 거부됩니다.

5. IP 화이트리스트에 대한 변경 사항은 키를 재생성하거나 서비스를 다시 시작할 필요 없이 30초 이내에 적용됩니다.

Bybit 웹 인터페이스를 통한 단계별 화이트리스트 설정

1. 공식 도메인 www.bybit.com 을 사용하여 Bybit 계정에 로그인하고, Bybit Limited에서 발급한 SSL 인증서를 확인하고, 이중 인증이 활성화되어 있는지 확인하세요.

2. 계정 설정 → 보안 → API 관리 로 이동하여 대상 API 키 항목을 찾습니다.

3. 키 옆에 있는 연필 아이콘을 클릭하여 편집 모드를 연 다음 "IP 화이트리스트" 섹션을 확장합니다.

4. 하나 이상의 IPv4 주소 또는 CIDR 블록을 줄 바꿈으로 구분하여 입력합니다. 쉼표나 세미콜론은 허용되지 않습니다.

5. 이메일 확인과 Google OTP 코드를 모두 사용하여 변경 사항을 확인합니다. 두 단계 중 하나라도 실패하면 전체 업데이트가 되돌려집니다.

화이트리스트 검증 및 문제 해결

1. 저장한 후 올바른 헤더와 서명이 있는 컬 또는 Postman을 사용하여 /v5/account/info 에 대한 테스트 호출을 시작합니다.

2. 응답에 retCode: 10004 가 포함되어 있으면 자격 증명이 유효하더라도 원래 IP가 승인된 목록에 없음을 나타냅니다.

3. ip138.com을 사용하거나 ifconfig.me를 컬링하여 트레이딩 봇이나 스크립트를 호스팅하는 시스템의 공개 IP 주소를 확인하세요.

4. 클라우드 인프라에 배포할 때는 공용 IP만 평가하므로 프라이빗 VPC 주소가 아닌 탄력적 IP 또는 NAT 게이트웨이 주소를 검색합니다.

5. Bybit의 API를 통해 화이트리스트를 자동으로 업데이트하는 안정적인 DDNS 서비스와 연결되지 않는 한 동적 주거용 IP를 사용하지 마세요.

잘못 구성된 화이트리스트의 보안 영향

1. 화이트리스트를 비워두면 키 유효성에 관계없이 모든 액세스가 비활성화되어 합법적인 트래픽을 효과적으로 차단합니다.

2. 0.0.0.0/0 또는 이와 유사한 확장 마스크를 입력하면 Bybit의 보안 정책에 위배되며 자동화 시스템에 의해 키가 즉시 비활성화됩니다.

3. 화이트리스트를 업데이트하지 않고 여러 서버에서 동일한 API 키를 재사용하면 하나의 호스트가 손상된 경우 자격 증명이 측면 이동에 노출됩니다.

4. 인프라 마이그레이션 후 IP 교체에 실패하면 자격 증명이 그대로 유지되고 권한이 변경되지 않은 경우에도 지속적인 403 오류가 발생합니다.

5. 암호화 없이 버전 관리 구성 파일에 화이트리스트 IP를 저장하면 코드 감사 또는 저장소 유출 중에 우발적으로 노출될 위험이 높아집니다.

자주 묻는 질문

Q1: Bybit IP 화이트리스트에서 localhost 또는 127.0.0.1을 사용할 수 있나요? Bybit는 루프백 주소를 완전히 거부합니다. 로컬 개발은 공개적으로 라우팅 가능한 IP를 통해 라우팅하거나 화이트리스트가 비활성화된 Bybit의 테스트넷 환경을 사용해야 합니다.

Q2: Bybit는 와일드카드 도메인이나 호스트 이름 기반 화이트리스트를 허용합니까? 아니요. 숫자 IPv4 주소와 CIDR 블록만 허용됩니다. 검증 중에는 DNS 확인이 수행되지 않습니다.

Q3: 화이트리스트가 고정된 상태에서 내 서버의 공용 IP가 변경되면 어떻게 됩니까? 화이트리스트가 현재 주소로 수동으로 업데이트될 때까지 새 IP의 모든 API 요청은 오류 코드 10004와 함께 실패합니다.

Q4: Bybit의 REST API를 사용하여 IP 화이트리스트를 프로그래밍 방식으로 업데이트하는 방법이 있습니까? Bybit는 API 키 설정 수정을 위한 엔드포인트를 노출하지 않습니다. 화이트리스트 편집에는 웹 인터페이스 또는 모바일 앱을 통한 대화형 인증이 필요합니다.