연동매뉴얼

ASP API

kakaoCert ASP 튜토리얼

Classic ASP 개발환경에서 kakaoCert SDK 적용하여 전자서명 요청(Talk Message 방식) 기능을 구현하는 예시입니다.

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

%>

2. 전자서명 요청 기능 구현

① 프로젝트의 Root Directory에 "RequestESign.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"-->

<%
  '**************************************************************
  '  전자서명을 요청합니다.
  '**************************************************************

  ' App to App 방식 이용 여부
  ' True - AppToApp 인증방식, False-Talk Message 인증방식
  isAppUseYN = False

  ' kakaoCert 이용기관코드, kakaoCert 파트너 사이트에서 확인
  clientCode = "020040000001"

  ' 전자서명 요청정보 객체
  Set requestObj = New RequestESignObj
  
  ' 고객센터 전화번호, 카카오톡 인증메시지 중 "고객센터" 항목에 표시
  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
    Set result = m_KakaocertService.RequestESign(clientCode, requestObj, isAppUseYN)
    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) : <%=result.receiptId%> </li>
            <li>[AppToApp용] 카카오톡 트랜잭션아이디 (tx_id) : <%=result.tx_id%> </li>
          </ul>
        <%  Else  %>
          <ul>
            <li>오류코드: <%=code%> </li>
            <li>오류메시지: <%=message%> </li>
          </ul>
        <%  End If  %>
      </fieldset>
     </div>
  </body>
</html>

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

requestESign 응답 결과 예시 화면

기술지원센터

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