IP allowlist

거래소 IP 화이트리스트 설정

BlockNuri 가 거래소 API 를 호출할 때, 사용자는 거래소 API 키의 허용 IP 에 BlockNuri 서버 outbound IP 를 등록해야 합니다. 등록을 빠뜨리면 모든 인증 호출이 거부됩니다.

vault 모드와 server 모드 모두 BlockNuri 서버 outbound IP 를 사용합니다. vault 모드도 거래소 호출 자체는 BlockNuri server-proxy 를 경유하므로 IP 등록 절차는 동일합니다.

Beta stage IP table

베타 단계별 outbound IP

베타 진행 중 IP 가 변경될 수 있으며, 변경 시 BlockNuri 알림으로 사전 공지합니다. 정식 출시 시 고정 IP 로 안정화됩니다.

베타 1차

TBD — 운영자가 베타 1차 진입 직전 공지

베타 1차 = 자가 / 환덕 한정. 베타 URL 이 trycloudflare 임시 도메인이라 outbound IP 가 변경될 수 있습니다.

베타 2차+

TBD — 베타 2차 진입 직전 공지

베타 2차 (울산 친구들 5명) 부터는 고정 IP 1~2개로 안정화. 변경 시 사전 안내.

정식 출시

TBD — 정식 출시 시 공지

정식 출시 = 고정 IP 1~2개 (failover 포함). 변경 시 30일 사전 공지.

※ 베타 단계별 IP 는 변경될 수 있습니다. BlockNuri 설정 화면 알림과 이메일 공지를 모두 확인한 뒤 등록해주세요.

Upbit

01
Open API 관리 화면 진입
업비트 PC 웹에서 로그인 후 마이페이지 → Open API 관리 화면으로 이동합니다.
모바일 앱이 아닌 PC 웹에서 진행합니다.
02
허용 IP 입력란 확인
API 키 발급 화면에서 허용 IP 입력란을 찾습니다. 업비트는 키 발급 시 허용 IP 등록을 요구합니다.
허용 IP 가 비어 있으면 API 호출이 차단되므로 반드시 입력합니다.
03
BlockNuri 서버 outbound IP 입력
위 베타 단계별 IP 표에서 현재 베타 단계의 IP 를 복사해 입력합니다. 베타 진행 중 IP 가 바뀌면 BlockNuri 알림으로 사전 공지합니다.
개인 PC 의 사설 IP 나 유동 IP 를 대신 넣지 않습니다.
04
발급 + 등록 확인
허용 IP 입력 후 2채널 인증을 거쳐 키를 발급하고, BlockNuri 설정에서 자동 health check 통과 여부를 확인합니다.
health check 실패 시 허용 IP 부터 다시 확인합니다.

Bithumb

01
API 관리 화면 진입
빗썸 PC 웹에서 로그인 후 마이페이지 → API 관리 화면으로 이동합니다.
PC 웹 사용을 권장합니다.
02
허용 IP 등록
API 키 발급 화면에서 허용 IP 입력란에 위 표의 BlockNuri 서버 outbound IP 를 입력합니다.
허용 IP 미등록 시 모든 인증 호출이 거부됩니다.
03
발급 + 등록 확인
키 발급 후 BlockNuri 설정에서 health check 통과 여부를 확인합니다. 실패 시 허용 IP 와 권한 범위 부터 확인합니다.
변동 IP 환경 (사내망 / 모바일 핫스팟) 에서는 BlockNuri IP 만 등록합니다.

FAQ

vault 모드를 쓰면 IP 등록을 생략해도 되나요?: 아니요. vault 모드 + server 모드 모두 BlockNuri 서버 outbound IP 를 사용합니다. vault 모드는 키 평문이 서버 메모리를 거치지 않을 뿐, 거래소 API 호출 자체는 BlockNuri server-proxy 를 경유하므로 outbound IP 는 동일합니다.
허용 IP 가 여러 개 필요한가요?: 베타 단계에서는 1개 IP 만 등록합니다. 정식 출시 시 failover IP 가 추가되면 사전 공지를 받고 추가 등록합니다.
BlockNuri 알림 없이 IP 가 갑자기 바뀌면?: health check 가 실패하므로 BlockNuri 가 자동으로 dry-run guard 로 복귀합니다. 실주문은 차단되며, IP 변경 공지 확인 후 거래소에 새 IP 등록 → 재 health check 흐름으로 복구합니다.
내 PC 의 IP 를 등록하면 되나요?: 안 됩니다. BlockNuri 가 거래소 API 를 호출하는 주체이므로 BlockNuri 서버 outbound IP 를 등록해야 합니다. 개인 PC IP 를 등록하면 BlockNuri 호출이 차단됩니다.