간편로그인 API

소셜 로그인 서비스인 카카오 로그인과 카카오 인증서비스의 전자서명이 결합한 형태의 간편로그인 API 입니다.

간편로그인 API는 카카오 SDK와 카카오써트 SDK를 함께 이용해야만 개발이 가능합니다.
테스트에 필요한 가이드 및 자료는 고객센터(barocert@linkhubcorp.com)를 통하여 문의하여 주시기 바랍니다.

1. VerifyLogin - 간편로그인 검증

  • 완료된 전자서명을 검증하고 전자서명 데이터 전문(signedData)을 반환 받습니다.

  • 카카오 보안정책에 따라 검증 API는 1회만 호출할 수 있습니다. 재시도시 오류가 반환됩니다.

  • 전자서명 완료일시로부터 10분 이후에 검증 API를 호출하면 오류가 반환됩니다.

이용기관 서버에서는 간편로그인 검증을 통해 반환받은 이용자의 개인정보(CI, 성명, 생년월일, 휴대폰번호)와 전자서명을 요청한 이용자의 개인정보를 비교해 올바른 이용자인지 검증해야 합니다.
def verifyLogin(self, clientCode, txID):

Parameter

순번 변수명 타입 길이 필수 설명
clientCode str 12 Y 이용기관 코드
txID str - Y 전자서명 접수번호

Return LoginResult Throws BarocertException

2. 객체정보

2.1. BarocertException

순번 변수명 타입 길이 필수 설명
Code int - Y API 처리에 대한 응답코드
message str - Y API 처리에 대한 응답메시지

2.2. LoginResult

순번 변수명 타입 길이 필수 설명
txID str - Y 전자서명 접수번호
state int 1 Y 상태
  • 0대기
  • 1완료
  • 2만료
signedData str - Y 전자서명값
ci str - N AES 암호화 CI
receiverName str - N AES 암호화 수신자 성명
receiverYear str - N AES 암호화 수신자 출생년도
→ 형식 : yyyy
receiverDay str - N AES 암호화 수신자 출생월일
→ 형식 : MMdd
receiverHP str - N AES 암호화 수신자 휴대폰번호
receiverGender str - N AES 암호화 수신자 성별
  • MALE남성
  • FEMALE여성