void XecureSmartPlugin.getCertTree ( successCB , failCB , certType , searchType , contentLevel , searchValue , searchSerial )
^Option^설명^비고^
|successCB|성공 시 콜백함수|(out)contentLevel : 0(자세한 정보), contentLevel : 5(간략한 정보)|
|failCB|실패 시 콜백함수|(out)에러코드$에러메세지|
|certType|타입|(in)0:루트인증서,1:CA인증서,2:사용자인증서,3:전체인증서|
|searchType|검색조건|(in)0:검색하지않음 \\ 10:subjectDN의 CN과 일치 \\ 11:subjectDN의 OU와 일치 \\ 12:subjectDN의 O와 일치 \\ 13:subjectDN의 C와 일치 \\ 14:subjectDN과 일치 \\ 20:issuerDN의 CN과 일치 \\ 21:issuerDN의 OU과 일치 \\ 22:issuerDN의 O와 일치 \\ 23:issuerDN의 C와 일치 \\ 24:issuerDN과 일치|
|contentLevel|결과값의 레벨|(in)0:자세한 정보,5:간략한 정보|
|searchValue|검색값|(in)|
|searchSerial|검색할 일련 번호|(in)|
== XecureSmartPlugin.signDataCMS ==
* 평문 텍스트를 전자서명한다.
void XecureSmartPlugin.signDataCMS ( successCB , failCB , issuerDN , serial , password , plainText )
^Option^설명^비고^
|successCB|성공 시 콜백함수|(out)전자서명 텍스트|
|failCB|실패 시 콜백함수|(out)에러코드$에러메세지|
|issuerDN|인증서의 발급자|(in)|
|serial|인증서의 일련번호|(in|
|password|인증서의 암호|(in)|
|plainText|평문|(in)|
==== Server Application ====
=== 관련 소스 ===
^유형^대상소스명^비고^
|Controller|egovframework.hyb.add.pki.web.EgovPKIAndroidAPIController.java|NPKIAPI 가이드 프로그램 Controller Class|
|Service|egovframework.hyb.add.pki.service.EgovPKIAndroidAPIService.java|NPKIAPI 가이드 프로그램 Service Class|
|ServiceIimpl|egovframework.hyb.add.pki.service.impl.EgovPKIAndroidAPIServiceImpl.java|NPKIAPI 가이드 프로그램 ServiceImpl Class|
|VO|egovframework.hyb.add.pki.service.PKIAndroidAPIDefaultVO.java|NPKIAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.add.pki.service.PKIAndroidAPIVO.java|NPKIAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.add.pki.service.PKIAndroidAPIXmlVO.java|NPKIAPI 가이드 프로그램 XML 관련 VO Class|
|DAO|egovframework.hyb.add.pki.service.impl.PKIAndroidAPIDAO.java|NPKIAPI 가이드 프로그램 Dao Class|
|QUERY XML|resources/egovframework/sqlmap/hyb/add/pki/EgovPKIAndroidAPIGuide_SQL_XXX.xml|NPKIAPI 가이드 프로그램 QUERY XML|
|Idgen XML|resources/egovframework/spring/context-idgen.xml|NPKIAPI 가이드 프로그램 Id생성 Idgen XML|
=== 관련 테이블 ===
^테이블명^테이블명(영문)^비고^
|PKI|PKI|인증서 인증 로그 관리|
=== 테이블 명세서 ===
* PKI
^No.^컬럼^컬럼명^타입^길이^Null^KEY^
|1|SN|일련번호|NUMERIC|6|NotNull|pk|
|2|UUID|UUID|VARCHAR|50|NotNull|pk|
|3|DM|DM|VARCHAR|255|Null| |
|4|CRTFC_DT|인증일시|DATE| |Null| |
|5|ENTRPRS_SE_CODE|이메일|DATE| |Null| |
=== ERD ===
{{:egovframework:hyb:guide:ios:erd.jpg|}}
=== 표준 보안 API ===
public String verifyCert(PKIAndroidAPIVO pkiVo) throws Exception {
// API 초기화
GpkiApi.init("C:/libgpkiapi_jni/conf");
String sign;
sign = pkiVo.getSign();
return verify(Base64.decode(sign));
}
private String verify(final byte[] bSignedData) {
String sClientName = "";
try {
// 서명값을 검증
SignedData signedData = null;
signedData = new SignedData();
signedData.verify(bSignedData);
// 서명자의 인증서 검증을 위해서 서버의 서명용 인증서 획득
X509Certificate clientCert = null;
clientCert = signedData.getSignerCert(0);
// 인증서 검증
CertPathValidator certPathValiditor = null;
certPathValiditor = new CertPathValidator("C:/libgpkiapi_jni/conf/gpkiapi.conf");
// 신뢰하는 최상위 인증서 추가
X509Certificate rootCertRsa = null;
rootCertRsa = Disk.readCert("C:/libgpkiapi_jni/conf/root-rsa2.der");
X509Certificate rootCertRsaSha = null;
rootCertRsaSha = Disk.readCert("C:/libgpkiapi_jni/conf/root-rsa-sha2.der");
certPathValiditor.addTrustedRootCert(rootCertRsa);
certPathValiditor.addTrustedRootCert(rootCertRsaSha);
// 클라이언트의 인증서 검증 범위 설정
certPathValiditor.setVerifyRange(CertPathValidator.CERT_VERIFY_FULL_PATH);
// 클라이언트의 인증서 폐지여부 확인 설정 (CRL/ARL 검증 설정함)
certPathValiditor.setRevokationCheck(CertPathValidator.REVOKE_CHECK_ARL | CertPathValidator.REVOKE_CHECK_CRL);
// 인증서 검증 요청
certPathValiditor.validate(CertPathValidator.CERT_SIGN, clientCert);
sClientName = clientCert.getSubjectDN();
} catch (Exception e) {
sClientName = "";
}
return sClientName;
}
===== 환경설정 =====
NPKI 디바이스API 가이드 프로그램에서 제공하는 모바일 디바이스의 NPKI 관련 기능을 활용하기 위하여 필요한 항목 및 그 환경 설정은 다음과 같다.
==== Device Application ====
=== src/kr.go.egovframework.hyb.pkiapi.xecuresmart.PKIXecureSmartAPIGuide_AndroidActivity ===
public void onCreate(Bundle savedInstanceState)
{
super.onCreate(savedInstanceState);
//XecureSmart 사용을 위한 라이브러리 로드
CoreWrapper.load();
super.clearCache();
super.loadUrl("file:///android_asset/www/intro.html");
}
=== res/xml/config.xml ===
=== res/values/serverinfo.xml ===
http://192.168.100.222:8080/DeviceAPIGuideTotal_Web_V1.7.1
=== AndroidManifest.xml ===
허가 기능 설정
Main Activity 설정
==== Server Application ====
=== pom.xml ===
egovframework.com.cmm.uat
libgpkiapi_jni
1.4.0.0
=== resource/egovframework/sqlmap/sql-map-config_[DB명].xml ===
* 표준 보안 API 설정
^구분^설정방법^
|Class 경로 설정|방법 1. java 옵션 이용 : java -classpath jar_directory\libgpkiapi_jni.jar \\ 방법 2. 환경 변수 등록 : "내컴퓨터->속성->고급->환경변수" 에서 새로 만들기를 클릭하여 classpath 변수를 등록|
{{:egovframework:hyb:hrte:NPKIClassPath.jpg}}
^구분^설정방법^
|라이브러리 경로 설정|1. JNI를 비롯한 C/C++용 표준보안API와 LDAP 라이브러리가 위치해 있는 경로를 환경 변수에 등록한다. \\ 2. "내컴퓨터->속성->고급->환경변수" 에서 기존 "path" 변수에 "라이브러리가 설치된 디렉토리"를 추가한다.|
{{:egovframework:hyb:hrte:NPKIPath.jpg}}
===== 관련기능 =====
NPKI 디바이스 API 가이드는 크게 ** 모바일 기기 인증서 선택/인증하기 **, ** 인증 로그 정보 보기 ** 기능으로 구성되어있다.
==== 모바일 기기 인증서 선택/인증하기 ====
=== 비즈니스 규칙 ===
디바이스 API를 통해 모바일 기기에 저장된 인증서 리스트를 조회하고, 리스트에서 선택 한 인증서로 인증서 인증을 한다.
=== 관련코드 ===
디바이스 API 내의 인증서 리스트 조회 함수를 사용하는 JavaScript 코드를 통해 인증서 리스트를 조회 하고, 서명 데이터를 만드는 JavaScript 함수를 사용하여 서명 한다.
// 인증서 리스트 조회
function fn_egov_go_certlist() {
console.log('DeviceAPIGuide fn_egov_go_certlist');
$.mobile.showPageLoadingMsg('a');
XecureSmart.getCertTree(fn_egov_getcerttree_success, fn_egov_getcerttree_fail, 2, 0, 5, '', '');
}
// 인증서 서명
function fn_egov_make_sign()
{
console.log('DeviceAPIGuide fn_egov_make_sign');
XecureSmart.signDataCMS (fn_egov_makesign_ok, fn_egov_makesign_fail, document.getElementById("issuerDN").value, document.getElementById("certSerial").value, $("#loginPasswd").val(), "usrId=&password=&name=");
}
// 인증서 서명 데이터 서버로 인증 요청
function fn_egov_makesign_ok(arg) {
console.log('DeviceAPIGuide fn_egov_makesign_ok Success');
var jsonobj = JSON.parse(arg);
// jsonobj.sign에서 서면 값, jsonobj.vidRandom에서 본인확인을 위한 VID Random값을 가져올 수 있다.
var signedData = jsonobj.sign;
var url = "/pki/xml/addPKIInfo.do";
var acceptType = "xml";
var params = {uuid : device.uuid,
sign: signedData,
entrprsSeCode: 'PKI03'};
alert('Http Method:POST\nacceptType:'+ acceptType + '\n요청데이터:' + JSON.stringify(params));
// get the data from server
window.plugins.EgovInterface.post(url,acceptType, params, function(xmldata) {
console.log('DeviceAPIGuide fn_egov_makesign_ok request Complete');
alert('응답데이터:' + xmldata)
if($(xmldata).find("resultState").text() == "OK"){
window.history.go(-2);
}else{
jAlert($(xmldata).find("resultMessage").text(), '오류', 'c');
}
});
}
=== 관련화면 및 수행매뉴얼 ===
^Action^URL^Controller method^QueryID^
|인증서 인증|/pki/xml/addPKIInfo.do|addPKIInfoXml|"PKIAndroidAPIDAO.insertPKIInfo"|
^인증서 리스트^인증서 인증^
|{{:egovframework:hyb:guide:add:XecureSmartMain.png?320}}|{{:egovframework:hyb:guide:add:NPKI인증서인증(XecureSmart).png?320}}|
인증서 리스트 화면에서 인증 할 인증서를 선택하고 인증서 인증 화면에서 PASSWD 항목에 패스워드를 입력 후 "인증 확인" 버튼을 클릭한다. \\
단, PASSWD 항목에서 validation을 확인하고, 조건이 불충분 할 경우 오류 메시지가 출력된다.
인증 확인 : 인증서 인증을 하기 위해서 PASSWD 항목에 인증서 패스워드를 입력 후 "인증 확인" 버튼을 클릭한다. \\
Back 버튼 : **NPKI 디바이스 API 가이드 프로그램 메뉴** 화면 또는 **인증서 리스트** 화면으로 이동한다. \\
==== 인증 로그 정보 보기 ====
=== 비즈니스 규칙 ===
웹 서버 어플리케이션으로 부터 인증서 인증 결과 로그를 조회한다. \\
=== 관련코드 ===
function fn_egov_go_loginInfoList() {
console.log('DeviceAPIGuide fn_egov_go_loginInfoList');
//3G 사용시 과금이 발생 할 수 있다는 경고 메시지 표시
if(!fn_egov_network_check(false)) {
return;
}
$.mobile.changePage("#loginInfoList", "slide", false, false);
var url = "/pki/xml/pkiInfoList.do";
var accept_type = "xml";
// get the data from server
window.plugins.EgovInterface.post(url,accept_type, null, function(xmldata) {
console.log('DeviceAPIGuide fn_egov_go_loginInfoList request Complete');
var list_html = "";
$(xmldata).find("pkiInfoList").each(function(){
var dn = $(this).find("dn").text();
var date = $(this).find("crtfcDt").text();
var entrprsSeCode = $(this).find("entrprsSeCode").text().replace(/\s+$/, "");
var entrprsSe = "NONE";
if(entrprsSeCode == 'PKI01')
entrprsSe = "MagicXSign";
else if(entrprsSeCode == 'PKI02')
entrprsSe = "WizSign";
else if(entrprsSeCode == 'PKI03')
entrprsSe = "XecureSmart";
list_html += "subjdn : " + dn + "
";
list_html += "Date : " + date + "
";
list_html += "NPKI : " + entrprsSe + "
=== 관련화면 및 수행매뉴얼 ===
^기능^URL^Controller^method^QueryID^
|인증서 인증 결과 로그 조회|/pki/xml/pkiInfoList.do|EgovPKIAndroidAPIController|selectPKIInfoListXml|PKIAndroidAPIDAO.selectPKIInfoList|
{{:egovframework:hyb:guide:add:NPKI인증로그(XecureSmart).png?320|}}
===== 컴파일 디버깅 배포 =====
==== 컴파일 ====
=== NPKIAPI(XecureSmart) Device Applicaton 컴파일 방법 ===
* 디바이스 API 가이드(Android) 프로젝트를 마우스 오른쪽 버튼으로 클릭 후 "Run As"탭의 "Android Application"을 클릭하면 가이드 프로그램이 빌드되어 안드로이드 디바이스에 설치 된다.
{{:egovframework:hyb:guide:Gettingstart_AVDRunAs.png|}} \\
* "Android Device Chooser" 창이 나타나면 해당 디바이스를 선택 후 "OK" 버튼을 선택한다.
{{:egovframework:hyb:guide:Gettingstart_DeviceChooser.png|}} \\
* 에뮬레이터를 이용한 실행 화면
{{:egovframework:hyb:guide:add:XecureSmartEmuleIntro.png?320|}} {{:egovframework:hyb:guide:add:XecureSmartEmuleMain.png?320|}}
* 디바이스를 이용한 실행 화면
{{:egovframework:hyb:guide:add:XecureSmartIntro.png?320|}} {{:egovframework:hyb:guide:add:XecureSmartMain.png?320|}}
=== DeviceInfoAPI Server Applicaton 컴파일 방법 ===
* DeviceInfoAPI 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.
{{:egovframework:hyb:guide:ios:서버실행.png?640|}}
* 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.
{{:egovframework:hyb:guide:add:서버실행결과_콘솔.png?840|}}
==== 디버깅 ====
디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 console.log를 이용할 수 있다. console.log 함수는 자바스크립트 구문에서 사용할 수 있는 디버그 코드로 이클립스에서 확인 할 수 있다.
console.log의 작성 방법은 다음과 같다.
function fn_egov_getcerttree_success(result) {
console.log('DeviceAPIGuide fn_egov_getcerttree_success Success');
$.mobile.hidePageLoadingMsg('a');
var certInfoArray = result.split ("\t\n");
...
}
디버깅 코드가 실행 되면 아래와 같은 메시지를 개발도구의 콘솔 메시지 창에서 볼 수 있다.
{{:egovframework:hyb:guide:add:FileReadWriteconsolelog.png?700|}}
NPKI 디바이스 API 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다. \\
^디버그 코드^디버깅 내용^
|DeviceAPIGuide fn_egov_getcerttree_success Success | 인증서 리스트 조회 성공 시|
|DeviceAPIGuide fn_egov_getcerttree_fail Fail | 인증서 리스트 조회 실패 시|
|DeviceAPIGuide fn_egov_makesign_ok Success | 인증서 서명 성공 시|
|DeviceAPIGuide fn_egov_makesign_fail Fail | 인증서 서명 실패 시|
|DeviceAPIGuide fn_egov_makesign_ok request Complete | 웹 서버 어플리케이션으로 부터 인증서 인증 성공 시|
|DeviceAPIGuide fn_egov_go_loginInfoList request Complete | 인증서 인증 로그 정보 조회 성공 시|
==== 배포 ====
NPKI(XecureSmart) 디바이스 API 가이드 다운로드 : [[http://www.egovframe.go.kr/cop/bbs/selectBoardArticle.do?bbsId=BBSMSTR_000000000161&nttId=538&menu=3&submenu=9|Click]] \\
===== 참고자료 =====
* UX/UI 라이브러리 : jQuery Mobile[[http://jquerymobile.com/demos/1.4.5/|Click]] \\
* Phonegap 4.3.0 : [[http://docs.phonegap.com/en/4.0.0/|Click]]\\
* 표준보안API : [[http://www.gpki.go.kr/|Click]] \\