CROSSCERT WEB HTML5 :: 한국전자인증 웹 표준 모듈

릴리즈 버전
1.0.1.13 UI
2.0.6.3 NIM(UniCRSLocalServer)

API
공통항목
Value
인증서 발급
인증서 관리
전자서명
전자서명(like ActiveX)
- p#7 & verifyVID & p#7(withHash)
- p#7 & p#7(withHash)
파일 서명
신원확인
암-복호화
XML 전자 세금 계산서
본인확인
- 본인확인
기타

중요 : IE(8, 10, 11, Edge), Google Chrome, FireFox, Safari, Opera 등의 브라우져에서 동작합니다.

기본 HTML 설정

html 헤더 부분에 css파일과 js파일을 링크 합니다.
X-UA-Compatible 메타태그를 입력 해야 IE의 하위 버전(8,9,10) 에서 정상 동작하게 됩니다.
IE사용중 브라우져 모드가 쿼크 모드 일때 비정상적으로 표시 됩니다.

Copy


<head>
	<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
	<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
	<link rel="stylesheet" type="text/css" href="../unisignweb/rsrc/css/certcommon.css?v=1" />
	<script type="text/javascript" src="../unisignweb/js/unisignwebclient.js?v=1.0.33.0"></script>
	<script type="text/javascript" src="UniSignWeb_Multi_Init_Nim.js?v=1.0.33.0"></script>
</head>

Value

device	Value
이동식디스크	1
보안토큰	2
스마트카드	3
휴대폰	4
하드디스크	5
스마트인증	6

해쉬 알고리즘	Value
sha2	'SHA256'
sha1	'SHA1'
md5	'MD5'

암호화 알고리즘	Value
seed	'SEED'
3des	'3DES'

charset	Value
utf8	'UTF-8'
euckr	'EUC-KR'

인증서 정보	Value
version	버전
serialNumer	일련번호
signAlgo	서명알고리즘
issuerName	발급자
validateFrom	유효기간(시작)
validateTo	유효기간(끝)
subjectName	주체
publicKey	공개키
authorityKeyIndentifier	기관 키 식별자
subjectKeyIndentifier	주체 키 식별자
keyUsage	키 사용
policiesOid	인증서 정책 OID
subjectAltName	주체 대체 이름
authorityInfoAccess	기관 정보 액세스
crlDistributionPoints	CRL 배포 지점
policiesCps	인증서 정책 cps
policiesUserNotice	사용자 알림
signature	인증서 전자서명값

폐기사유	Value
0	CRL_REASON_UNSPECIFIED
1	CRL_REASON_KEY_COMPROMISE
2	CRL_REASON_CA_COMPROMISE
3	CRL_REASON_AFFILIATION_CHANGED
4	CRL_REASON_SUPERSEDED
5	CRL_REASON_CESSATION_OF_OPERATION
6	CRL_REASON_CERTIFICATE_HOLD

인증서 발급

인증서 발급 요청 API

IssueCert( refNum, AuthCode, fnCallBack );

Parameter	설명
refNum	참조번호. 만약 입력하지 않으면 내부에서 입력창 출력
authCode	인가코드. 만약 입력하지 않으면 내부에서 입력창 출력
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지

암호화용 인증서 발급

암호화용 인증서 발급 요청 API

IssueKMCert( fnCallBack );

Parameter	설명
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지

인증서 간편 발급 - 개인

인증서 발급 요청 API

DecryptWithUserSymmKey( mode, encalg, symmKey, b64EncData, fnCallBack );

Parameter	설명
mode	사업자인지 개인인지 확인하는 옵션. 0 - 사업자, 1 - 개인
encalg	seed만 지원. 'seed'
symmKey	현재 사용하지 않고 있음
b64EncData	암호화된 데이터
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
decryptedData	암호화된 데이터에 대한 복호화된 데이터

         생일 : 780113

ii8k+C9iSwgdrA9+KHnp5+OLprgUO+xkjfn6PY+tCKskeqbBrs4twgxQ2ZupCNCI5GImK9qj1kSva5rHjICcvm3srx3foJDnQz0XDQHT3c9X2etgUbzLd0y3rgcxLjwxpE7qm2Ri+edq/Pryak62NZY4BPfchtHKtBXxjm6qMdW9+E4XCGcj1H4287YEVWqHH1D6ekCGIfsegOXw0D9oqSq6Uj2TpVJEkYYJLeqGMj/0if0PYRg1y/hqm4XtbhjCegoY85JaSu8rrK5O7YtB8OjZs52wVcU+szsiPnOvvj4Cu2f0/ZQq+eCgNGT9YwgqcpFBSMa+5Cs3NrcrOViyk22Lr4yWwvi9ZFv8NE3fpDQ3wHOcvVlp+nfVev97HxV9GUMHWXhh5tPuQEK2VzKMD9lEKG06ps5mWqECXgr8Jnn985vxWpjK6vRYGfZYOu9lNToHodm81/4cWSeGd70IAvL7G1y2WipHKHbfc3poXaVpP1yNQFVYfJUp1lbpufp98GtcNMiCiC6ojL51qPqP05Nu5vk9MWxZ0nurWcXvgtOrKfCfy7pzdHcRNT2fvbzoyKzR87gKQ1aZOnPXRoNULfx39NsuuiFb1QCb9LpVlKY=

Copy

인증서 간편 발급 - 사업자

인증서 발급 요청 API

DecryptWithUserSymmKey( mode, encalg, symmKey, b64EncData, fnCallBack );

Parameter	설명
mode	사업자인지 개인인지 확인하는 옵션. 0 - 사업자, 1 - 개인
encalg	seed만 지원. 'seed'
symmKey	현재 사용하지 않고 있음
b64EncData	암호화된 데이터
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
decryptedData	암호화된 데이터에 대한 복호화된 데이터

사업자 번호 : 1262765447

viDlsfxIsc8rW0XsZq+l2NqpVzIA7R6Sq6o40h8j/5L+f1CgilVMobefB9MhSgFR6aEdsV43uEBoytUEqutrrRUnNvhroGT7T7Z3BUfchKQ5z/GpzYCwhh3HK3epWV1cnVbEhnHjU/hdVxnjSN9zyD8OcMU7xIidp+I67tY2w7GcWO3RqdekdxOH3eTbfsIkr2CATf6C3Z7YPSaOwP+harxLIF9EFwPys1OooFBzJBmszLFtHwopQKLglJtjE1vQourGTBC9n6Qsn0z94Lm+zbG4fOy4miHsCKk/ZQpPH4nBkaoIUzUo4R13MfSwC7r6fmDZiwYfCSJ+wsBiEgYVOGM3bYhu+P9nK9ljw/DBWiLgg5zbDhdlizgV2xgRw7rt0i4KwsBGiQLcZFUjXv8P4G0Gnv5FS+xWXQSMjh2McSIod1H55Get4dPFwvTxB7zEJHCkVvY25KsZ7zCf0oyK/josmgiw7i0y9opiu1IABUWuiUXPShwo8IQ1iGkcWOBEjRtwBfTm1gLD0qGcC+VgkXOI0ypS2Kx/KR9el5Zf98VbDJ3j3XdmdfP6E/dn+Z/sSifNz/IF80QQkXHIymAoRJnLoAro+pkQv6bCihyhtrY=

