MagicXSign NPKI API

MagicXSign은 PhoneGap Plugin을 사용하여 Android, iPhone 에서 드림시큐리티 MagicXsign 과 MagicMRS를 사용하기 위한 라이브러리 입니다.

• 공인인증서(NPKI)를 이용한 서명 및 인증서 검증 방법제공
• 인증서 이동서버를 통해 PC의 인증서를 스마트폰으로 이동
• 상기 모듈들은 Native로 구성이 되어 있지만 PhoneGap Plugin 을 통해 WebView를 통해 사용
• iOS 의 경우 APP 의 Keychain 에 인증서 저장
• Android 의 경우 SDCard/NPKI 에 인증서 저장

NPKI MagicXSign Library

Cordova.plist 설정

	<key>Plugins</key>
	<dict>
		<key>MagicXSignPlugin</key>
		<string>MagicXSignPlugin</string>
	</dict>

• MagicXSign 을 사용하기 위해 초기화를 한다.
  

window.plugins.magicxsign.init(var Flag)

window.plugins.magicxsign.init("false");
window.plugins.magicxsign.init("true");

• 단말의 인증서를 jsonString 형식으로 맞추어서 읽어온다.

window.plugins.magicxsign.getcertlist( success return , fail return, jsonString);

• 조회 할 인증서의 정보

var setDefine = ["oidname","issuer","name","subjdn","start","end"];
window.plugins.magicxsign.getcertlist(getcertlistSuccess, getcertlistFail, JSON.stringify(setDefine));

• 인증서를 삭제 한다.

window.plugins.magicxsign.certdel(success return, fail return, Cert Index);

window.plugins.magicxsign.certdel(certdelSuccess, certdelFail, 0);

• 인증서의 비밀번호를 변경한다.

window.plugins.magicxsing.certchagepassword(success return, fail return, jsonString);

var setDefine = {};
setDefine["certindex"] = iCertIndex;	//선택된 인증서 index
setDefine["oldpassword"] = oldpassword;	//선택된 인증서 Password
setDefine["newpassword"] = newpassword;	//신규 인증서 Password
window.plugins.magicxsing.certchagepassword(certchagepasswordSuccess, certchagepasswordFail, JSON.stringify(setDefine));

• 서명 데이터를 생성한다.

window.plugins.magicxsing.makesign(success return, fail return, jsonString);

var setDefine = {};
setDefine["plaintext"] = encodeURIComplnent(MagicXSign_makeQueryString(form)));
setDefine["uri"] = sURI;
setDefine["certindex"] = document.getElementById("xsigncertindex").value;
setDefine["certpassword"] = document.getElementById("xsigncertpassword").value;
window.plugins.magicxsign.makesign(makesign_ok, makesign_fail, JSON.stringify(setDefine));

PC의 인증서를 스마트폰으로 옮기는 서비스

• 인증서버에 접속 하여 인증번호를 얻어온다.

window.plugins.magicxsign.mrs_makecode(success return, fail return, jsonString);

var setDefine = {};
setDefine["phoneno"] = "123456789";
setDefine["serverip"] = "125.141.204.173";
setDefine["serverport"] = "10001";
setDefine["serviceid"] = "dreamAPP";
window.plugins.magicxsign.makesign(makesign_ok, makesign_fail, JSON.stringify(setDefine));

• 인증서를 전송 받아 저장하고 인증서 정보를 리턴한다.

window.plugins.magicxsign.mrs_makecode(success return, fail return, jsonString);

var setDefine = ["oidname","issuer","name","subjdn","start","end"]
window.plugins.magicxsign.mrs_waitcert(getcertlistSuccess, getcertlistFail, JSON.stringify(setDefine));

• 인증서 이동을 중지한다.

window.plugins.magicxsign.mrs_stopcertmove();

• 올레인증서가 인스톨 되어있는지 확인한다.

window.plugins.magicxsign.ollecert_check(ollecert_Check_Success, ollecert_Check_Fail);

• 올레인증서 인스톨을 위해 AppStore의 올레인증서 인스톨 화면을 호출한다.

window.plugins.magicxsign.ollecert_install();

• 올레인증서에서 인증서를 요청하여 선택된 인증서를 저장한다.

var setDefine = ["oidname","issuer","name","subjdn","start","end"];
window.plugins.magicxsign.ollecert_getcert(certGetFromOlleCert_Success, certGetFrom OlleCert_Fail, JSON.stringify(setDefine));