튜토리얼

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

1. BaroCert SDK 추가

Barocert SpringBoot Starter 추가를 위해 SpringBoot 프로젝트 "build.gradle" 파일에 dependency를 추가 후 Refresh 합니다.
※ Barocert SpringBoot Starter는 SpringBoot v1.0 이상에서 사용 가능하며 Barocert Java SDK AutoConfiguration을 지원합니다.

dependencies {
	implementation 'kr.co.linkhub:barocert-spring-boot-starter:1.4.0'
}

2. BaroCert SDK 설정

SDK 설정을 위해 아래의 코드를 application.yml 파일에 추가합니다.

passcert:
	#링크아이디
	linkId: TESTER
	#비밀키
	secretKey: SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I=
	#이용기관코드 (파트너 사이트에서 확인가능)
	clientCode: '023070000014'
	#인증토큰 IP 검증 설정, ture-사용, false-미사용, (기본값:true)
	isIpRestrictOnOff: true
	#통신 고정 IP, true-사용, false-미사용, (기본값:false)
	useStaticIp: false

3. RequestSign 기능 구현

① 서비스 클래스 빈 객체 추가를 위해 @Autowired 어노테이션과 RequestSign 함수 코드를 추가합니다.

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

import com.barocert.BarocertException;
import com.barocert.passcert.PasscertService;
import com.barocert.passcert.sign.Sign;
import com.barocert.passcert.sign.SignReceipt;
import com.barocert.passcert.sign.SignResult;
import com.barocert.passcert.sign.SignStatus;
import com.barocert.passcert.sign.SignVerify;

@Controller
public class PasscertServiceController {

@Autowired
private PasscertService passcertService;

// 이용기관코드
// 파트너가 등록한 이용기관의 코드 (파트너 사이트에서 확인가능)
@Value("${passcert.clientCode}")
private String ClientCode;

/*
	* 패스 이용자에게 문서의 전자서명을 요청합니다.
	* https://developers.barocert.com/reference/pass/java/sign/api#RequestSign
	*/
@RequestMapping(value = "passcert/requestSign", method = RequestMethod.GET)
public String requestSign(Model m) throws BarocertException {

	// 전자서명 요청 정보 객체
	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("전자서명 요청 메시지 제목");
	// 인증요청 메시지 - 최대 500자
	sign.setReqMessage(passcertService.encrypt("전자서명 요청 메시지"));
	// 고객센터 연락처 - 최대 12자
	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");

	try {
		SignReceipt result = passcertService.requestSign(ClientCode, sign);
		m.addAttribute("result", result);
	} catch (BarocertException pe) {
		m.addAttribute("Exception", pe);
		return "exception";
	}

	return "response";
}
}

② 함수 호출결과 코드와 메시지를 출력하는 response.html 파일을 추가합니다.

<html xmlns:th="http://www.thymeleaf.org">
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
	<link rel="stylesheet" type="text/css" href="/css/main.css" media="screen"/>
	<title>Barocert Passcert Service SpringBoot Example</title>
</head>
<body>
	<div id="content">
		<p class="heading1">Response</p>
		<br/>
		<fieldset class="fieldset1">
			<legend th:text="${#request?.requestURL}"></legend>
			<ul>
				<li>접수아이디 (ReceiptID) : <span th:text="${result.receiptID}"></span></li>
				<li>앱스킴 (Scheme) : <span th:text="${result.scheme}"></span></li>
				<li>앱다운로드URL (MarketURL) : <span th:text="${result.marketUrl}"></span></li>
			</ul>
		</fieldset>
	</div>
</body>
</html>

4. 결과 확인

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