SDK 환경설정
팝빌 SDK에는 프로그램 공급사의 개발환경을 지원하기 위한 별도의 Config 값이 존재하며, 개발환경에 따라 변수 값을 변경하여 팝빌 API를 이용할 수 있습니다.
<?php
require_once './Popbill/PopbillEasyFinBank.php';
// 링크아이디
$LinkID = 'TESTER';
// 비밀키
$SecretKey = 'SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=';
// 통신방식 기본은 CURL , curl 사용에 문제가 있을경우 STREAM 사용가능.
// STREAM 사용시에는 php.ini의 allow_url_fopen = on 으로 설정해야함.
define('LINKHUB_COMM_MODE','CURL');
// 계좌조회 서비스 객체 초기화
$EasyFinBankService = new EasyFinBankService($LinkID, $SecretKey);
// 연동환경 설정, true-테스트, false-운영(Production), (기본값:false)
$EasyFinBankService->IsTest(true);
// 인증토큰 IP 검증 설정, true-사용, false-미사용, (기본값:true)
$EasyFinBankService->IPRestrictOnOff(true);
// 통신 IP 고정, true-사용, false-미사용, (기본값:false)
$EasyFinBankService->UseStaticIP(false);
// 로컬시스템 시간 사용여부, true-사용, false-미사용, (기본값:true)
$EasyFinBankService->UseLocalTimeYN(true);
?>
1. 테스트 ↔ 운영(PROD) 전환 설정 – IsTest
팝빌은 테스트와 운영 환경을 독립적으로 지원하며 IsTest 변수를 이용하여 자유롭게 환경 전환(테스트↔운영)이 가능합니다.
구분 | 테스트 | 운영(Production) |
IsTest | true (기본값) | false |
URL | https://test.popbill.com | https://www.popbill.com |
국세청신고 | 가상으로 처리 | 실제 국세청 신고 |
API Key |
동일한 API Key (LinkID/SecretKey) 사용 ※ 테스트와 운영 환경을 구별하여 API Key 사용이 필요한 경우 별도 협의가 필요합니다. |
-
PHP SDK
- "servlet-contect.xml" 파일의 IsTest Property 값을 "true" 에서 "false" 로 변경합니다.
-
PHP Laravel SDK
- "config/popbill.php" 파일의 IsTest 변수 값을 true 에서 false 로 변경합니다.
팝빌 운영 전환은 제반사항(계약, 결제 등)에 대해 사전 협의가 필요합니다. [운영(PROD) 전환신청]
2. 인증 토큰 IP 설정 – IsIPRestrictOnOff
팝빌 API를 이용하기 위해서는 팝빌 인증서버로부터 Bearer Token 발급이 필요하며, 발급된 Token으로만 API 함수 호출이 가능합니다. 제 3자의 스누핑/스니핑에 의한 오사용 및 제반 사고를 방지하기 위해 팝빌 시스템은 Bearer Token 발급을 요청한 IP와 API를 호출하는 IP의 일치 여부를 검증하고 있으며, IsIPRestrictOnOff 변수에 따라 사용 여부를 설정할 수 있습니다.
구분 | true (기본값) | false |
IsIPRestrictOnOff | 인증 요청 IP↔API 호출 IP 일치 검증 | 인증 요청 IP↔API 호출 IP 일치 검증 생략 |
![링크허브 인증토큰 발급 과정](/images/guide/getting-started/image-sdk-configration-IPRestrict.png)
3. 통신 IP 고정(방화벽 지원) – UseStaticIP
시스템 내부 보안 또는 방화벽 정책에 의해 고정 IP로 팝빌 API를 이용하는 프로그램 공급사의 경우 UseStaticIP 변수 값으로 고정 IP 사용 여부를 설정할 수 있습니다. 팝빌은 사전에 지정한 IP의 통신 접근만을 허용하는 IP 화이트리스트를 제공함으로써 프로그램 공급사의 안전한 데이터 통신을 지원합니다.
구분 | true | false (기본값) |
UseStaticIP | 고정 IP 사용 | 유동 IP 사용 |
-
기본 도메인(Elastic IP) : 방화벽 정책 또는 보안장치 등록 불가
- 1) 인증서버 : https://auth.linkhub.co.kr
- 2) 운영(Production) : https://popbill.linkhub.co.kr
- 3) 테스트 : https://popbill-test.linkhub.co.kr
-
고정 도메인(Static IP) : 52.78.164.186 / 13.124.222.90
- 1) 인증서버 : https://static-auth.linkhub.co.kr
- 2) 운영(Production) : https://static-popbill.linkhub.co.kr
- 3) 테스트 : https://static-popbill-test.linkhub.co.kr