간편로그인 API
간편로그인 API
소셜 로그인 서비스인 카카오 로그인과 카카오 인증서비스의 전자서명이 결합한 형태의 간편로그인 API 입니다.
간편로그인 API는 카카오 SDK와 카카오써트 SDK를 함께 이용해야만 개발이 가능합니다.
테스트에 필요한 가이드 및 자료는 고객센터(barocert@linkhubcorp.com)를 통하여 문의하여 주시기 바랍니다.
테스트에 필요한 가이드 및 자료는 고객센터(barocert@linkhubcorp.com)를 통하여 문의하여 주시기 바랍니다.
1. VerifyLogin - 간편로그인 검증
완료된 전자서명을 검증하고 전자서명 데이터 전문(signedData)을 반환 받습니다.
카카오 보안정책에 따라 검증 API는 1회만 호출할 수 있습니다. 재시도시 오류가 반환됩니다.
전자서명 완료일시로부터 10분 이후에 검증 API를 호출하면 오류가 반환됩니다.
이용기관 서버에서는 간편로그인 검증을 통해 반환받은 이용자의 개인정보(CI, 성명, 생년월일, 휴대폰번호)와 전자서명을 요청한 이용자의 개인정보를 비교해 올바른 이용자인지 검증해야 합니다.
public function verifyLogin(clientCode, txID)
Parameter
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
clientCode | String | 12 | Y | 이용기관 코드 | |
txID | String | - | Y | 전자서명 접수번호 |
Return LoginResult Throws BarocertException
2. 객체정보
2.1. BarocertException
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
Code | Integer | - | Y | API 처리에 대한 응답코드 | |
message | String | - | Y | API 처리에 대한 응답메시지 |
2.2. LoginResult
순번 | 변수명 | 타입 | 길이 | 필수 | 설명 |
---|---|---|---|---|---|
txID | String | - | Y | 전자서명 접수번호 | |
state | Integer | 1 | Y |
상태
|
|
signedData | String | - | Y | 전자서명값 | |
ci | String | - | N | AES 암호화 CI | |
receiverName | String | - | N | AES 암호화 수신자 성명 | |
receiverYear | String | - | N |
AES 암호화
수신자 출생년도
→ 형식 : yyyy |
|
receiverDay | String | - | N | AES 암호화 수신자 출생월일 | |
receiverHP | String | - | N |
AES 암호화
수신자 휴대폰번호
→ 형식 : MMdd |
|
receiverGender | String | - | N |
AES 암호화
수신자 성별
|