'호출이 허용되지 않은 IP' 응답은 어떻게 해결하나요?

[commerce-api-naver]

'호출이 허용되지 않은 IP' 응답은 어떻게 해결하나요?

A: [커머스API센터 > 내 스토어 애플리케이션] 내 대상 애플리케이션에 'API호출 IP'로 호출 컴퓨터의 Outbound IP를 추가해보세요.

안전한 커머스API 이용을 위해 사전에 등록하신 IP 주소로만 API 호출이 가능합니다.
커머스API 플랫폼에 도달한 HTTP 요청 기준으로 등록된 IP 주소와 다른 IP 주소로 호출하신 경우 아래와 같은 응답이 반환됩니다.

예시 1: 'API호출 IP' 외 다른 IP에서 호출한 경우 응답 (HTTP 403 Status)

{
    "code": "GW.IP_NOT_ALLOWED",
    "message": "호출이 허용되지 않은 IP입니다.",
    "timestamp": "2025-02-10T00:00:00.000+09:00",
    "traceId": "pr1-000000-0aaaaa^0000000000000^00000000"
}

IP 주소 판단 기준

• IPv4 형태의 주소 (IPv6 미지원)
• 내 스토어 애플리케이션 당 최대 3개 IPv4 주소 등록 가능
• 사용자 호출 컴퓨터의 Outbound IP 기준
  • 호출 컴퓨터 로컬에 설정된 IP 주소가 사설 IP 대역인 경우 'API호출 IP'는 NAT IP 주소로 설정하여야 합니다.
• 대한민국 할당 IP 주소 대역 이용 권장
  • 참고: 국가별 IP 주소 대역별 현황 – KRNIC

'API호출 IP' 확인과 관리

[커머스API센터 > 내 스토어 애플리케이션] 내 대상 애플리케이션의 'API호출 IP'를 확인합니다.

• 'API호출 IP' 변경이 필요한 경우 우측 상단 [수정] 버튼으로 등록/삭제 가능 (최대 3개 IP 등록 가능)

💡 클라우드 컴퓨팅 서비스 이용 시 'API호출 IP' 관리

대부분의 클라우드 컴퓨팅 서비스는 인스턴스의 외부 HTTP 요청 시 호출자 IP 주소가 수시로 변동되는 '유동 IP(Dynamic IP)' 체계를 활용합니다.
안정적인 커머스API 이용을 위해 대상 인스턴스에 공인 IP를 고정하여 할당받는 '고정 IP(Static IP)' 체계 이용이 필요할 수 있습니다. 이러한 서비스의 명칭은 각 클라우드 컴퓨팅 서비스별로 서로 다를 수 있습니다. (Public IP, Elastic IP 등)
이용중이신 클라우드 컴퓨팅 서비스 공급자를 통해 고정 IP 등록을 확인해보시기 바랍니다.

인스턴스 리전과 고정 IP 할당

일부 클라우드 컴퓨팅 서비스는 고정 IP 주소 할당 시 대상 인스턴스가 위치한 리전의 국가별 IP 주소 대역을 우선하여 할당합니다.
커머스API 호출과 관련 데이터 처리에 활용하는 인스턴스는 대한민국 내 리전에 위치하는 것을 권장하며 인스턴스의 고정 IP 주소 할당 시 대한민국에 할당된 IP 주소 대역을 할당받아 사용하시는 것을 권장합니다.
국가별 IP 주소 대역 기준으로 대한민국 외 국가의 IP 주소 대역이 할당되는 경우 원활한 커머스API 이용이 어려울 수 있습니다.

---

(마지막 변경일: 2025년 2월 18일)