==========
[securekeypad.raon]
==========

mTransKey 제품에 대한 필수 API 를 정의


---------
mTransKey API
---------

securekeypad 제품에 대한 3rd Party연동 기능을 제공한다.




.. _KeyPadType:
 
KeyPad Type
-----------------

 * 키패드 타입에 대한 설정 정보

=======================  =============
Type                     Description             
=======================  =============
NUMBER            		 	숫자
QWERTY_LOWER             	쿼티 소문자 
QWERTY_UPPER                쿼티 대문자 
ABCD_LOWER                  영문 소문자
ABCD_UPPER                  영문 대문자
SYMBOL     					특수문자
=======================  =============


.. _InputType:
 
Input Type
-----------------

 * 키패드 Input 타입에 대한 설정 정보

=============================  ==
Type                     
=============================  ==
TEXT_IMAGE            	 
TEXT_PASSWORD            
TEXT_PASSWORD_EX         
TEXT_PASSWORD_IMAGE      
TEXT_PASSWORD_LAST_IMAGE 
=============================  ==



.. _statusType:

status Type
------------


============  ===================
Type          Description             
============  ===================
PROCESSING    	진행 중
SUCCESS    		정상 처리됨
FAIL     		처리 중 문제가 발생함
============  ===================


검증  
--------------

.. js:function:: M.plugin('3rd_securekeypad_raon').show( setting )

	.. versionchanged:: 2.0.0
	.. 설정정보에 대한 자세한 사항은, mTransKey 에서 제공하는 메뉴얼을 참고하시기 바랍니다. 
	.. 설정정보에 대한 값을 제외시, default 값이 적용됩니다.

	:param Object setting: 설정 정보
	:param String keypad_type: 키패드 타입 ( :ref:`KeyPadType` )
	:param String input_type: input 타입 ( :ref:`InputType` )
	:param String name_label: name label
	:param Int	input_maxlength: 최대 입력 길이 
	:param Int	input_minlength: 최소 입력 길이 
	:param String crypt_algorithim: 암호화 알고리즘  (제외시 default 적용)
	:param String set_hint: 힌트
	:param String max_length_message: 최대값 초과 입력시, 표시되는 문구 
	:param String min_length_message: 최소값 미만 입력시, 표시되는 문구 
	:param Boolean button_sound: sound 설정 
	:param String notice_message: 공지 메시지 
	:param String info_message: info message
	:param String alertdialog_title: dialog title
	:param String secureKey: 암호화
	 키 
	:param Function setting.callback: 입력 결과  콜백 함수
	
	.. js:function:: callback(status, result)
		
		:param String status: 상태 ( :ref:`statusType` )		
		:param Object result: 입력 결과 


Example:

    .. code-block:: javascript
        
		M.plugin('3rd_securekeypad_raon').show({
			'keypad_type':'NUMBER',
			'input_type':'TEXT_IMAGE',
			'name_label':'',
			'input_maxlength':20,
			'input_minlength':5,
			'crypt_algorithim':'',
			'set_hint':'5자 이상, 20자 이하의 비밀번호',
			'max_length_message':'20자 이하여야 합니다.',
			'min_length_message':'5자 이상이어야 합니다',
			'button_sound':false,
			'notice_message':'공지',
			'info_message':'비밀번호입력',
			'alertdialog_title':'',
			'secureKey':'dddd',
		 	callback:function(status, result){
		 		console.log(result);
		 	}
		 });



복호화  
--------------

.. js:function:: M.plugin('3rd_securekeypad_raon').decrypt( setting )

	.. versionchanged:: 2.0.0
	
	:param Object setting: 설정 정보
	:param String setting.secureKey: 암호화 키 
	:param String setting.cipherData: 암호화 데이터 
	:param Int setting.iRealDataLength: 실제 데이터 길이 
	:param Function setting.callback: 복호화 결과  콜백 함수
	
	.. js:function:: callback(status, result)
		
		:param String status: 상태 ( :ref:`statusType` )
		:param Object result: 복호화 결과 


Example:

    .. code-block:: javascript
        
		M.plugin('3rd_securekeypad_raon').decrypt({
			'secureKey':'dddd',
			'cipherData':'adfadagd',
			'iRealDataLength':10,
		 	callback:function(status, result){
		 		console.log(result);
		 	}
		 });