Copy

인증서 갱신

인증서 갱신 요청 API

RenewCert( fnCallBack );

Parameter	설명
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지

인증서 갱신

인증서 갱신 요청하고 오류 발생시 subjectdn 반환을 요청하는 API

RenewCertNSignedSubjectDn( device, drive, dn, charset, errMsgShow, fnCallBack, [signCallback] );

인코딩타입	Value
utf8	1
euckr	2

메세지 출력 여부	Value
출력	true
미출력	false

Parameter	설명
device	- 인증서 선택창에서 활성화 시키고자 하는 매체. - 해당 옵션을 사용하지 않고자 하면 '-1' 설정 - 설정 가능한 device : 하드디스크, 이동식디스크, 보안토큰 ( device index ). 그 외에는 매체 특성상 설정하면 문제 발생 [필수]
drive	- 인증서 선택창에서 활성화 시키고자 하는 드라이브 - 해당 옵션을 사용하지 않고자 하면'-1' 설정 [필수]
dn	- 인증서 선택창에서 해당 dn만 출력하고자 할때 설정 - 모든 인증서를 보여주고자 하면 null 전달 [필수]
charset	- 갱신에서 오류가 발생했을때 전자서명에 사용될 subjectDn의 encoding type. - 인코딩 타입 참조 [필수]
errMsgShow	- error 발생시 내부적으로 에러메세지 출력여부 - 메세지 출력 여부 참조 [필수]
fnCallBack	- 기능 완료시 호출되는 callback 함수. [필수]
signCallBack	- 인증서 선택 및 비밀번호 입력 후 인증서의 Attributes로 갱신 진행여부를 판단하기 위하여 사용되는 callback 함수 callback 함수의 인자값으로 선택한 인증서의 Attributes 값이 반환 되고 이를 이용하여 갱신 여부를 판단하고 함수의 return 값으로 진행 여부를 결정한다. true 를 리턴하는 경우 갱신 진행, false를 리턴하는 경우 진행이 중지되고 fnCallBack 함수를 호출한다

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
certAttrs	인증서 갱신에 실패했을때, 갱신 요청했던 사용자의 인증서 정보
signedData	인증서 갱신에 실패했을때, 갱신 요청했던 사용자의 subjectDn을 전자서명해서 반환
curDevice	선택했던 인증서가 저장되어 있는 매체 device index
curDrive	- 선택했던 인증서가 저장되어 있는 매체 의 drive - drvive 값은 정해져 있지 않고, pc에 연결되어 있는 기기갯수에 따라서 index가 달라짐

Copy

인증서 폐지

인증서 폐지 요청 API

RevocateCert( fnCallBack, [signCallback] );

Parameter	설명
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]
signCallBack	- 인증서 선택 및 비밀번호 입력 후 인증서의 Attributes으로 폐지 진행여부를 판단하기 위하여 사용되는 callback 함수 callback 함수의 인자값으로 선택한 인증서의 Attributes 값이 반환 되고 이를 이용하여 폐지 여부를 판단하고 함수의 return 값으로 진행 여부를 결정한다. true 를 리턴하는 경우 폐지 진행, false를 리턴하는 경우 진행이 중지되고 fnCallBack 함수를 호출한다

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지

인증서 효력정지

인증서 효력정지 요청 API

SOECert( fnCallBack, [signCallback] );

Parameter	설명
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]
signCallBack	- 인증서 선택 및 비밀번호 입력 후 인증서의 Attributes로 효력정지 진행여부를 판단하기 위하여 사용되는 callback 함수 callback 함수의 인자값으로 선택한 인증서의 Attributes 값이 반환 되고 이를 이용하여 효력정지 여부를 판단하고 함수의 return 값으로 진행 여부를 결정한다. true 를 리턴하는 경우 효력정지 진행, false를 리턴하는 경우 진행이 중지되고 fnCallBack 함수를 호출한다

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지

인증서 키쌍 체크

서명용, 암호화용 인증서와 개인키 쌍이 올바른지 확인하는 API. 인증서 유효성도 같이 체크

VerifyKeyPair( fnCallBack );

Parameter	설명
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지

인증서 관리

인증서 비밀번호 변경, 삭제, 가져오기, 내보내기, 복사 기능을 가능하게 하는 관리창 출력하는 API

ManageCert( );

인증서 관리

인증서 복사 기능을 가능하게 하는 관리창 출력하는 API

ManageCertByType(index);

기능	Value
인증서 복사	1
비밀번호 변경	2
인증서 가져오기	3
인증서 내보내기	4
인증서 삭제	5
안전디스크 백업	6
안전디스크 복원	7

기능 index

인증서 서명 - PKCS #1

p1 전자서명 생성 요청 API

