통합인증서비스
KG이니시스 인증창을 호출하여 다양한 민간인증서를 통합 제공하는 서비스
Quick Guide
샘플 다운로드
개발 언어에 맞는 샘플을
다운로드 받아 주세요.
리턴 URL 수정
요청페이지 도메인과 일치하도록
successUrl, failUrl 값을
수정해 주세요.
테스트 실행 및 결과확인
인증 진행과정과
응답결과를 확인해 주세요.
실제 연동진행
가맹점 실서버 환경에 맞게
연동을 진행해주세요.
Service Flow
통합인증서비스 로직에 대해 안내드립니다.
연동 준비하기
통합인증서비스 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 인증서 등은 계약담당자 문의apikey대칭키
통합인증 계약 시 안내받은 apikey 사용방화벽정보
항목 | 운영환경 |
---|---|
URL | fcsa.inicis.com kssa.inicis.com |
IP | 118.129.210.217 183.109.71.217 |
PORT | 443 |
연결방향 | OUTBOUND |
STEP1통합인증 요청
※ 유의사항
통합인증서비스 연동 시 유의할 사항에 대하여 안내드립니다.
유의사항을 준수하지 않음으로 인해 발생되는 문제에 대하여는 당사에서 책임지지 않습니다.
- 통합인증 서비스는 반드시 HTTPS 로 통신해야 합니다.
- 통합인증창 호출은 POP-UP 방식이 기본입니다.
- 최적 팝업 사이즈 : 400 X 640 - 모바일 연동 시 유의사항
- 일반적인 모바일웹 환경은 연동규격이 동일합니다.
- 가맹점 앱 내 웹뷰(WebView) 연동 시, 팝업창 호출에 제한이 있으므로 페이지 전환방식으로 연동바랍니다.
통합인증 요청정보
- 통합인증 요청URL
- 간편인증, 전자서명 : https://sa.inicis.com/auth
- 본인확인 : https://sa.inicis.com/id/auth
- Content-Type : application/x-www-form-urlencoded;charset=utf-8
- Method : POST
mid* | 상점아이디 |
10 byte
|
---|---|---|
reqSvcCd* | 요청구분코드
["01":간편인증, "02":전자서명, "03":본인확인] reqSvcCd: 02 (전자서명) 일 경우, identifier 파라미터 추가 세팅필요 |
2 byte
|
identifier | 전자서명 값 (서명할 내용을 세팅) 전자서명일 때만 필수, ex) OOO 계약을 위한 전자서명 |
N/A
|
DI_CODE | 웹사이트 코드 (DI 생성시 활용) 본인확인 선택사항 |
12 byte
|
mTxId* | 가맹점 트랜잭션 ID 요청시마다 유일값 |
20 byte
|
successUrl* | 인증성공 결과수신 URL |
128 byte
|
failUrl* | 인증실패 결과수신 URL |
128 byte
|
authHash* | 등록된 가맹점 요청 확인을 위한 SHA256 hash 값 대상 : mid + mTxId + apikey |
HASH
N/A
|
directAgency | 특정 제휴사 노출옵션 |
제휴사코드
N/A
|
flgFixedUser* | 특정 사용자에게 인증요청여부 ["Y":사용, "N":미사용 ] |
1 byte
|
userName | 사용자 이름 flgFixedUser: Y 일 경우 필수 |
25 byte
|
userPhone | 사용자 전화번호 flgFixedUser: Y 일 경우 필수 |
11 byte
|
userBirth | 사용자 생년월일 [YYYYMMDD] flgFixedUser: Y 일 경우 필수 |
8 byte
|
userHash | 사용자 위변조방지를 위한 SHA256 hash 값 대상 : userName + mid + userPhone + mTxId + userBirth + reqSvcCd flgFixedUser: Y 일 경우 필수 |
HASH
N/A
|
reservedMsg* | isUseToken=Y 필수 고정 세팅형식 : reservedMsg = isUseToken=Y |
40 byte
|
logoUrl | 로고 삽입 [size : 164*28] 이미지 전체 도메인주소 세팅 |
가이드
N/A
|
STEP 2통합인증 응답
※ 유의사항
- 정상처리 (resultCode:0000) 일 경우는 응답필드가 전부 전송됩니다.
- 처리결과에 따라 resultCode, resultMsg 이외의 값은 전송되지 않을 수 있습니다.
resultCode | 결과코드 "0000":성공, 이외 실패 |
4 byte
|
---|---|---|
resultMsg | 결과메시지 (UTF-8 urlEncoding) ex) "성공" 문자열 응답 시 : %EC%84%B1%EA%B3%B5 |
500 byte
|
authRequestUrl | 결과조회 요청 URL 이니시스 제공 URL이 맞는지 필수 검증 필요 |
200 byte
|
txId | 통합인증 트랜잭션 ID 고유값 |
40 byte
|
token | reservedMsg 값이 "isUseToken=Y" 인 경우에만 전달됨 Base64 Encoding |
N/A
|
STEP 3결과조회 요청
결과조회 요청정보
- 결과조회 요청 URL : STEP2 인증결과 수신 시 응답된 authRequestUrl
이니시스 제공 URL이 맞는지 필수 검증 필요 - Method : POST
- 통합인증 결과조회는 반드시 HTTPS( SERVER to SERVER ) 로 통신해야 합니다.
- Content-Type : application/json;charset=utf-8
- Timeout (권고) : 5sec
mid* | 상점아이디 |
10 byte
|
---|---|---|
txId* | 통합인증 트랜잭션 ID STEP2 인증결과로 수신받은 값 |
40 byte
|
STEP 4결과조회 응답
※ 유의사항
해당 응답파라미터는 모든 인증 프로세스 종료 후 최종적으로 전달되는 응답파라미터 입니다.
- 정상처리 (resultCode:0000) 일 경우는 응답필드가 전부 전송됩니다.
- userDi / userCi2 / userGender / isForeign 는 본인확인의 경우에만 제공됩니다.
- 처리결과에 따라 resultCode, resultMsg 이외의 값은 전송되지 않을 수 있습니다.
resultCode* | 결과코드 "0000":성공, 이외 실패 |
4 byte
|
---|---|---|
resultMsg* | 결과메세지 (UTF-8 urlEncoding) ex) "성공" 문자열 응답 시 : %EC%84%B1%EA%B3%B5 |
500 byte
|
txId | 통합인증 트랜젝션 ID |
40 byte
|
mTxId | 가맹점 트랜잭션 ID 인증 요청시 mTxId 필드에 설정된 값 |
20 byte
|
svcCd | 요청구분코드 ["01":간편인증, "02":전자서명, "03":본인확인] |
2 byte
|
providerDevCd | 제휴사코드 |
제휴사코드
10 byte
|
userName | 사용자 이름 isUseToken=Y 일 경우, SEED 암호화 |
복호화
N/A
|
userPhone | 사용자 전화번호 isUseToken=Y 일 경우, SEED 암호화 |
복호화
N/A
|
userBirthday | 사용자 생년월일 isUseToken=Y 일 경우, SEED 암호화 |
복호화
N/A
|
userCi | 사용자 CI 데이터 isUseToken=Y 일 경우, SEED 암호화 카카오 : 제한적 제공 |
복호화
N/A
|
signedData | 서명데이터 isUseToken=Y 일 경우, SEED 암호화 전자서명인 경우 제공 |
복호화
N/A
|
userGender | 사용자 성별 ["M":남성, "F":여성] isUseToken=Y 일 경우, SEED 암호화 본인확인의 경우 제공 |
복호화
1 byte
|
isForeign | 내외국인 정보 ["0":내국인, "1":외국인] isUseToken=Y 일 경우, SEED 암호화 본인확인의 경우 제공 |
복호화
1 byte
|
userDi | 사용자 DI 데이터 isUseToken=Y 일 경우, SEED 암호화 본인확인의 경우 제공 |
복호화
N/A
|
userCi2 | 사용자 CI2 데이터 isUseToken=Y 일 경우, SEED 암호화 본인확인의 경우 제공 |
복호화
N/A
|
CODE제휴사 코드
제휴사코드 | 제휴사명 | 간편인증 | 전자서명 | 본인확인 | 비고 |
---|---|---|---|---|---|
PAYCO | 페이코 | ○ | ○ | - | |
PASS | 패스 (통신사) | ○ | ○ | - | |
TOSS | 토스 | ○ | ○ | ○ | |
KFTC | 금융결제원 | ○ | ○ | ○ | |
KAKAO | 카카오 | ○ | ○ | - | |
NAVER | 네이버 | ○ | ○ | - | |
SAMSUNG | 삼성패스 | ○ | ○ | - | |
SHINHAN | 신한은행 | ○ | ○ | ○ | |
KB | 국민은행 | ○ | ○ | ○ | |
HANA | 하나은행 | ○ | ○ | - | |
WOORI | 우리은행 | ○ | ○ | ○ | |
NH | 농협은행 | ○ | ○ | - | |
KAKAOBANK | 카카오뱅크 | ○ | ○ | ○ | |
SMS | 휴대폰 인증 | ○ | - | ○ | 별도 제휴 |