SDK 환경설정

SDK 사용을 위한 설정 옵션과 통신 환경을 안내합니다.

설정 옵션

팝빌 SDK는 다양한 환경에서 사용할 수 있도록 다음의 옵션을 제공합니다.
고객사 서비스 환경에 맞춰 옵션을 설정하여 안정적으로 API를 이용할 수 있습니다.

const
  // 링크아이디
  LinkID = 'TESTER';

  // 비밀키
  SecretKey = 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=';
// 생략
// ...
// ...

var
  //  서비스 객체 선언
  Service : TService;
// 생략
// ...
// ...

procedure TfrmExample.FormCreate(Sender: TObject);
begin
  //  서비스 객체 초기화
  Service := TService.Create(LinkID,SecretKey);

  // 연동환경 설정, true-테스트, false-운영(Production), (기본값:false)
  Service.IsTest := true;

  // 인증토큰 IP 검증 설정, true-사용, false-미사용, (기본값:true)
  Service.IPRestrictOnOff := true;

  // 예외 처리 설정, true-사용, false-미사용, (기본값:true)
  Service.IsThrowException := true;

  // 로컬시스템 시간 사용여부, true-사용, false-미사용, (기본값:false)
  Service.UseLocalTimeYN := false;
end;

IsTest : 연동환경(테스트/운영) 설정

팝빌 API 연동환경은 테스트 환경과 운영 환경으로 구분되며, 각 환경은 독립된 시스템으로 구성되어 있습니다.
IsTest 설정값을 변경하여 연동환경 전환(테스트 ↔ 운영)이 가능합니다.

IPRestrictOnOff : 인증토큰 IP 검증 설정

팝빌 API는 인증서버로부터 Bearer Token을 발급받아 호출이 가능합니다. 보안 강화를 위해 기본적으로 토큰 발급 요청 IP와 API 호출 IP가 일치 여부를 검증하고 있으며, 검증 기능은 IPRestrictOnOff 설정값으로 제어할 수 있습니다.

UseStaticIP : 통신 IP 고정(방화벽)

고객사 보안정책(방화벽 등)으로 인해 Outbound 트래픽의 고정 IP 설정이 필요한 경우,
팝빌 SDK 설정의 UseStaticIP 값을 변경하여 고정 IP를 사용할 수 있습니다.

통신

팝빌 API는 REST 기반으로 HTTP 요청이 가능한 모든 운영체제(OS), 데이터베이스(DB) 환경에서 사용할 수 있습니다.
API 호출과 응답에 사용되는 문자 인코딩은 UTF-8 Character Set을 지원합니다.

통신 정책

API 연동을 위한 기본 규격은 다음과 같습니다.

• HTTPS RESTful API
• TLS v1.2, v1.1 지원
• JSON(JavaScript Object Notation) 기반 메시지 포맷

IP 및 URL (방화벽)

방화벽 설정은 "Elastic IP(가변 IP)" 또는 "Static IP(고정 IP)" 선택하여 적용할 수 있습니다.
어떤 IP가 적용되는지는 SDK의 [UseStaticIP - 통신 IP 고정(방화벽)] 설정값에 따라 적용됩니다.

Elastic IP (기본값)

Elastic IP는 AWS의 ALB(Application Load Balancer)를 통해 탄력적으로 변하는 가변(Dynamic) IP입니다.
SDK의 설정값 “UseStaticIP=false”로 설정하면 Elastic IP가 적용됩니다.

Static IP

고객사 Outbound 트래픽에 고정 IP 설정이 필요한 경우 사용합니다.
SDK의 설정값 “UseStaticIP=true”로 설정하면 Static IP가 적용됩니다.