통신
통신
모든 카카오써트 API는 REST API로 제공되며, HTTP 요청을 보낼 수 있는 환경이라면 OS, DB 제한없이 이용 가능합니다. SSL(Secure Sockets Layer)이 적용된 HTTPS 프로토콜만 호출이 가능하며, API 요청에 대해 JSON 형태로 응답결과를 제공합니다. 카카오써트 API 요청을 처리하는 과정에서 오류가 발생하는 경우, HTTP Status 코드와 함께 오류코드와 메시지로 구성된 응답을 반환합니다.
1. 통신 정책
HTTPS 통신 / TLS 1.2, 1.1 지원
2. 망 구성
- ㆍ인터넷망(공중망) - Elastic IP
- ㆍ인터넷망(공중망) - Static IP
- ㆍ전용선
3. 서버 정보
Elastic IP(기본값)
AWS Cloud의 ALB 서비스를 이용하여 탄력적인 가변(Dynamic) IP를 반환하는 Domain 입니다. 바로써트 SDK의 UseStaticIP를 false(기본값)로 설정하는 경우 Elastic IP가 적용됩니다.
| 구분 | URL | Port |
|---|---|---|
| 링크허브 인증서버(공통) | https://auth.linkhub.co.kr | 443 |
| 카카오써트 API 서버 | https://barocert.linkhub.co.kr |
Static IP
① 보안정책 또는 방화벽으로 인해 Outbound Traffic(고객사->카카오써트)의 고정 IP 설정이 필요한 경우, 아래의 Outbound 정보를 등록합니다.
| 구분 | URL | IP | Port |
|---|---|---|---|
| 링크허브 인증서버(공통) | https://static-auth.linkhub.co.kr | 52.78.164.186 13.124.222.90 |
443 |
| 카카오써트 API 서버 | https://static-barocert.linkhub.co.kr |
② 바로써트 SDK의 UseStaticIP를 True로 설정하는 경우 Static IP가 적용됩니다. [SDK 환경설정]
③ 방화벽 등록 이후 아래의 가이드를 통해 통신 여부를 확인합니다.
아래의 명령어를 사용하여 인증 서버 또는 API 서버와의 통신 여부를 확인할 수 있습니다.
2023-01-01T00:00:00Z 포맷의 시간값이 출력되지 않는다면 문의부탁드립니다.
- curl -v https://static-auth.linkhub.co.kr/Time
- curl -v https://static-barocert.linkhub.co.kr/KAKAO/Time
4. IP Whitelisting
카카오써트는 고객사 Source IP에 대해 Whitelisting 기능을 제공합니다. 아래의 신청양식을 작성하여 유선(1666-0044) 또는 파트너센터 메일(barocert@linkhubcorp.com)로 접수하여 지원합니다.
- 프로그램 공급사 사업자번호 / LinkID
- 등록 IP Address
- 신청자 정보(이름, 전화번호, 이메일)
5. 전용선 가이드
전용선 회선 청약 관련 비용은 프로그램 공급사가 부담하는 것을 원칙으로 합니다. 아래의 신청양식을 작성하여 메일 (barocert@linkhubcorp.com) 또는 유선(1666-0044)으로 접수하여 지원됩니다. 회선 개통은 신청일로부터 평균 2주가 소요되므로 희망 개통일자는 라우팅 및 방화벽 작업까지 포함한 일정으로 산정하여 주시기 바랍니다.
- 프로그램 공급사 상호 및 사업자번호
- 신청자 정보(이름, 전화번호, 이메일)
- IDC 소재지
- 서비스 IP Address(공인 IP만 가능, 사설 IP 불가)
- 대역폭(Bandwidth)
- 청약예정 ISP
- 희망 개통일자