팝빌 SDK 환경설정

팝빌 SDK에는 고객사의 개발 환경을 지원하기 위한 별도의 Config 값이 존재하며, 개발 환경에 따라 변수 값을 변경하여 팝빌 API를 이용할 수 있습니다.

팝빌 PHP Laravel SDK Config 설정
IsTest IsIPRestrictOnOff UseStaticIP
true 팝빌 개발용 연동 Bearer Token의 IP 제한 고정 도메인(IP) 사용
false 팝빌 상업용 연동 Bearer Token의 IP 미제한 고정 도메인(IP) 미사용

1. IsTest – 팝빌 API 연동환경 설정

팝빌 API 서비스는 상업용/개발용 환경을 지원하며, IsTest 변수에 따라 팝빌 연동환경을 변경할 수 있습니다. (true – 개발용, false – 상업용)

발급받은 인증정보(LinkID/SecretKey)는 상업용과 개발에서 동일하게 사용되며, 상업용 전환 이후에서 변수값 변경을 통해 양쪽 모두 이용이 가능합니다.

※ 최초 상업용 전환을 위해서는 파트너센터(1600-8536)로 먼저 연락주시기 바랍니다.

※ Cache 값이 프로그램 또는 웹서버의 메모리에 남아 있을 수 있기 때문에 변경 후 프로그램 또는 웹서버 재시작을 해주시기 바랍니다.

IsTest에 따른 팝빌 API 연동환경

2. IsIPRestrictOnOff – Bearer Token의 IP 제한여부 설정

팝빌 API 서비스는 Bearer Token 발급을 요청한 IP와 API를 호출하는 IP의 일치 여부를 검사하며, IsIPRestrictOnOff 변수에 따라 사용 여부를 설정할 수 있습니다. (trueBearer Token의 IP 제한 / falseBearer Token의 IP 미제한)

팝빌 API를 이용하기 위해서는 팝빌 인증서버로부터 Bearer Token 발급이 필요하며 해당 Token으로만 API 함수 호출이 가능합니다. 이 과정에서 제 3자의 스누핑/스니핑에 의한 오사용 및 제반 사고를 방지하기 위해, Token을 발급 받은 IP와 API 서비스를 이용하는 IP에 대해 일치 여부를 검증하며 불일치하는 경우 API 서비스 이용이 불가능 합니다.

특정 Cloud 환경에서 SDK 코드를 업로드하여 실행하는 경우(ex. google App Engine), Bearer Token을 요청하는 IP와 API 서비스를 이용하는 IP가 다를 수 있기 때문에, IsIPRestrictOnOfffalse로 설정하여 IP 일치 여부 검증 과정을 생략할 수 있습니다.

Customer

Bearer Token 요청

IP100.40.0.12

Bearer Token 발급

Bearer Token을 이용한 API 서비스 호출

IP152.40.0.16

오류 발생

POPBiLL
인증 서버

POPBiLL
API 서버

IsIPRestrictOnOff = false
변경 필요

3. UseStaticIP – 팝빌 고정 도메인(IP) 사용 설정

시스템 내부 보안 또는 방화벽 정책으로 인해 고정된 IP 만으로 API를 이용하는 경우, UseStaticIP 변수 값으로 고정 도메인 사용 여부를 설정할 수 있습니다. (true – 사용 / false – 미사용)

팝빌 API 기본 도메인은 동적 IP을 사용하기 때문에 방화벽 정책 또는 보안 장치에 등록이 불가합니다. UseStaticIP 변수 값에 따라 SDK내에서 호출하는 팝빌 API 도메인이 변경되기 때문에 변수 값을 true(사용)로 설정하여 별도의 고정 IP(75.2.34.37/ 99.83.251.87)를 추가할 수 있습니다.

※ 팝빌 API는 443 TCP port를 사용합니다.

기술지원센터

팝빌 기술지원은 유선, 메일, 원격지원 등 다양한 채널을 통해 제공됩니다.

T. 1600-9854   E. code@linkhub.co.kr

연동문의