DigitalSignature( data, dn, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음. default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
theCert	전자서명에 사용된 base64 인코딩된 인증서
theDN	전자서명에 사용된 인증서의 dn

Copy

서명 검증

p1 서명 검증 API

VerifyDigitalSignature( data, signeddata, cert, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
signeddata	원문을 p#1으로 서명한 서명데이터 [필수]
cert	서명에 사용된 사용자의 base64 인코딩된 인증서 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

Copy

인증서 서명 - PKCS #1 (like ActiveX)

p1 전자서명 생성 요청 API (like ActiveX)
GetUserDN 함수로 선택한 인증서의 dn 값을 Parameter로 지정하여 실행 시 추가 인증서 선택 없이 진행

DigitalSignatureWithPwd( data, dn, pwd, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
dn	서명에 사용될 인증서의 dn필터로 default:null
pwd	서명에 사용될 인증서의 password. default: ""
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
theCert	전자서명에 사용된 base64 인코딩된 인증서
theDN	전자서명에 사용된 인증서의 dn

Copy

서명 검증

p1 서명 검증 API

VerifyDigitalSignature( data, signeddata, cert, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
signeddata	원문을 p#1으로 서명한 서명데이터 [필수]
cert	서명에 사용된 사용자의 base64 인코딩된 인증서 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

Copy

인증서 서명 - PKCS #7

p7 전자서명 데이터 생성요청 API.

SignDataEx( data, dn, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열)이며 [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
curDevice	전자서명에 사용된 인증서가 위치한 device index
certAttrs	전자서명에 사용된 인증서 정보
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

p7 서명 검증 API

VerifySignData( signeddata, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
plaintext	검증 성공 : 원문데이터 반환. 검증 실패 : 원문데이터 미반환

인증서 서명 - PKCS #7(like ActiveX)

원문이 포함되어 있는 p7 전자서명 데이터 생성요청 API(like ActiveX).
GetUserDN 함수로 선택한 인증서의 dn 값을 Parameter로 지정하여 실행 시 추가 인증서 선택 없이 진행

SignDataNonEnveloped( data, dn, password, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열)이며 [필수]
dn	서명에 사용될 인증서의 dn default:null
password	서명에 사용될 인증서의 비밀번호 default:""
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
curDevice	전자서명에 사용된 인증서가 위치한 device index
certAttrs	전자서명에 사용된 인증서 정보
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

p7 서명 검증 API

VerifySignData( signeddata, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
plaintext	검증 성공 : 원문데이터 반환. 검증 실패 : 원문데이터 미반환

인증서 서명 - PKCS #7(No Content)

원문이 포함되지 않은 p7 전자서명 데이터 생성요청 API.

SignDataExcludeContentEx( data, dn, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열)이며 [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
curDevice	전자서명에 사용된 인증서가 위치한 device index
certAttrs	전자서명에 사용된 인증서 정보
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

원문 없는 p#7 데이터 서명 검증 API

VerifyExcludedContentSignData( data, signeddata, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

인증서 서명 - PKCS #7(No Content)

원문이 포함되지 않은 p7 전자서명 데이터 생성요청 API.

SignDataNGetIdentifierByEnvlp( data, dn, kmCert, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
kmCert	전자서명에 사용된 인증서의 R 값을 암호할때 사용되며, 복호화 하고자 하는 측의 암호화 인증서. [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
curDevice	전자서명에 사용된 인증서가 위치한 device index
certAttrs	전자서명에 사용된 인증서 정보
b64RValue	전자서명에 사용된 인증서의 암호화된 R 값을 base64 인코딩 한 값
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

p7 서명 검증 API

VerifySignData( signeddata, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
plaintext	검증 성공 : 원문데이터 반환. 검증 실패 : 원문데이터 미반환

인증서 서명 - PKCS #7(with Hashdata)

원문을 HashData로 전달하고, 원문 포함이 되지 않는 p7 전자서명 데이터 생성요청 API.

SignData_noConWithHash( jsondata, dn, hashAlgo, useAuthAttr, fnCallBack );

Parameter	설명
jsondata	원문을 hash 한 값을 포함한 json 타입의 data. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
hashAlgo	원문을 hash할때 사용한 알고리즘 . [필수]
useAuthAttr	PKCS#9 Auth Attribute 추가 여부 [필수] default는 false
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
certAttrs	전자서명에 사용된 인증서 정보
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

Hashdata와 원문 없는 p#7 데이터 서명 검증 API

VerifySignData_noConWithHash( hashdata, signeddata, fnCallBack );

Parameter	설명
hashdata	서명에 사용된 base64 인코딩 된 hash 데이터 . [필수]
signeddata	hash 데이터를 p#7으로 서명한 원문이 포함되지 않은 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

인증서 서명 - PKCS #7 & R 값 획득 (with Hashdata)

원문을 HashData로 전달하고, 원문 포함이 되지 않는 p7 전자서명 데이터 생성 및 R 값 요청 API.

SignDataNGetIdentifierByEnvlp_noConWithHash( jsondata, dn, hashAlgo, kmCert, useAuthAttr, fnCallBack );

Parameter	설명
jsondata	원문을 hash 한 값을 포함한 json 타입의 data. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
hashAlgo	원문을 hash할때 사용한 알고리즘 . [필수]
kmCert	전자서명에 사용된 인증서의 R 값을 암호할때 사용되며, 복호화 하고자 하는 측의 암호화 인증서. [필수]
useAuthAttr	PKCS#9 Auth Attribute 추가 여부 [필수] default는 false
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
certAttrs	전자서명에 사용된 인증서 정보
b64RValue	전자서명에 사용된 인증서의 암호화된 R 값을 base64 인코딩 한 값
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

Hashdata와 원문 없는 p#7 데이터 서명 검증 API

VerifySignData_noConWithHash( hashdata, signeddata, fnCallBack );

Parameter	설명
hashdata	서명에 사용된 base64 인코딩 된 hash 데이터 . [필수]
signeddata	hash 데이터를 p#7으로 서명한 원문이 포함되지 않은 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

인증서 서명 - Multi PKCS #1

여러개의 데이터에 대한 p1 전자서명 생성 요청 API

MultiDigitalSignature( jsondata, dn, fnCallBack );

Parameter	설명
jsondata	서명할 원문 데이터 (문자열)을 json type으로 생성해서 전달. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음. default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
theCert	전자서명에 사용된 base64 인코딩된 인증서
theDN	전자서명에 사용된 인증서의 dn

Copy

서명 검증

p1 서명 검증 API

VerifyDigitalSignature( data, signeddata, cert, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
signeddata	원문을 p#1으로 서명한 서명데이터 [필수]
cert	서명에 사용된 사용자의 base64 인코딩된 인증서 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

인증서 서명 - Multi PKCS #7

여러개의 데이터에 대한 p7 전자서명 생성 요청 API

SignMultiDataEx( jsondata, dn, fnCallBack );

Parameter	설명
jsondata	서명할 원문 데이터 (문자열)을 json type으로 생성해서 전달. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음. default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
certAttrs	전자서명에 사용된 인증서 정보
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

p7 서명 검증 API

VerifySignData( signeddata, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
plaintext	검증 성공 : 원문데이터 반환. 검증 실패 : 원문데이터 미반환

인증서 서명 - Multi PKCS #7 & R 값 획득

여러개의 데이터에 대한 p7 전자서명 생성 요청과 R 값 반환 요청 API

SignMultiDataNGetIdentifierByEnvlp( jsondata, dn, kmCert, fnCallBack );

Parameter	설명
jsondata	서명할 원문 데이터 (문자열)을 json type으로 생성해서 전달. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음. default:null
kmCert	전자서명에 사용된 인증서의 R 값을 암호할때 사용되며, 복호화 하고자 하는 측의 암호화 인증서. [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
certAttrs	전자서명에 사용된 인증서 정보
b64RValue	전자서명에 사용된 인증서의 암호화된 R 값을 base64 인코딩 한 값
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

p7 서명 검증 API

VerifySignData( signeddata, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
plaintext	검증 성공 : 원문데이터 반환. 검증 실패 : 원문데이터 미반환

인증서 서명 - Multi PKCS #7 with noCotent

여러개의 데이터에 대한 p7 전자서명(원문 포함하지 않는) 생성 요청API

SignMultiDataExcludeContentEx( jsondata, dn, fnCallBack );

Parameter	설명
jsondata	서명할 원문 데이터 (문자열)을 json type으로 생성해서 전달. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음. default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
certAttrs	전자서명에 사용된 인증서 정보
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

원문 없는 p#7 데이터 서명 검증 API

VerifyExcludedContentSignData( data, signeddata, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

인증서 서명 - 1. p#7 & VerifyVID 2. p#7(withHash)

1. p#7 전자서명 생성과 vid 검증을 요청하는 API
2. 인증서 선택창 출력 없이 원문을 HashData로 전달하고, 원문 포함이 되지 않는 p7 전자서명 데이터 생성요청 API.

1. SignDataNVerifyVID API를 호출한 후 callback 함수에서
2. SignData_noConWithHashEx 를 호출

Copy

인증서 서명 - 1. p#7 2. p#7(withHash)

1. p#7 전자서명 생성을 요청하는 API
2. 인증서 선택창 출력 없이 원문을 HashData로 전달하고, 원문 포함이 되지 않는 p7 전자서명 데이터 생성요청 API.

1. SignDataEx API를 호출한 후 callback 함수에서
2. SignData_noConWithHashEx 를 호출

Copy

인증서 서명 - PKCS #7(with Hashdata)

원문을 HashData로 전달하고, 원문 포함이 되지 않는 p7 전자서명 데이터 생성요청 API.

SignData_noConWithHashEx( useSavedcertInfo, jsondata, dn, hashAlgo, useAuthAttr, fnCallBack );

Parameter	설명
useSavedcertInfo	true이면 내부적으로 저장되어 있는 인증서의 정보를 사용하고 인증서 선택창을 출력하지 않음. (default: false)
jsondata	원문을 hash 한 값을 포함한 json 타입의 data. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
hashAlgo	원문을 hash할때 사용한 알고리즘 . [필수]
useAuthAttr	PKCS#9 Auth Attribute 추가 여부 [필수] default는 false
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
certAttrs	전자서명에 사용된 인증서 정보
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

Copy

서명 검증

Hashdata와 원문 없는 p#7 데이터 서명 검증 API

VerifySignData_noConWithHash( hashdata, signeddata, fnCallBack );

Parameter	설명
hashdata	서명에 사용된 base64 인코딩 된 hash 데이터 . [필수]
signeddata	hash 데이터를 p#7으로 서명한 원문이 포함되지 않은 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

인증서 서명 - PKCS #7(파일)

전달된 file을 읽어서 해당 내용에 대한 p7 전자서명 데이터 생성요청 API.

SignFile( filePath, dn, fnCallBack );

Parameter	설명
filePath	전자서명 원문이 포함된 파일명. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label


 전자서명을 위한 파일 경로

Copy

서명 검증

p7 서명 검증 API

VerifyP7SignedDataWithFile( signeddata, retType, outputfilepath, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
retType	생성된 전자서명 데이터의 return type. 0: 결과값 string 반환 1 : 결과값을 outputfilepath에 저장
outputfilepath	생성된 전자서명 데이터를 저장할 파일 위치와 이름. retType이 1일 경우 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드
data	retType : 0 - 검증 후 획득된 원문데이터 retType : 1 - 검증 후 획득된 원문데이터를 저장한 파일 Name


 서명검증된 데이터를 저장할 파일 경로

인증서 서명 - PKCS #7 with noContent(파일)

전달된 file을 읽어서 해당 내용에 대한 p7 전자서명(원문포함하지 않은) 데이터 생성요청 API.

SignFileExcludeContent( filePath, dn, fnCallBack );

Parameter	설명
filePath	전자서명 원문이 포함된 파일명. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label


 전자서명을 위한 파일 경로

Copy

서명 검증

p7 서명 검증 API

VerifyExcludeContentP7SignedDataWithFile( filepath, signeddata, retType, outputfilepath, fnCallBack );

Parameter	설명
filepath	원문이 포함된 file 경로 [필수]
signeddata	원문을 p#7(원문 포함하지 않은)으로 서명한 서명데이터 [필수]
retType	생성된 전자서명 데이터의 return type. 0: 결과값 string 반환 1 : 결과값을 outputfilepath에 저장
outputfilepath	생성된 전자서명 데이터를 저장할 파일 위치와 이름. retType이 1일 경우 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드
data	retType : 0 - 검증 후 획득된 원문데이터 retType : 1 - 검증 후 획득된 원문데이터를 저장한 파일 Name
cert	전자서명에 사용된 인증서의 base64 인코딩된 데이터


 검증결과를 저장할 파일 경로

인증서 서명 - Multi PKCS #7(파일)

전달된 file(여러개의 파일)을 읽어서 해당 내용에 대한 p7 전자서명 데이터 생성요청 API.

SignMultiFile( jsonfilePath, dn, fnCallBack );

Parameter	설명
jsonfilePath	전자서명 원문이 포함된 파일명의 json타입의 데이터. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label


 첫번째 서명을 위한 파일 	
									
 두번째 서명을 위한 파일

Copy

서명 검증

p7 서명 검증 API

VerifyP7SignedDataWithFile( signeddata, retType, outputfilepath, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
retType	생성된 전자서명 데이터의 return type. 0: 결과값 string 반환 1 : 결과값을 outputfilepath에 저장
outputfilepath	생성된 전자서명 데이터를 저장할 파일 위치와 이름. retType이 1일 경우 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드
data	retType : 0 - 검증 후 획득된 원문데이터 retType : 1 - 검증 후 획득된 원문데이터를 저장한 파일 Name


 검증결과를 저장할 파일 경로

인증서 서명 - Multi PKCS #7 with noContent(파일)

전달된 file(여러개의 파일)을 읽어서 해당 내용에 대한 p7 전자서명(원문포함하지 않은) 데이터 생성요청 API.

SignMultiFileExcludeContent( jsonfilePath, dn, fnCallBack );

Parameter	설명
jsonfilePath	전자서명 원문이 포함된 파일명의 json타입의 데이터. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
jsonSignedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label


 첫번째 서명을 위한 파일 	
									
 두번째 서명을 위한 파일

Copy

서명 검증

p7 서명 검증 API

VerifyExcludeContentP7SignedDataWithFile( filepath, signeddata, retType, outputfilepath, fnCallBack );

Parameter	설명
filepath	원문이 포함된 file 경로 [필수]
signeddata	원문을 p#7(원문 포함하지 않은)으로 서명한 서명데이터 [필수]
retType	생성된 전자서명 데이터의 return type. 0: 결과값 string 반환 1 : 결과값을 outputfilepath에 저장
outputfilepath	생성된 전자서명 데이터를 저장할 파일 위치와 이름. retType이 1일 경우 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드
data	retType : 0 - 검증 후 획득된 원문데이터 retType : 1 - 검증 후 획득된 원문데이터를 저장한 파일 Name


 검증결과를 저장할 파일 경로

인증서 서명 - PKCS #7 & save file(파일)

전달된 file을 읽어서 해당 내용에 대한 p7 전자서명 데이터 생성 하고 결과 값을 파일로 저장하도록 요청하는 API.

SignFileEx( filePath, dn, retType, outputfilepath, fnCallBack );

Parameter	설명
filePath	전자서명 원문이 포함된 파일명. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
retType	생성된 전자서명 데이터의 return type. 0: 결과값 string 반환 1 : binary 결과값을 outputfilepath에 저장 2: base64 인코딩 결과값을 outputfilepath에 저장
outputfilepath	생성된 전자서명 데이터를 저장할 파일 위치와 이름. retType이 1일 경우 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	retType이 0 이면, 전자서명한 데이터로 base64인코딩된 데이터 retType이 0보다 크면, 전자서명 데이터를 저장한 파일 위치와 이름
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label


 서명을 위한 파일 경로 
									
 생성된 전자서명 데이터를 저장할 파일 경로

Copy

서명 검증

p7 서명 검증 API

VerifyP7SignedFileWithFileEx( signedDataType, signedfilepath, retType, outputfilepath, fnCallBack );

Parameter	설명
signedDataType	signedfilepath에 저장되어 있는 데이터의 인코딩 타입. 2 : binary, 5 : base64 인코딩 [필수]
signedfilepath	원문을 p#7으로 서명한 서명데이터가 포함된 파일명 [필수]
retType	생성된 전자서명 데이터의 return type. 0: 결과값 string 반환 1 : 결과값을 outputfilepath에 저장
outputfilepath	생성된 전자서명 데이터를 저장할 파일 위치와 이름. retType이 1일 경우 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드
data	retType : 0 - 검증 후 획득된 원문데이터 retType : 1 - 검증 후 획득된 원문데이터를 저장한 파일 Name
cert	전자서명에 사용된 인증서의 base64 인코딩된 데이터


 전자서명된 데이터를 저장한 파일 경로  
									
 서명 검증된 결과를 저장할 파일 경로

신원확인 - VerifyVID

vid 검증을 요청하는 API

VerifyVIDEx( ssn, fnCallBack );

Parameter	설명
ssn	vid 검증에 사용할 주민등록번호. 입력되지 않으면 내부에서 입력창 출력
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지


 주민등록번호 :

신원확인 - p#7 & VerifyVID

p#7 전자서명 생성과 vid 검증을 요청하는 API

SignDataNVerifyVID( data, dn, ssn, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열)을 json type으로 생성해서 전달. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음. default:null
ssn	vid 검증에 사용할 주민등록번호. 입력되지 않으면 내부에서 입력창 출력
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 base64인코딩된 데이터
certAttrs	전자서명에 사용된 인증서 정보
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label


 주민등록번호 :

Copy

서명 검증

p7 서명 검증 API

VerifySignData( signeddata, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
plaintext	검증 성공 : 원문데이터 반환. 검증 실패 : 원문데이터 미반환

신원확인 - p#7 with noConwithHash & VerifyVID

원문을 HashData로 전달하고, 원문 포함이 되지 않는 p7 전자서명 데이터 생성요청 과 vid 검증 요청하는 API

SignDataP7NVID_noConWithHash( jsondata, dn, hashAlgo, ssn, useAuthAttr, fnCallBack );

Parameter	설명
jsondata	원문을 hash 한 값을 포함한 json 타입의 data. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
hashAlgo	원문을 hash할때 사용한 알고리즘 . [필수]
ssn	vid 검증에 사용할 주민등록번호. 입력되지 않으면 내부에서 입력창 출력
useAuthAttr	PKCS#9 Auth Attribute 추가 여부 [필수] default는 false
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
certAttrs	전자서명에 사용된 인증서 정보
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label


 주민등록번호 :

Copy

서명 검증

Hashdata와 원문 없는 p#7 데이터 서명 검증 API

VerifySignData_noConWithHash( hashdata, signeddata, fnCallBack );

Parameter	설명
hashdata	서명에 사용된 base64 인코딩 된 hash 데이터 . [필수]
signeddata	hash 데이터를 p#7으로 서명한 원문이 포함되지 않은 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과 코드

신원확인 - Multi PKCS #7 & verifyvid

여러개의 데이터에 대한 p7 전자서명 생성관 vid 검증 요청 API

SignMultiDataNVerifyVID( jsondata, dn, ssn, fnCallBack );

Parameter	설명
jsondata	서명할 원문 데이터 (문자열)을 json type으로 생성해서 전달. [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음. default:null
ssn	vid 검증에 사용할 주민등록번호. 입력되지 않으면 내부에서 입력창 출력
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 json type 의 데이터
certAttrs	전자서명에 사용된 인증서 정보
curDevice	전자서명에 사용된 인증서가 위치한 device index
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label


 주민등록번호 :

Copy

서명 검증

p7 서명 검증 API

VerifySignData( signeddata, fnCallBack );

Parameter	설명
signeddata	원문을 p#7으로 서명한 서명데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
plaintext	검증 성공 : 원문데이터 반환. 검증 실패 : 원문데이터 미반환

신원확인 - Verify VID(like ActiveX)

VID 검증 요청 API(like ActiveX)

VerifyCertVID( dn, password, ssn, fnCallBack );

Parameter	설명
dn	인증서의 dn default:null
password	인증서 비밀번호. 입력되지 않으면 내부에서 입력창 출력
ssn	vid 검증에 사용할 주민등록번호. 입력되지 않으면 내부에서 입력창 출력
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 내용
resultMessage	결과 코드와 관련된 오류 메세지


 주민등록번호 :

암복호화 - encrypt with symmkey(like ActiveX)

symmkey를 가지고 암호화를 요청하는 API
내부적으로 입력된 key에 다른 값을 add해서 key로 사용(AxCrossCert에서 지원하던 기능처럼 지원되는 API)

EncryptDataWithSymmKey( encAlgo, symmkey, data, charset, fnCallBack );

Parameter	설명
encAlgo	암호화 알고리즘 . [필수]
symmkey	암호화에 입력될 대칭키 Value [필수]
data	서명할 원문 데이터 (문자열). [필수]
charset	원문데이터에 대한 한글 인코딩을 위한 charset default : UTF-8
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
encryptedData	생성된 암호화 데이터

Copy

복호화

복호화 API

DecryptDataWithSymmKey( encAlgo, symmkey, encrypteddata, fromcharset, tocharset, fnCallBack );

Parameter	설명
encAlgo	암호화 알고리즘 . [필수]
symmkey	암호화에 입력될 대칭키 Value [필수]
encrypteddata	암호화된 데이터 데이터 [필수]
fromcharset	암호화할때 사용한 인코딩 charset [필수]
tocharset	복호화 후에 사용할 인코딩 charset : 'utf-8'만 지원 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
decryptedData	생성된 복호화된 데이터

암복호화 - encryptdata

비대칭키 암호화를 요청하는 API

EncryptData( data, dn, kmcert, clrUCList, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음. default:null
kmcert	사용하지 않음
clrUCList	사용하지 않음
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
encryptedData	생성된 암호화 데이터

Copy

복호화

비 대칭키 복호화 API

DecryptData( encrypteddata, fnCallBack );

Parameter	설명
encrypteddata	암호화된 데이터 데이터 [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
rv	결과코드
plaintext	검증 성공 : 원문데이터 반환. 검증 실패 : 원문데이터 미반환

암복호화 - encryptdata

비대칭키 암호화를 요청하는 API

EncryptDataWithCert( data, cert, fnCallBack );

Parameter	설명
data	서명할 원문 데이터 (문자열). [필수]
cert	비대칭키 암호화에 사용할 인증서. 인증서 선택창은 출력되지 않음. [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
encryptedData	생성된 암호화 데이터

Copy

XML 전자 세금 계산서 - 세금계산서 전자서명

세금계산서 xml데이터에 대한 전자서명을 요청하는 API

MakeTaxXMLDSIG( data, dn, kmcert, fnCallBack );

Parameter	설명
data	서명할 xml 데이터 (문자열). [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
kmCert	전자서명에 사용된 인증서의 R 값을 암호할때 사용되며, 복호화 하고자 하는 측의 암호화 인증서.
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
b64RValue	전자서명에 사용된 인증서의 암호화된 R 값을 base64 인코딩 한 값 kmcert가 입력되지 않으면 생성되지 않음
certAttrs	전자서명에 사용된 인증서 정보
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

<TaxInvoice xmlns="urn:kr:or:kec:standard:Tax:ReusableAggregateBusinessInformationEntitySchemaModule:1:0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:kr:or:kec:standard:Tax:ReusableAggregateBusinessInformationEntitySchemaModule:1:0 http://www.kec.or.kr/standard/Tax/TaxInvoiceSchemaModule_1.0.xsd">
	<ExchangedDocument>
		<ID>123456789012345678901234</ID>
		<IssueDateTime>20090402104522</IssueDateTime>
		<ReferencedDocument>
			<ID>123456789012345678901234</ID>
		</ReferencedDocument>
	</ExchangedDocument>
	<TaxInvoiceDocument>
		<IssueID>200904020000000011111111</IssueID>
		<TypeCode>0101</TypeCode>
		<DescriptionText>abcde</DescriptionText>
		<IssueDateTime>20090402</IssueDateTime>
		<AmendmentStatusCode>01</AmendmentStatusCode>
		<PurposeCode>01</PurposeCode>
		<ReferencedImportDocument>
			<ID>123456789012345</ID>
			<ItemQuantity>123456</ItemQuantity>
			<AcceptablePeriod>
				<StartDateTime>20090402</StartDateTime>
				<EndDateTime>20090402</EndDateTime>
			</AcceptablePeriod>
		</ReferencedImportDocument>
	</TaxInvoiceDocument>
	<TaxInvoiceTradeSettlement>
		<InvoicerParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>1234567890123456789012345678901234567890123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<DefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</DefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</InvoicerParty>
		<InvoiceeParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
				<BusinessTypeCode>01</BusinessTypeCode>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<PrimaryDefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</PrimaryDefinedContact>
			<SecondaryDefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</SecondaryDefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</InvoiceeParty>
		<BrokerParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>1234567890123456789012345678901234567890123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<DefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</DefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</BrokerParty>
		<SpecifiedPaymentMeans>
			<TypeCode>10</TypeCode>
			<PaidAmount>123456789012345</PaidAmount>
		</SpecifiedPaymentMeans>
		<SpecifiedMonetarySummation>
			<ChargeTotalAmount>-12345678901235678</ChargeTotalAmount>
			<TaxTotalAmount>-12345678912345678</TaxTotalAmount>
			<GrandTotalAmount>-12345678901245678</GrandTotalAmount>
		</SpecifiedMonetarySummation>
	</TaxInvoiceTradeSettlement>
	<TaxInvoiceTradeLineItem>
		<SequenceNumeric>01</SequenceNumeric>
		<DescriptionText>1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</DescriptionText>
		<InvoiceAmount>1234567890123456</InvoiceAmount>
		<ChargeableUnitQuantity>999999999.99</ChargeableUnitQuantity>
		<InformationText>123456789012345678901234567890123456789012345678901234567890</InformationText>
		<NameText>1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</NameText>
		<PurchaseExpiryDateTime>20090402</PurchaseExpiryDateTime>
		<TotalTax>
			<CalculatedAmount>1234567890123456</CalculatedAmount>
		</TotalTax>
		<UnitPrice>
			<UnitAmount>12345678901235.99</UnitAmount>
		</UnitPrice>
	</TaxInvoiceTradeLineItem>
</TaxInvoice>

""

Copy

XML 전자 세금 계산서 - 멀티 세금계산서 전자서명

세금계산서 xml데이터(여러개)에 대한 전자서명을 요청하는 API

MakeTaxXMLDSIG( arrdata, dn, kmcert, fnCallBack );

Parameter	설명
arrdata	서명할 xml 데이터의 배열(문자열). [필수]
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
kmCert	전자서명에 사용된 인증서의 R 값을 암호할때 사용되며, 복호화 하고자 하는 측의 암호화 인증서.
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
b64RValue	전자서명에 사용된 인증서의 암호화된 R 값을 base64 인코딩 한 값 kmcert가 입력되지 않으면 생성되지 않음
certAttrs	전자서명에 사용된 인증서 정보
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

<TaxInvoice xmlns="urn:kr:or:kec:standard:Tax:ReusableAggregateBusinessInformationEntitySchemaModule:1:0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:kr:or:kec:standard:Tax:ReusableAggregateBusinessInformationEntitySchemaModule:1:0 http://www.kec.or.kr/standard/Tax/TaxInvoiceSchemaModule_1.0.xsd">
	<ExchangedDocument>
		<ID>123456789012345678901234</ID>
		<IssueDateTime>20090402104522</IssueDateTime>
		<ReferencedDocument>
			<ID>123456789012345678901234</ID>
		</ReferencedDocument>
	</ExchangedDocument>
	<TaxInvoiceDocument>
		<IssueID>200904020000000011111111</IssueID>
		<TypeCode>0101</TypeCode>
		<DescriptionText>abcde</DescriptionText>
		<IssueDateTime>20090402</IssueDateTime>
		<AmendmentStatusCode>01</AmendmentStatusCode>
		<PurposeCode>01</PurposeCode>
		<ReferencedImportDocument>
			<ID>123456789012345</ID>
			<ItemQuantity>123456</ItemQuantity>
			<AcceptablePeriod>
				<StartDateTime>20090402</StartDateTime>
				<EndDateTime>20090402</EndDateTime>
			</AcceptablePeriod>
		</ReferencedImportDocument>
	</TaxInvoiceDocument>
	<TaxInvoiceTradeSettlement>
		<InvoicerParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>1234567890123456789012345678901234567890123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<DefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</DefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</InvoicerParty>
		<InvoiceeParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
				<BusinessTypeCode>01</BusinessTypeCode>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<PrimaryDefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</PrimaryDefinedContact>
			<SecondaryDefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</SecondaryDefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</InvoiceeParty>
		<BrokerParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>1234567890123456789012345678901234567890123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<DefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</DefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</BrokerParty>
		<SpecifiedPaymentMeans>
			<TypeCode>10</TypeCode>
			<PaidAmount>123456789012345</PaidAmount>
		</SpecifiedPaymentMeans>
		<SpecifiedMonetarySummation>
			<ChargeTotalAmount>-12345678901235678</ChargeTotalAmount>
			<TaxTotalAmount>-12345678912345678</TaxTotalAmount>
			<GrandTotalAmount>-12345678901245678</GrandTotalAmount>
		</SpecifiedMonetarySummation>
	</TaxInvoiceTradeSettlement>
	<TaxInvoiceTradeLineItem>
		<SequenceNumeric>01</SequenceNumeric>
		<DescriptionText>1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</DescriptionText>
		<InvoiceAmount>1234567890123456</InvoiceAmount>
		<ChargeableUnitQuantity>999999999.99</ChargeableUnitQuantity>
		<InformationText>123456789012345678901234567890123456789012345678901234567890</InformationText>
		<NameText>1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</NameText>
		<PurchaseExpiryDateTime>20090402</PurchaseExpiryDateTime>
		<TotalTax>
			<CalculatedAmount>1234567890123456</CalculatedAmount>
		</TotalTax>
		<UnitPrice>
			<UnitAmount>12345678901235.99</UnitAmount>
		</UnitPrice>
	</TaxInvoiceTradeLineItem>
</TaxInvoice>

""

Copy

XML 전자 세금 계산서 - 세금계산서 전자서명

세금계산서 xml데이터에 대한 전자서명을 요청하는 API(like ActiveX)
GetUserDN 함수로 선택한 인증서의 dn 값을 Parameter로 지정하여 실행 시 추가 인증서 선택 없이 진행

MakeTaxXMLDSIGNonEnveloped( data, dn, password, fnCallBack );

Parameter	설명
data	서명할 xml 데이터 (문자열). [필수]
dn	서명에 사용될 인증서의 dn default:null
password	서명에 사용될 인증서의 비밀번호 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
certAttrs	전자서명에 사용된 인증서 정보
tokenLabel	보안토큰에 있는 인증서로 전자서명 했을 경우 보안토큰 label

<TaxInvoice xmlns="urn:kr:or:kec:standard:Tax:ReusableAggregateBusinessInformationEntitySchemaModule:1:0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:kr:or:kec:standard:Tax:ReusableAggregateBusinessInformationEntitySchemaModule:1:0 http://www.kec.or.kr/standard/Tax/TaxInvoiceSchemaModule_1.0.xsd">
	<ExchangedDocument>
		<ID>123456789012345678901234</ID>
		<IssueDateTime>20090402104522</IssueDateTime>
		<ReferencedDocument>
			<ID>123456789012345678901234</ID>
		</ReferencedDocument>
	</ExchangedDocument>
	<TaxInvoiceDocument>
		<IssueID>200904020000000011111111</IssueID>
		<TypeCode>0101</TypeCode>
		<DescriptionText>abcde</DescriptionText>
		<IssueDateTime>20090402</IssueDateTime>
		<AmendmentStatusCode>01</AmendmentStatusCode>
		<PurposeCode>01</PurposeCode>
		<ReferencedImportDocument>
			<ID>123456789012345</ID>
			<ItemQuantity>123456</ItemQuantity>
			<AcceptablePeriod>
				<StartDateTime>20090402</StartDateTime>
				<EndDateTime>20090402</EndDateTime>
			</AcceptablePeriod>
		</ReferencedImportDocument>
	</TaxInvoiceDocument>
	<TaxInvoiceTradeSettlement>
		<InvoicerParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>1234567890123456789012345678901234567890123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<DefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</DefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</InvoicerParty>
		<InvoiceeParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
				<BusinessTypeCode>01</BusinessTypeCode>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<PrimaryDefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</PrimaryDefinedContact>
			<SecondaryDefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</SecondaryDefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</InvoiceeParty>
		<BrokerParty>
			<ID>1234567890123</ID>
			<TypeCode>1234567890123456789012345678901234567890</TypeCode>
			<NameText>1234567890123456789012345678901234567890123456789012345678901234567890</NameText>
			<ClassificationCode>1234567890123456789012345678901234567890</ClassificationCode>
			<SpecifiedOrganization>
				<TaxRegistrationID>1234</TaxRegistrationID>
			</SpecifiedOrganization>
			<SpecifiedPerson>
				<NameText>123456789012345678901234567890</NameText>
			</SpecifiedPerson>
			<DefinedContact>
				<DepartmentNameText>1234567890123456789012345678901234567890</DepartmentNameText>
				<PersonNameText>123456789012345678901234567890</PersonNameText>
				<TelephoneCommunication>12345678901234567890</TelephoneCommunication>
				<URICommunication>1234567890123456789012345678901234567890</URICommunication>
			</DefinedContact>
			<SpecifiedAddress>
				<LineOneText>123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</LineOneText>
			</SpecifiedAddress>
		</BrokerParty>
		<SpecifiedPaymentMeans>
			<TypeCode>10</TypeCode>
			<PaidAmount>123456789012345</PaidAmount>
		</SpecifiedPaymentMeans>
		<SpecifiedMonetarySummation>
			<ChargeTotalAmount>-12345678901235678</ChargeTotalAmount>
			<TaxTotalAmount>-12345678912345678</TaxTotalAmount>
			<GrandTotalAmount>-12345678901245678</GrandTotalAmount>
		</SpecifiedMonetarySummation>
	</TaxInvoiceTradeSettlement>
	<TaxInvoiceTradeLineItem>
		<SequenceNumeric>01</SequenceNumeric>
		<DescriptionText>1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</DescriptionText>
		<InvoiceAmount>1234567890123456</InvoiceAmount>
		<ChargeableUnitQuantity>999999999.99</ChargeableUnitQuantity>
		<InformationText>123456789012345678901234567890123456789012345678901234567890</InformationText>
		<NameText>1234567890123456789012345678901234567890123456789012345678901234567890123456789012345678901234567890</NameText>
		<PurchaseExpiryDateTime>20090402</PurchaseExpiryDateTime>
		<TotalTax>
			<CalculatedAmount>1234567890123456</CalculatedAmount>
		</TotalTax>
		<UnitPrice>
			<UnitAmount>12345678901235.99</UnitAmount>
		</UnitPrice>
	</TaxInvoiceTradeLineItem>
</TaxInvoice>

""

Copy

본인확인 - 본인확인용 PKCS #7

본인확인용 ASN 데이터 생성 후 p7 전자서명 데이터 생성 요청 API.

SignPersonInfoReq( userAgreement, userAgreeInfo, dn, fnCallBack );

Parameter	설명
userAgreement	원문에 포함될 동의문구. [필수]
userAgreeInfo	사용자의 정보중 어떤 정보를 요청할지에 대한 옵션 [필수] '1000' : realName '0100' : gender '0010' : nationalInfo '0001' : birthDate '1100' : realName, gender
dn	서명에 사용될 인증서의 dn필터로, null이면 필터링 하지 않음 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
signedData	전자서명한 데이터로 base64인코딩된 데이터
certAttrs	전자서명에 사용된 인증서 정보

공인인증서 기반 본인확인서비스는 공인인증기관(한국전자인증, 금융결제원, 한국무역정보통신, 한국증권전산, 한국정보인증)에 저장된 가입자 정보를 본인확인을 목적으로 가입자가 제공을 요청한 '이용기관'에 게 제공하는 서비스로 '정보통신망이용촉진 등에 관한 법률' 및 '개인정보 보호법' 등에 따라 타인에게 제공 시 본인의 동의를 얻어야 하는 정보입니다.

이에 본인은 아래 내용과 같이 가입자 정보의 제공에 동의하며 주민등록번호 보호 수단인 본인의 공인인증서 활용을 신청합니다.

제 1 조 (제공할 가입자 정보 및 제공 대상)
① 본인의 성명, i-PIN 정보, 성별, 생년월일, 내/외국인정보
② 상기 제1조 1항의 가입자 정보는 본인이 전송을 요청한 '이용자'에게만 제공됩니다.

제 2 조 (제공의 목적)
이용기관에게 제공되는 가입자 정보는 인터넷상에서 주민등록번호 보호를 위한 본인확인 목적으로 제공됩니다.

제 3 조 (이용자의 가입자 정보 보유 및 이용기간)
본인의 가입자 정보는 제공받은 목적이 소멸되면 지체 없이 파기됩니다. 단, 이용자의 정책에 따라 일정기간 보관 후 파기될 수 있습니다. 공인인증서의 유효기간이 만료되거나 효력정지, 폐지 및 고객의 동의 없이는 이용자에게 정보를 제공하지 않으며, 이 경우 공인인증서 기반 본인확인서비스를 활용할 수 없습니다.

Copy

hash - Hash 데이터

입력된 데이터에 대한 Hash 요청 API.

MakeHash( arrData, hashAlgo, fnCallBack );

Parameter	설명
arrData	서명할 데이터의 배열(문자열). [필수]
hashAlgo	해쉬할때 사용할 알고리즘 . [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
hashValue	Hash된 데이터를 base64인코딩한 데이터의 배열

Copy

hash - File Hash 데이터

입력된 File경로에서 파일 데이터를 획득 한 후 Hash 요청 API.

MakeFileHash( arrData, hashAlgo, fnCallBack );

Parameter	설명
arrData	서명할 데이터가 포함된 파일의 경로에 대한 배열(문자열). [필수]
hashAlgo	hash에 사용할 알고리즘 . [필수]
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
hashValue	Hash된 데이터를 base64인코딩한 데이터의 배열

Copy

Mac Address 획득

자바스크립트가 실행되는 PC의 mac address 요청 API.

GetMacAddress( mode, fnCallBack );

Parameter	설명
mode	원하는 정보에 대한 설정 값 [필수] '0' : macaddress '1' : mac, ip '2' : ip '32' : 모든 디바이스 mac '33' : 모든 디바이스 mac, ip '34' : 모든 디바이스 ip
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
mac	획득된 mac 정보 mac과 ip의 구분은 ";"를 구분자로 사용 여러개의 mac정보가 있을 경우는 '\|'를 구분자로 사용

Copy

PC 시간 맞추기

타임서버로부터 시간을 획득해서 PC의 시간을 맞추는 API.

SetSystemTimeFromTimeServer( timeserverip, timeserverport, fnCallBack );

Parameter	설명
timeserverip	타입 서버 ip
timeserverport	타입 서버 port
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지

CA 서버 접속 체크

CA 서버로 접속이 정상적인지 확인하는 API.

CheckConnectToCAServer( dirip, dirport, fnCallBack );

Parameter	설명
dirip	LDAP 서버 ip
dirport	LDAP 서버 port
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지

인증서의 DN 값 획득

선택한 인증서의 DN 값 요청 API.

GetUserDN(fnCallBack);

Parameter	설명
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
userDN	선택한 인증서의 DN 값

Copy

R 값 획득

선택한 인증서의 R 값 요청 API.
GetUserDN 함수로 선택한 인증서의 dn 값을 Parameter로 지정하여 실행 시 추가 인증서 선택 없이 진행

GetRValueFromKey(dn, password, fnCallBack);

Parameter	설명
dn	인증서의 DN default:null
password	인증서의 비밀번호 default:null
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
RValue	선택한 인증서의 R 값

Copy

R 값 획득

PEM Type의 인증서를 획득하는 API.
GetUserDN 함수로 선택한 인증서의 dn 값을 Parameter로 지정하여 실행 시 추가 인증서 선택 없이 진행

getCertPEMType(dn, fnCallBack);

Parameter	설명
dn	인증서의 DN
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
PEMCert	입력한 DN의 PEM type 인증서

Copy

인증서의 경로 획득

인증서의 전체 경로를 획득하는 함수
GetUserDN 함수로 선택한 인증서의 경로를 인증서 선택 없이 반환

GetCertPath(fnCallBack);

Parameter	설명
fnCallBack	기능 완료시 호출되는 callback 함수. [필수]

Return	설명
resultCode	결과 코드
resultMessage	결과 코드와 관련된 오류 메세지
certPath	GetUserDN을 통해 선택한 인증서의 경로

Copy

CROSSCERT 웹 표준 모듈 기술 문서

기본 HTML 설정

CROSSCERT 웹 표준 모듈 기술 문서 - Value

Value

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 발급

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

암호화용 인증서 발급

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 간편 발급 - 개인

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 간편 발급 - 사업자

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 갱신

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 갱신

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 폐지

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 효력정지

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 키쌍 체크

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 관리

CROSSCERT 웹 표준 모듈 기술 문서 - 인증서 관리 API

인증서 관리

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #1

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #1 (like ActiveX)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7(like ActiveX)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7(No Content)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7(No Content)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7(with Hashdata)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7 & R 값 획득 (with Hashdata)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - Multi PKCS #1

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - Multi PKCS #7

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - Multi PKCS #7 & R 값 획득

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - Multi PKCS #7 with noCotent

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - 1. p#7 & VerifyVID 2. p#7(withHash)

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - 1. p#7 2. p#7(withHash)

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7(with Hashdata)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7(파일)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - PKCS #7 with noContent(파일)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - Multi PKCS #7(파일)

서명 검증

CROSSCERT 웹 표준 모듈 기술 문서 - 전자서명 API

인증서 서명 - Multi PKCS #7 with noContent(파일)