가이드 센터로 돌아가기
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 가 변경될 수 있으며, 바뀌면 빠른 등록·설정 화면의 「서비스 IP」 칸에 바뀐 IP 가 표시됩니다. 정식 출시 시 고정 IP 로 안정화할 예정입니다.

베타 1차

Cloudflare Tunnel 임시 URL (변경 가능)

현재 IP 는 「API 키 빠른 등록」 2단계와 설정 「서비스 IP」 칸에 표시

베타 1차는 소수 초대 인원으로 진행합니다. 베타 URL 이 임시 도메인이라 outbound IP 가 변경될 수 있습니다.

베타 2차+

고정 베타 도메인 (bnvault.io 베타 서브)

현재 IP 는 「API 키 빠른 등록」 2단계와 설정 「서비스 IP」 칸에 표시

베타 2차부터는 고정 IP 1~2개로 안정화합니다. 바뀌면 같은 두 화면에 바뀐 IP 가 표시됩니다.

정식 출시

고정 outbound IP (변경 빈도 낮음)

정식 출시 후에도 같은 두 화면에 표시

정식 출시 = 고정 IP 1~2개 (failover 포함). 서비스 IP 가 바뀌면 빠른 등록·설정 화면의 「서비스 IP」 칸에 바뀐 IP 가 표시됩니다.

※ 베타 단계별 IP 는 변경될 수 있습니다. 등록 직전에 빠른 등록 2단계나 설정 「서비스 IP」 칸에서 현재 IP 를 다시 확인한 뒤 등록해주세요.

API 키 빠른 등록에서 현재 서비스 IP 확인
Upbit

업비트 허용 IP 등록 단계

  1. 01

    Open API 관리 화면 진입

    업비트 PC 웹에서 로그인 후 마이페이지 → Open API 관리 화면으로 이동합니다.

    모바일 앱이 아닌 PC 웹에서 진행합니다.

  2. 02

    허용 IP 입력란 확인

    API 키 발급 화면에서 허용 IP 입력란을 찾습니다. 업비트는 키 발급 시 허용 IP 등록을 요구합니다.

    허용 IP 가 비어 있으면 API 호출이 차단되므로 반드시 입력합니다.

  3. 03

    BlockNuri 서버 outbound IP 입력

    「API 키 빠른 등록」 2단계(키 만들기)나 설정 「거래소 API 키」의 「서비스 IP」 칸에 표시된 IP 를 복사해 입력합니다. IP 가 바뀌면 같은 칸에 바뀐 IP 가 표시됩니다.

    개인 PC 의 사설 IP 나 유동 IP 를 대신 넣지 않습니다.

  4. 04

    발급 + 등록 확인

    허용 IP 입력 후 2채널 인증을 거쳐 키를 발급합니다. BlockNuri 등록 화면에서 「안내한 IP 를 등록했습니다」를 직접 체크하고, 등록 직후 자동으로 도는 「조회 확인」 통과 여부를 확인합니다.

    「조회 확인」 실패 시 허용 IP 부터 다시 확인합니다.

Bithumb

빗썸 허용 IP 등록 단계

  1. 01

    API 관리 화면 진입

    빗썸 PC 웹에서 로그인 후 마이페이지 → API 관리 화면으로 이동합니다.

    PC 웹 사용을 권장합니다.

  2. 02

    허용 IP 등록

    API 키 발급 화면에서 허용 IP 입력란에 「API 키 빠른 등록」 2단계나 설정 「서비스 IP」 칸에 표시된 BlockNuri 서버 IP 를 입력합니다.

    허용 IP 미등록 시 모든 인증 호출이 거부됩니다.

  3. 03

    발급 + 등록 확인

    키 발급 후 BlockNuri 등록 화면에서 「안내한 IP 를 등록했습니다」를 직접 체크하고, 「조회 확인」 통과 여부를 확인합니다. 실패 시 허용 IP 와 권한 범위 부터 확인합니다.

    변동 IP 환경 (사내망 / 모바일 핫스팟) 에서는 BlockNuri IP 만 등록합니다.

FAQ

자주 묻는 질문

vault 모드를 쓰면 IP 등록을 생략해도 되나요?
아니요. vault 모드 + server 모드 모두 BlockNuri 서버 outbound IP 를 사용합니다. vault 모드는 키 평문이 서버 메모리를 거치지 않을 뿐, 거래소 API 호출 자체는 BlockNuri server-proxy 를 경유하므로 outbound IP 는 동일합니다.
허용 IP 가 여러 개 필요한가요?
베타 단계에서는 1개 IP 만 등록합니다. 정식 출시 시 failover IP 가 추가되면 빠른 등록·설정 화면의 「서비스 IP」 칸에서 확인해 추가 등록합니다.
BlockNuri 알림 없이 IP 가 갑자기 바뀌면?
거래소가 등록되지 않은 IP 의 호출을 거부하므로 조회와 주문이 모두 실패합니다. 빠른 등록·설정 화면의 「서비스 IP」 칸에서 바뀐 IP 를 확인한 뒤 거래소에 새 IP 를 등록하고, 설정에서 「조회 확인」을 다시 눌러 복구합니다.
내 PC 의 IP 를 등록하면 되나요?
안 됩니다. BlockNuri 가 거래소 API 를 호출하는 주체이므로 BlockNuri 서버 outbound IP 를 등록해야 합니다. 개인 PC IP 를 등록하면 BlockNuri 호출이 차단됩니다.

※ 본 페이지는 거래소 API 키의 허용 IP 등록 절차를 안내합니다. 매매 행위는 모두 사용자 본인 책임이며, BlockNuri 는 매매 권유를 하지 않습니다.