연동매뉴얼

ASP API

kakaoCert ASP 튜토리얼

Classic ASP 개발환경에서 kakaoCert SDK 적용하여 본인인증 요청 기능을 구현하는 예시입니다.

1. kakaoCert SDK 추가IIS 6.0Windows Server 2016

① 좌측 ASP 예제 다운 버튼을 통해 kakaoCert ASP SDK 예제코드를 다운로드 후 압축을 해제합니다.

② 압축해제한 SDK 예제코드에서 Kakaocert 폴더 전체를 프로젝트의 Root Directory에 복사합니다.

③ Root Directory에 "common.asp" 파일을 생성하고, 아래의 코드를 참고하여 연동신청하여 발급 받은 링크아이디(LinkID)와 비밀키(SecretKey) 값을 입력해야 합니다.

<!--#include virtual="/Kakaocert/Kakaocert.asp"-->

<%
  
  ' 링크아이디 
  LinkID = "TESTER"

  ' 비밀키 
  SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

  set m_KakaocertService = New KakaocertService

  ' kakaoCert API 서비스 모듈 초기화
  m_KakaocertService.Initialize LinkID, SecretKey

  ' 인증토큰 IP제한기능 사용여부, 권장(True)
  m_KakaocertService.IPRestrictOnOff = True

  ' 카카오써트 API 서비스 고정 IP 사용여부(GA), True-사용, False-미사용, 기본값(False)
  m_KakaocertService.useStaticIP = False
%>

2. 본인인증 요청 기능 구현

① 프로젝트의 Root Directory에 "RequestVerifyAuth.asp" 파일을 생성하고, 아래의 코드를 참고하여 본인인증 함수 호출을 처리하는 코드를 입력합니다.

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>kakaocert ASP Example</title>
  </head>
<!--#include file="common.asp"-->

<%
  '**************************************************************
  '  본인인증 전자서명을 요청합니다.
  ' - 본인인증 서비스에서 이용기관이 생성하는 Token은 사용자가 전자서명할 원문이 됩니다. 이는 보안을 위해 1회용으로 생성해야 합니다.
    ' - 사용자는 이용기관이 생성한 1회용 토큰을 서명하고, 이용기관은 그 서명값을 검증함으로써 사용자에 대한 인증의 역할을 수행하게 됩니다.
    '**************************************************************
  
  ' kakaoCert 이용기관코드, kakaoCert 파트너 사이트에서 확인
  clientCode = "020040000001"
  
  ' 본인인증 요청정보 객체
  Set requestObj = New RequestVerifyAuthObj
  
  ' 고객센터 전화번호, 카카오톡 인증메시지 중 "고객센터" 항목에 표시
  requestObj.CallCenterNum = "1600-9999"
  
  ' 인증요청 만료시간(초), 최대값 : 1000  인증요청 만료시간(초) 내에 미인증시, 만료 상태로 처리됨 (권장 : 300)
  requestObj.Expires_in = 300
  
  ' 수신자 생년월일, 형식 : YYYYMMDD
  requestObj.ReceiverBirthDay = "19700101"
  
  ' 수신자 휴대폰번호
  requestObj.ReceiverHP = "01012341234"
  
  ' 수신자 성명
  requestObj.ReceiverName = "테스트"
  
  ' 별칭코드, 이용기관이 생성한 별칭코드 (파트너 사이트에서 확인가능)
  ' 카카오톡 인증메시지 중 "요청기관" 항목에 표시
  ' 별칭코드 미 기재시 이용기관의 이용기관명이 "요청기관" 항목에 표시
  requestObj.SubClientID = ""
  
  ' 인증요청 메시지 부가내용, 카카오톡 인증메시지 중 상단에 표시
  requestObj.TMSMessage = "TMSMessage"
  
  ' 인증요청 메시지 제목, 카카오톡 인증메시지 중 "요청구분" 항목에 표시
  requestObj.TMSTitle = "본인인증 요청"
  
  ' 전자서명할 토큰 원문
  requestObj.Token = "TMS Token"
  
  ' 인증서 발급유형 선택
  ' True : 휴대폰 본인인증만을 이용해 인증서 발급
  ' False : 본인계좌 점유 인증을 이용해 인증서 발급
  ' 카카오톡 인증메시지를 수신한 사용자가 카카오인증 비회원일 경우, 카카오인증 회원등록 절차를 거쳐 은행계좌 실명확인 절차를 밟은 다음 전자서명 가능
  requestObj.isAllowSimpleRegistYN = False
  
  ' 수신자 실명확인 여부
  ' True : 카카오페이가 본인인증을 통해 확보한 사용자 실명과 ReceiverName 값을 비교
  ' False : 카카오페이가 본인인증을 통해 확보한 사용자 실명과 RecevierName 값을 비교하지 않음.
  requestObj.isVerifyNameYN = True

  'PayLoad, 이용기관이 생성한 payload(메모) 값
  requestObj.PayLoad = "memo info"
  
  On Error Resume Next
    receiptId = m_KakaocertService.RequestVerifyAuth(clientCode, requestObj)
    If Err.Number <> 0 then
      code = Err.Number
      message =  Err.Description
      Err.Clears
    End If
  On Error GoTo 0
%>
  <body>
    <div>
      <p>Response</p>
      <fieldset>
        <legend>본인인증 요청</legend>
        <% If code = 0 Then %>
          <ul>
            <li>ReceiptId(접수아이디) : <%=receiptId%> </li>
          </ul>
        <%  Else  %>
          <ul>
            <li>오류코드: <%=code%> </li>
            <li>오류메시지: <%=message%> </li>
          </ul>
        <%  End If  %>
      </fieldset>
     </div>
  </body>
</html>

② 웹브라우저 페이지를 호출하여 함수호출 결과를 확인합니다.

requestVerifyAuth 응답 결과 예시 화면

기술지원센터

kakaoCert 기술지원은 유선, 메일, 원격지원 등 다양한 채널을 통해 제공됩니다.
T. 1600-9854E. code@linkhubcorp.com