팝빌 SDK 환경설정

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

const
  // 링크아이디, 연동신청시 발급받은 정보로 변경
  LinkID = 'TESTER';

  // 비밀키, 연동신청시 발급받은 정보로 변경
  SecretKey = 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=';
  // 생략
  // ...
  // ...

var
  // 클래스 선언 추가
  htTaxinvoiceService : THometaxTIService;
  // 생략
  // ...
  // ...

  procedure TfrmExample.FormCreate(Sender: TObject);
  begin
    // 세금계산서 클래스 생성
    htTaxinvoiceService := THometaxTIService.Create(LinkID,SecretKey);

    // true - 개발용(테스트베드), false - 상업용(실서비스)
    htTaxinvoiceService.IsTest := true;

    // 인증토큰 IP제한기능 사용여부, true(권장)
    htTaxinvoiceService.IPRestrictOnOff := true;

    //로컬시스템 시간 사용여부, true(사용), false(미사용) - 기본값
    htTaxinvoiceService.UseLocalTimeYN := false;
end;
IsTest IsIPRestrictOnOff UseLocalTimeYN
true 팝빌 개발용 연동 Bearer Token의 IP 제한 로컬시스템 시간 사용
false 팝빌 상업용 연동 Bearer Token의 IP 미제한 API인증서버 시간 사용

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. UseLocalTimeYN – 로컬시스템 시간 사용 여부

API호출에 필요한 Bearer Token 발급과 발급 받은 Bearer Token의 유효성을 확인하기 위해 인증서버의 시간이 아닌 로컬시스템의 시간을 사용합니다. (true – 사용 / false – 미사용)

로컬시스템의 시간을 사용하면 Bearer Token 발급과 유효성 확인시 인증서버 시간을 가지고 오는 호출 과정을 제거함으로써 서비스의 성능을 향상시킬 수 있습니다.

기술지원센터

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

T. 1600-9854   E. code@linkhubcorp.com

연동문의