document.addEventListener('DOMContentLoaded', function () { setTimeout(loaded, 200); }, false);
* 문제 : iScroll4 컨텐츠 내용 높이 계산 오류.
* 해결방안 : setTimeout() 함수로 컨텐츠에 css 적용이 완료되고 iscroll 생성이 되도록 한다.
setTimeout(function()
{
myScroll = new iScroll(thisPage,
{
checkDOMChanges: true,
onBeforeScrollStart:function(e)
{
}
});
},
500);
== CallBack 함수에서 alert() 를 포함하면 문제가 발생할수 있다 (phoneGap) ==
* 문제 : 폰갭에 지정한 콜백 함수에서 alert() 메시지 호출시 동작 오류.
* 해결 방안 : 비동기 함수를 사용하거나 alert()처럼 스레드를 잡는 함수는 사용하지 않는다.
== Xcode 4.5에서 실행 시 주의 사항 ==
Xcode 4.5부터 iOS 6, iPhone 5를 지원하는데, 해당 디바이스와 OS를 지원을 할 경우 PhoneGap 1.9.0의 라이브러리는 Xcode 4.X에서 컴파일되어 배포되는 라이브러리라 프로젝트 옵션을 조정할 필요가 있다.\\
1. 옵션 설정\\
{{:egovframework:hyb:guide:ios:xcode4.5_제약사항1.png|}}
2. armv7s 삭제\\
{{:egovframework:hyb:guide:ios:xcode4.5_제약사항2.png|}}
크로스 도메인 사용 ===폰갭에서 특정 외부 도메인이나 외부 도메인의 하위 도메인을 사용해야할 경우,\\ Resource/Cordova.plist에서
var args = new Array();
args[0] = selectCertNum.toString() ;
args[1] = '1';
args[2] = stringToSign;
WizSignPG.doSignature(args, function(result) {
var signedData = result['signedData']; // 서명데이터
}, function(error) {
alert(error['errMsg']); // 에러메시지
});
== getCertificates ==
* 저장된 인증서목록을 가져와 반환한다.
- 파라메터 : N/A \\
- 반환값(해시 테이블) \\
'Certificates' : 인증서 목록
'errMsg' : 에러 발생시 에러메시지
WizSignPG.getCertificates("", function(result) {
var certList = result['Certificates'];
for(var i=0 ; i
인증서 정보 해시테이블
^해시테이블^설명^
|NUM|인증서 번호|
|버전|인증서 버전|
|일련번호|인증서 시리얼번호|
|서명알고리즘|인증서 서명알고리즘|
|발급자|인증서의 발급자 정보|
|효력발생일|인증서의 효력 발생일|
|만료일|인증서 만료일|
|주체자|인증서 주체자 정보|
|공개키알고리즘|인증서 공개키 알고리즘|
|발급자시리얼번호|발급자시리얼번호|
|공개키|공개키값|
|기관키식별자|기관키식별자|
|주체자식별자|주체자식별자|
|정책|정책|
|주체대체이름|주체대체이름|
|CRL분배지점|CRL분배지점|
|기관정보액세스|기관정보액세스(OCSP)|
|키사용|키사용용도|
|서명|인증서 서명값|
== verifyCertPassword ==
* 선택한 인증서의 비밀번호를 검증한다.
- 파라메터 : 인증서 번호, 인증서 비밀번호 \\
- 반환값(해시 테이블) \\
'result' : 인증서 비밀번호 검증결과(성공시 'OK')
'errMsg' : 에러 발생시 에러메시지
var args = new Array();
args[0] = certNum.toString();
args[1] = certPass;
WizSignPG.verifyCertPassword(args, function(result) {
var runResult = result['result'];
if(runResult == 'OK') {
alert('인증서 비밀번호가 일치합니다.');
}
}, function(error) {
alert(error['errMsg']);
});
== changeCertPassword ==
* 선택한 인증서의 비밀번호를 변경한다.
- 파라메터 : 인증서 번호, 인증서 비밀번호, 새로운 인증서 비밀번호 \\
- 반환값(해시 테이블) \\
'result' : 인증서 비밀번호 변경 결과(성공시 'OK')
'errMsg' : 에러 발생시 에러메시지
var args = new Array();
args[0] = certNum.toString();
args[1] = beforePass;
args[2] = afterPass;
WizSignPG.changeCertPassword(args, function(result) {
var runResult = result['result'];
if(runResult == 'OK') {
alert('인증서 비밀번호를 변경하였습니다.');
}
}, function(error) {
alert(error['errMsg']);
});
== removeCert ==
* 선택한 인증서를 삭제한다.
- 파라메터 인증서 번호 \\
- 반환값(해시 테이블) \\
'result' : 인증서 삭제 결과(성공시 'OK')
'Certificate' : 삭제된 인증서 정보
'errMsg' : 에러 발생시 에러메시지
var args = new Array();
args[0] = certNum.toString();
WizSignPG.removeCert(args, function(result) {
var runResult = result['result'];
if(runResult == 'OK') {
alert('인증서가 삭제되었습니다.')
}
}, function(error) {
alert(error['errMsg']);
});
== doValidateCert ==
* 선택한 인증서의 유효성 검증을 수행한다. (CRL 검증)
- 파라메터 인증서 번호 \\
- 반환값(해시 테이블) \\
'result' : 인증서 CRL 검증결과(성공시 'OK')
'status' : 인증서 상태
'errMsg' : 에러 발생시 에러메시지
var args = new Array();
args[0] = certNum.toString();
WizSignPG.doValidateCert(args, function(result) {
var runResult = result['result'];
var certStatus = result['status'];
if(runResult == 'OK') {
alert(certStatus);
}
}, function(error) {
alert(error['errMsg']);
});
==== Server Application ====
=== 관련 소스 ===
^유형^대상소스명^비고^
|Controller|egovframework.hyb.ios.pki.web.EgovPKIiOSAPIController.java|NPKIAPI 가이드 프로그램 Controller Class|
|Service|egovframework.hyb.ios.pki.service.EgovPKIiOSAPIService.java|NPKIAPI 가이드 프로그램 Service Class|
|ServiceIimpl|egovframework.hyb.ios.pki.service.impl.EgovPKIiOSAPIServiceImpl.java|NPKIAPI 가이드 프로그램 ServiceImpl Class|
|VO|egovframework.hyb.ios.pki.service.PKIiOSAPIDefaultVO.java|NPKIAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.ios.pki.service.PKIiOSAPIVO.java|NPKIAPI 가이드 프로그램 VO Class|
|VO|egovframework.hyb.ios.pki.service.PKIiOSAPIXmlVO.java|NPKIAPI 가이드 프로그램 XML 관련 VO Class|
|DAO|egovframework.hyb.ios.pki.service.impl.PKIiOSAPIDAO.java|NPKIAPI 가이드 프로그램 Dao Class|
|QUERY XML|resources/egovframework/sqlmap/hyb/ios/pki/EgovPKIiOSAPIGuide_SQL_XXX.xml|NPKIAPI 가이드 프로그램 QUERY XML|
|Idgen XML|resources/egovframework/spring/context-idgen.xml|NPKIAPI 가이드 프로그램 Id생성 Idgen XML|
=== 관련 테이블 ===
^테이블명^테이블명(영문)^비고^
|PKI|PKI|인증서 인증 로그 관리|
=== 테이블 정의서 ===
* PKI
^No^컬럼ID^컬럼명^타입^길이^Null^
|1|SN|일련번호|NUMERIC|6|NotNull|
|2|UUID|UUID|VARCHAR|50|NotNull|
|3|DN|인증데이터|VARCHAR|255|Null|
|4|CFTFC_DT|인증날짜시간|DATETIME| |Null|
|5|ENTRPRS_SE_CODE|업체구분|CHAR|15|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 ====
=== config.xml===
== Plugin ==
=== [Project_Name]/eGovModule/EGovComModule.h ===
#define kSERVER_URL @"Server_URL"
==== Server Application ====
=== resource/egovframework/sqlmap/sql-map-config_[DB명].xml ===
=== 표준 보안 API ===
설정 참조
===== 관련기능 =====
NPKI 디바이스 API 가이드는 크게 ** 모바일 기기 인증서 선택/인증하기 **, ** 인증 로그 정보 보기 ** 기능으로 구성되어있다.
==== 모바일 기기 인증서 선택/인증하기 ====
=== 비즈니스 규칙 ===
디바이스 API를 통해 모바일 기기에 저장된 인증서 리스트를 조회하고, 리스트에서 선택한 인증서로 인증서 인증을 한다.
=== 관련코드 ===
디바이스 API 내의 인증서 리스트 조회 함수를 사용하는 JavaScript 코드를 통해 인증서 리스트를 조회하고, 서명 데이터를 만드는 JavaScript 함수를 사용하여 서명한다.
// 인증서 리스트 조회
function fn_egov_go_certlist()
{
console.log("PKIWizSignAPIGuide fn_egov_go_certlist");
$.mobile.showPageLoadingMsg('a');
WizSignPG.getCertificates(fn_egov_getcertlistSuccess, fn_egov_getcertlistFail);
}
// 인증서 비밀번호 확인
function fn_egov_confirm_password() {
console.log('PKIWizSignAPIGuide fn_egov_confirm_password()');
var args = new Array();
var tmpIndex = document.getElementById("xsigncertindex").value;
args[0] = '1';//tmpIndex.toString();
args[1] = $("#loginPasswd").val();
console.log(args);
WizSignPG.verifyCertPassword(args, function(result) {
//Certificates
var runResult = result['result'];
var error = result['errMsg'];
if(error!=null){
alert(error);
}
if(runResult == 'OK') {
console.log("PKIWizSignAPIGuide fn_egov_confirm_password Completed");
// alert('인증서 비밀번호가 일치합니다.');
fn_egov_make_sign();
} else {
console.log("PKIWizSignAPIGuide fn_egov_confirm_password Failed");
}
}, function(error) {
alert("Error: \r\n" + error['errMsg']);
});
}
// 인증서 서명
function fn_egov_make_sign()
{
console.log('PKIWizSignAPIGuide fn_egov_make_sign()');
var args = new Array();
args[0] = '1';//document.getElementById("xsigncertindex").value;
args[1] = $("#loginPasswd").val();
args[2] = "usrId=&password=&name=";
WizSignPG.doSignature(args, fn_egov_makesign_ok, fn_egov_makesign_fail);
}
// 인증서 서명 데이터 서버로 인증 요청
function fn_egov_makesign_ok(arg)
{
var signedData = arg['signedData'];
var params = {uuid : device.uuid,
sign: signedData,
entrprsSeCode: 'PKI02'};
alert('Http Method:POST\nAcceptType:JSON\n전송데이터:' + JSON.stringify(params));
$.mobile.showPageLoadingMsg('a');
EgovInterface.submitAsynchronous(
[params, "/pki/addPKIiOSInfo.do"],
function(result) {
console.log("PKIWizSignAPIGuide fn_egov_makesign_ok request Completed");
var str = '{';
for (myKey in result){
str += myKey + ':' + result[myKey] + '\n';
}
str += '}';
alert('응답방식:RESTful\n응답Type:json, post\nParam:\n' + str);
//window.history.back();
$.mobile.hidePageLoadingMsg('a');
location.href = "index.html";
},
function(error) {
console.log("PKIWizSignAPIGuide fn_egov_makesign_ok request Failed");
var str = '{';
for (myKey in error){
str += myKey + ' : ' + error[myKey] + '\n';
}
str += '}';
alert('응답방식:RESTful\n전송Type:json, post\nParam:\n' + str);
$.mobile.hidePageLoadingMsg('a');
}
);
}
//올레인증서 호출
function doKISAShowApp() {
var args = new Array();
args[0] = 'PhoneGapTest';
args[1] = '01';
WizSignPG.runShowApp(args, function(result) {
// result
var runResult = result['result'];
// runResult == 'OK' -> 실행성공
console.log("PKIWizSignAPIGuide doKISAShowApp Completed");
}, function(error) {
console.log("PKIWizSignAPIGuide doKISAShowApp Failed");
navigator.notification.alert("Error: \r\n" + error['errMsg']);
});
}
// PKCS#12데이터를 인증서로 변환하여 저장한다.
function makeCert(strP12, certPass, newPass) {
var args = new Array();
args[0] = strP12;
args[1] = certPass;
args[2] = newPass;
WizSignPG.importPKCS12(args, function(result) {
var runResult = result['result'];
var certInfo = result['Certificate'];
if(runResult == 'OK') {
console.log("PKIWizSignAPIGuide makeCert Completed");
navigator.notification.alert('[' + certInfo['주체자'] + '] 인증서가 생성되었습니다.1')
fn_egov_go_certlist();
}
}, function(error) {
console.log("PKIWizSignAPIGuide makeCert Failed");
navigator.notification.alert("Error: \r\n" + error['errMsg']);
});
}
// KISA ollehApp으로부터 받은 URL데이터를 처리하여 PKCS#12데이터를 반환한다.
function handleOpenURL(url)
{
console.log('handleOpenURL');
var g_p12cert = callback_kisaShowApp(url);
makeCert(g_p12cert, 'han9476046946', 'han9476046946');
}
=== 관련화면 및 수행매뉴얼 ===
^Action^URL^Controller method^QueryID^
|인증서 인증|/pki/xml/addPKIiOSInfo.do|addPKIInfoXml|"PKIiOSAPIDAO.insertPKIInfo"|
^인증서 리스트^인증서 인증^
|{{:egovframework:hyb:guide:ios:wiz_cert_list.png|}}|{{:egovframework:hyb:guide:ios:wiz_log.png|}}|
인증서 리스트 화면에서 인증할 인증서를 선택하고 인증서 인증 화면에서 PASSWD 항목에 패스워드를 입력 후 "인증 확인" 버튼을 클릭한다. \\
단, PASSWD 항목에서 validation을 확인하고, 조건이 불충분 할 경우 오류 메시지가 출력된다.
인증 확인 : 인증서 인증을 하기 위해서 PASSWD 항목에 인증서 패스워드를 입력 후 "인증 확인" 버튼을 클릭한다. \\
Back 버튼 : **NPKI 디바이스 API 가이드 프로그램 메뉴** 화면 또는 **인증서 리스트** 화면으로 이동한다. \\
==== 인증 로그 정보 보기 ====
=== 비즈니스 규칙 ===
웹 서버 어플리케이션으로 부터 인증서 인증 결과 로그를 조회한다. \\
=== 관련코드 ===
function fn_egov_go_loginInfoList()
{
$.mobile.changePage("#loginInfoList", "slide", false, false);
// get the data from server
console.log('fn_egov_go_loginInfoList()');
var accept_type = "json";
$.mobile.showPageLoadingMsg('a');
// get the data from server
EgovInterface.submitAsynchronous(
["/pki/pkiInfoList.do"],
function(result) {
console.log("PKIWizSignAPIGuide fn_egov_go_loginInfoList Completed");
var list_html = "";
var totcnt = result.pkiInfoList.length;
for (var i = 0; i < totcnt; i++) {
var data = result.pkiInfoList[i];
var entrprsSe = "NONE";
var entrprsSeCode = data.entrprsSeCode;
if(entrprsSeCode == 'PKI01')
entrprsSe = "MagicXSign";
else if(entrprsSeCode == 'PKI02')
entrprsSe = "WizSign";
else if(entrprsSeCode == 'PKI03')
entrprsSe = "XecureSmart";
list_html += "subjdn : " + data.dn + "
";
list_html += "Date : " + data.crtfcDt + "
";
list_html += "NPKI : " + entrprsSe + "
=== 관련화면 및 수행매뉴얼 ===
^기능^URL^Controller^method^QueryID^
|인증서 인증 결과 로그 조회|/pki/xml/pkiInfoList.do|EgovPKIiOSAPIController|selectPKIInfoListXml|PKIiOSAPIDAO.selectPKIInfoList|
{{:egovframework:hyb:guide:ios:wiz_log.png|}}
===== 컴파일 디버깅 배포 =====
==== 컴파일 ====
=== NPKI Device Applicaton 컴파일 방법 ===
1. 디바이스 또는 시뮬레이터에서 실행하고자 할 경우 빨간 테두리 영역을 클릭한다.\\
{{:egovframework:hyb:guide:ios:xcode실행영역선택1.png|}}\\
2. 디바이스 또는 시뮬레이터를 선택한다.\\
{{:egovframework:hyb:guide:ios:xcode실행영역선택2.png|}}\\
3. 실행 버튼을 클릭한다.\\
{{:egovframework:hyb:guide:ios:xcode실행버튼.png|}}\\
4. 인트로 화면과 메인 화면을 확인한다.\\
{{:egovframework:hyb:guide:ios:wiz_intro2.png|}}{{:egovframework:hyb:guide:ios:wiz_main2.png|}}
=== NPKI Server Applicaton 컴파일 방법 ===
* NPKIAPI 서버사이드 가이드 프로그램의 실행은 프로젝트를 마우스 오른쪽 버튼을 클릭 한후 Run As>Run On Server 버튼을 통해 실행 할 수 있다.
{{:egovframework:hyb:guide:ios:서버실행.png?640|}}
* 빌드가 성공적으로 수행 되면 이클립스의 콘솔 창에서 'Server Startup in xxx ms' 메시지를 확인 할 수 있다.
{{:egovframework:hyb:guide:ios:웹서버실행성공.png?700|}}
==== 디버깅 ====
디바이스 어플리케이션에서 발생한 오류 내용 확인 및 디버깅을 위해서는 폰갭 프레임워크에서 제공하는 console.log를 이용할 수 있다. console.log 함수는 자바스크립트 구문에서 사용할 수 있는 디버그 코드로 이클립스 및 Xcode에서 확인 할 수 있다.
* 실제 콘솔 로그 예
function fn_egov_network_check(doCheck)
{
console.log('DeviceAPIGuide fn_egov_network_check');
var networkState = navigator.network.connection.type;
...
}
* xCode 콘솔 창
{{:egovframework:hyb:guide:ios:cameradebugxcode.png?700|}}\\
* Organizer 로그 창
{{:egovframework:hyb:guide:ios:cameradebugorganizer.png?700|}}\\
NPKI API 가이드 프로그램 에서는 디버깅을 위하여 다음과 같이 콘솔 정보를 출력한다.
^디버그 코드^디버깅 내용^
|PKIWizSignAPIGuide deviceready Success|Device 준비 성공 시|
|PKIWizSignAPIGuide fn_egov_makesign_ok request Completed|웹 서버 어플리케이션으로 부터 인증서 인증 성공 시 |
|PKIWizSignAPIGuide fn_egov_makesign_ok request Failed|웹 서버 어플리케이션으로 부터 인증서 인증 실패 시 |
|PKIWizSignAPIGuide fn_egov_makesign_ok Success|인증서 서명 성공 시 |
|PKIWizSignAPIGuide fn_egov_makesign_fail Failed|인증서 서명 실패 시 |
|PKIWizSignAPIGuide fn_egov_getcertlistSuccess Success|인증서 리스트 조회 성공 시 |
|PKIWizSignAPIGuide fn_egov_getcertlistFail Failed|인증서 리스트 조회 실패 시 |
|PKIWizSignAPIGuide doKISAShowApp Failed|올레인증서 호출 실패 시|
|PKIWizSignAPIGuide doKISAShowApp Completed|올레인증서 호출 성공 시|
|PKIWizSignAPIGuide makeCert Completed|올레인증서 저장 성공 시|
|PKIWizSignAPIGuide makeCert Failed|올레인증서 저장 실패 시|
==== 배포 ====
NPKI 디바이스 API 가이드 다운로드 : [[http://www.egovframe.go.kr/cop/bbs/selectBoardArticle.do?bbsId=BBSMSTR_000000000161&nttId=698&menu=3&submenu=9|Click]]
===== 참고자료 =====
* UX/UI 라이브러리 : jQuery Mobile[[http://jquerymobile.com/demos/1.3.2/|Click]]\\
* Hybrid : PhoneGap [[http://phonegap.com]] \\
* NPKIAPI : (주)케이사인 [[http://www.ksign.com]] \\
* 표준보안API : http://www.gpki.go.kr/ \\