튜토리얼

Java 개발환경에서 바로써트 SDK를 추가하여 전자서명 요청(requestSign) 함수를 구현하는 예시입니다.

1. BaroCert SDK 추가

① 패스써트 연동자료실에서 Java - JSP SDK 예제코드 다운로드 후 압축을 해제합니다.
② SDK 예제코드의 WEB-INF/lib/ 폴더의 3개 jar파일 구현할 프로젝트의 라이브러리 폴더에 복사합니다.

gson-version.jar
linkhub-auth-version.jar
barocert-sdk-version.jar

2. BaroCert SDK 설정

프로젝트 경로에 전자서명 서비스 연동환경 설정을 위한 "$CATALINA_HOME/webapps/ROOT/common.jsp" 파일을 생성하고 아래의 코드를 참고하여 인증정보를 설정합니다.

<%-- 패스써트 클래스 빈 생성 --%>
<jsp:useBean id="passcertService" scope="application" class="com.barocert.passcert.PasscertServiceImp"/>

<%-- 링크아이디 --%>
<jsp:setProperty name="passcertService" property="linkID" value="TESTER"/>

<%-- 비밀키 --%>
<jsp:setProperty name="passcertService" property="secretKey" value="SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="/>

<%-- 인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true) --%>
<jsp:setProperty name="passcertService" property="IPRestrictOnOff" value="true"/>

<%-- 통신 고정 IP, true-사용, false-미사용, (기본값:false) --%>
<jsp:setProperty name="passcertService" property="useStaticIP" value="false"/>

3. RequestSign 기능 구현

① "$CATALINA_HOME/webapps/ROOT/Request.jsp" 파일을 생성하고, 아래의 코드를 참조하여 함수 호출 코드를 추가합니다.

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<link rel="stylesheet" type="text/css" href="${pageContext.request.contextPath}/resources/main.css" media="screen" />
	<title>Barocert Service jsp Example</title>
</head>

<%@ include file="common.jsp" %>

<%@page import="com.barocert.BarocertException"%>
<%@page import="com.barocert.passcert.sign.Sign"%>
<%@page import="com.barocert.passcert.sign.SignReceipt"%>

<%
/*
	* 패스 이용자에게 문서의 전자서명을 요청합니다.
	* https://developers.barocert.com/reference/pass/java/sign/api#RequestSign
	*/

// 이용기관코드 (파트너 사이트에서 확인가능)
String clientCode = "023070000014";

// 전자서명 요청 정보 객체
Sign sign = new Sign();

// 수신자 휴대폰번호 - 11자 (하이픈 제외)
sign.setReceiverHP(passcertService.encrypt("01012341234"));
// 수신자 성명 - 최대 80자
sign.setReceiverName(passcertService.encrypt("홍길동"));
// 수신자 생년월일 - 8자 (yyyyMMdd)
sign.setReceiverBirthday(passcertService.encrypt("19700101"));

// 요청 메시지 제목 - 최대 40자
sign.setReqTitle("전자서명 요청 메시지 제목");
// 요청 메시지
sign.setReqMessage(passcertService.encrypt("전자서명 요청 메시지"));
// 고객센터 연락처
sign.setCallCenterNum("1600-9854");
// 요청 만료시간 - 최대 1,000(초)까지 입력 가능
sign.setExpireIn(1000);
// 서명 원문 - 원문 2,800자 까지 입력가능
sign.setToken(passcertService.encrypt("전자서명 요청 원문"));
// 서명 원문 유형
// 'TEXT' - 일반 텍스트, 'HASH' - HASH 데이터, 'URL' - URL 데이터
// 원본데이터(originalTypeCode, originalURL, originalFormatCode) 입력시 'TEXT'사용 불가
sign.setTokenType("URL");

// 사용자 동의 필요 여부
sign.setUserAgreementYN(true);
// 사용자 정보 포함 여부
sign.setReceiverInfoYN(true);

// 원본유형코드
// 'AG' - 동의서, 'AP' - 신청서, 'CT' - 계약서, 'GD' - 안내서, 'NT' - 통지서, 'TR' - 약관
sign.setOriginalTypeCode("TR");
// 원본조회URL
sign.setOriginalURL("https://www.passcert.co.kr");
// 원본형태코드
// 'TEXT', 'HTML', 'DOWNLOAD_IMAGE', 'DOWNLOAD_DOCUMENT'
sign.setOriginalFormatCode("HTML");

// AppToApp 인증요청 여부
// true - AppToApp 인증방식, false - 푸시(Push) 인증방식
sign.setAppUseYN(false);
// ApptoApp 인증방식에서 사용
// 통신사 유형('SKT', 'KT', 'LGU'), 대문자 입력(대소문자 구분)
// sign.setTelcoType("SKT");
// ApptoApp 인증방식에서 사용
// 모바일장비 유형('ANDROID', 'IOS'), 대문자 입력(대소문자 구분)
// sign.setDeviceOSType("IOS");

SignReceipt result = null;

try {

	result = passcertService.requestSign(clientCode, sign);

} catch(BarocertException pe) {
	throw pe;
}
%>
<body>
	<div id="content">
		<p class="heading1">Response</p>
		<br/>
		<fieldset class="fieldset1">
			<legend>패스 전자서명 요청</legend>
			<ul>
				<li>접수아이디 (ReceiptID) : <%=result.getReceiptID()%></li>
				<li>앱스킴 (Scheme) : <%=result.getScheme()%></li>
				<li>앱다운로드URL (MarketURL) : <%=result.getMarketUrl()%></li>
			</ul>
		</fieldset>
	</div>
</body>
</html>

4. 결과 확인

함수 호출이 정상적으로 처리되면 "푸시(Push) 인증" 방식은 접수아이디(32자리 숫자)가 반환되며, "앱투앱 인증" 방식은 접수아이디와 AppScheme 이 함께 반환됩니다. 실패인 경우 BarocertException으로 오류코드("-"로 시작하는 8자리 숫자값)와 오류메시지가 반환됩니다. [오류코드]