xecure.crypto
Class FileMultiSignVerifier

java.lang.Object
  |
  +--xecure.crypto.FileMultiSignVerifier
public class FileMultiSignVerifier
extends java.lang.Object

이 클래스는 전자서명된 화일을 해석하고 검증한다.

Since:
6.0 v100

Constructor Summary
FileMultiSignVerifier(XecureConfig config, byte[] splitedSign, java.lang.String contentFileName, byte[][] certDer)
          FileMultiSignVerifier object 를 생성하고 분리된 화일서명에 대한 해석및 검증을 수행한다.
FileMultiSignVerifier(XecureConfig config, byte[] splitedSign, java.lang.String contentFileName, java.lang.String[] certPem)
          FileMultiSignVerifier object 를 생성하고 분리된 화일서명에 대한 해석및 검증을 수행한다.
FileMultiSignVerifier(XecureConfig config, java.lang.String fileName)
          FileMultiSignVerifier object 를 생성하고 동시에 전자서명된 화일에 대한 해석및 검증을 수행한다.
인증서 검증은 수행하지 않으므로 별도로 검증해야 한다.
getLastError() 가 0 이 아닌 값을 리턴할 경우에는 서명된 메시지에 문제가 있는 경우이다.
getLastError() 가 0 을 리턴할 경우 서명자 인증서, 서명에 사용된 문서 를 얻을 수 있다.
 
Method Summary
 int getLastError()
          전자서명 검증시 에러가 발생할 경우 에러코드가 리턴된다.
 java.lang.String getLastErrorMsg()
          전자서명 검증시 에러가 발생한 경우 에러 메시지를 얻을 수 있다.
 int getNumberOfSigner()
          멀티서명자의 수를 리턴한다.
 java.util.Date getOrgFileDate()
          서명된 화일의 시간 정보를 리턴한다.
 long getOrgFileLength()
          서명된 화일의 원시 화일 길이를 리턴한다.
 java.lang.String getOrgFileName()
          서명된 화일의 원시 화일명을 리턴한다.
 Certificate getSignerCertificate(int index)
          멀티서명자의 인증서를 리턴한다.
 java.lang.String getSignerCertificateS(int index)
          멀티서명자의 인증서를 PEM 형식의 스트링으로 리턴한다.
 java.lang.String getSignerSubject(int index)
          멀티서명자의 subject DN 을 리턴한다.
 java.lang.String getSignTimeMsg(int index)
          멀티서명의 서명 시간을 리턴한다.
 java.lang.String getVerifiedMsg_Text()
          서명되기전 Text 문서 원본을 리턴한다.
 byte[] getVerifiedMsg()
          서명되기전 Binary 문서 원본을 리턴한다.
 int read(byte[] buf)
          서명된 화일의 내용을 읽는다.
 int read(byte[] buf, int off, int len)
          서명된 화일의 내용을 읽는다.
 void resetRead()
          서명된 화일을 읽기 위한 초기화 작업을 수행한다.
처음부터 다시 읽는 경우 사용할 수 있다.
 boolean saveFile(boolean overwrite)
          서명된 화일의 내용을 저장한다.
 boolean saveFile(java.lang.String fileName, boolean overwrite)
          서명된 화일의 내용을 저장한다.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

FileMultiSignVerifier

public FileMultiSignVerifier(XecureConfig config,
                             byte[] splitedSign,
                             java.lang.String contentFileName,
                             byte[][] certDer)
FileMultiSignVerifier object 를 생성하고 분리된 화일서명에 대한 해석및 검증을 수행한다.
Parameters:
config - XecureConfig object
splitedSign - 분리된 순수 서명문 (DER encoded)
contentFileName - 원본화일의 경로명
certDer - 병합할 인증서 (DER), 복수개의 인증서를 병합할 수 있도록 byte[][] 입력.
    ex) byte[][] certs=new byte[2][]; certs[0]=cert1; certs[1]=cert2;
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

FileMultiSignVerifier

public FileMultiSignVerifier(XecureConfig config,
                             byte[] splitedSign,
                             java.lang.String contentFileName,
                             java.lang.String[] certPem)
FileMultiSignVerifier object 를 생성하고 분리된 화일서명에 대한 해석및 검증을 수행한다.
Parameters:
config - XecureConfig object
splitedSign - 분리된 순수 서명문 (DER encoded)
contentFileName - 원본화일의 경로명
certPem - 병합할 인증서 (PEM), 복수개의 인증서를 병합할 수 있도록 String[] 입력.
    ex) String[] certs=new String[2]; certs[0]=cert1; certs[1]=cert2;
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

FileMultiSignVerifier

public FileMultiSignVerifier(XecureConfig config,
                             java.lang.String fileName)
FileMultiSignVerifier object 를 생성하고 동시에 전자서명된 화일에 대한 해석및 검증을 수행한다.
인증서 검증은 수행하지 않으므로 별도로 검증해야 한다.
getLastError() 가 0 이 아닌 값을 리턴할 경우에는 서명된 메시지에 문제가 있는 경우이다.
getLastError() 가 0 을 리턴할 경우 서명자 인증서, 서명에 사용된 문서 를 얻을 수 있다.
Parameters:
config - XecureConfig object
fileName - 전자서명된 화일 경로명
Since:
6.0 v100
Method Detail

getLastError

public int getLastError()
전자서명 검증시 에러가 발생할 경우 에러코드가 리턴된다.
-1001 : Library Initialize error
-1002 : Signed Message Parsing Error
-1003 : 서명자 인증서가 폐기되어 있음
-1004 : 인증서 검증 에러
-1005 : 서명자 인증서 유효기간 만료
-1006 : 인증기관 인증서 유효기간 만료
-1007 : 잘못된 인증서
-1008 : 서명자 인증서 효력정지 상태
-1009 : 알 수 없는 에러
-1201 : 공인등록기관 연결 실패
-1202 : 공인등록기관 메모리 에러
-1203 : 공인등록기관 처리 실패
-2001 : 사설등록기관 호스트명 에러
-2002 : 사설등록기관 소켓 생성 실패
-2003 : 사설등록기관 소켓 연결 실패
-2004 : 사설등록기관 소켓 데이타 읽기 실패
-2005 : 사설등록기관 소켓 데이타 쓰기 실패
-2006 : 사설등록기관 RSA 암호 실패
-2007 : 사설등록기관 RSA 복호 실패
-2008 : 사설등록기관 내부 오류
-2009 : 사설등록기관 잘못된 메시지
-2011 : 사설등록기관 서버 인증서 읽기 오류
-2012 : 사설등록기관 서버 개인키 읽기 오류
-2013 : 사설등록기관 인증서 읽기 오류
-2014 : 사설등록기관 서버 인증서 형식 오류
-2015 : 사설등록기관 서버 개인키 읽기 오류
-2016 : 사설등록기관 인증서 읽기 오류
-2017 : 사설등록기관 프로토콜 오류
-2018 : 사설등록기관 전달 인수 부족 오류
-2019 : 사설등록기관 인증요구서 생성 오류
-2020 : 사설등록기관 잘못된 인증기관 메시지 오류
-2021 : 사설등록기관 인증 서비스 요청 실패
-2025 : 사설등록기관 메시지 암호 실패
-2026 : 사설등록기관 메시지 복호 실패
-3010 : 서버 Xecure 설정 파일 오류
Returns:
error code
Since:
6.0 v100

getLastErrorMsg

public java.lang.String getLastErrorMsg()
전자서명 검증시 에러가 발생한 경우 에러 메시지를 얻을 수 있다.
Returns:
error message
Since:
6.0 v100

getSignerCertificate

public Certificate getSignerCertificate(int index)
멀티서명자의 인증서를 리턴한다.
Parameters:
index - 서명자의 인덱스를 나타냄 (0부터 시작)
Returns:
signer Certificate object
Since:
6.0 v100

getSignerCertificateS

public java.lang.String getSignerCertificateS(int index)
멀티서명자의 인증서를 PEM 형식의 스트링으로 리턴한다.
Parameters:
index - 서명자의 인덱스를 나타냄 (0부터 시작)
Returns:
signer PEM
Since:
6.0 v100

getSignerSubject

public java.lang.String getSignerSubject(int index)
멀티서명자의 subject DN 을 리턴한다.
Parameters:
index - 서명자의 인덱스를 나타냄 (0부터 시작)
Returns:
signer Subject DN
Since:
6.0 v100

getSignTimeMsg

public java.lang.String getSignTimeMsg(int index)
멀티서명의 서명 시간을 리턴한다.
Parameters:
index - 서명자의 인덱스를 나타냄 (0부터 시작)
Returns:
signer signedAttr_signTime
Since:
6.0 v110

getNumberOfSigner

public int getNumberOfSigner()
멀티서명자의 수를 리턴한다.
Returns:
nSigner
Since:
6.0 v100

getVerifiedMsg

public byte[] getVerifiedMsg()
서명되기전 Binary 문서 원본을 리턴한다.
Returns:
verified message
Since:
6.0 v100

getVerifiedMsg_Text

public java.lang.String getVerifiedMsg_Text()
서명되기전 Text 문서 원본을 리턴한다. 한글이 들어있는 텍스트 문서의 경우 반드시 이 함수를 호출해야 한다.
Returns:
verified message text
Since:
6.0 v100

getOrgFileName

public java.lang.String getOrgFileName()
                                throws java.io.IOException
서명된 화일의 원시 화일명을 리턴한다.
Returns:
화일명, 에러시 null
Since:
6.0 v120

getOrgFileLength

public long getOrgFileLength()
                      throws java.io.IOException
서명된 화일의 원시 화일 길이를 리턴한다.
Returns:
화일명 , 에러시 -1
Since:
6.0 v120

getOrgFileDate

public java.util.Date getOrgFileDate()
                              throws java.io.IOException
서명된 화일의 시간 정보를 리턴한다.
Returns:
화일 시간
Since:
6.0 v120

read

public int read(byte[] buf)
         throws java.io.IOException
서명된 화일의 내용을 읽는다.
Parameters:
buf - : the buffer into which the data is read.
Returns:
the total number of bytes read into the buffer, or -1 if there is no more data because the end of the file has been reached.
Throws:
java.io.IOException -  
Since:
6.0 v120

read

public int read(byte[] buf,
                int off,
                int len)
         throws java.io.IOException
서명된 화일의 내용을 읽는다.
Parameters:
buf - : the buffer into which the data is read.
off - : the start offset of the data.
len - : the maximum number of bytes read.
Returns:
the total number of bytes read into the buffer, or -1 if there is no more data because the end of the file has been reached.
Throws:
java.io.IOException -  
Since:
6.0 v120

saveFile

public boolean saveFile(boolean overwrite)
                 throws java.io.IOException
서명된 화일의 내용을 저장한다.
Parameters:
overwrite - 덮어쓰기 여부
Returns:
성공시 true, 실패시 false
Throws:
java.io.IOException -  
Since:
6.0 v120

saveFile

public boolean saveFile(java.lang.String fileName,
                        boolean overwrite)
                 throws java.io.IOException
서명된 화일의 내용을 저장한다.
Parameters:
fileName - 저장할 화일이름
overwrite - 덮어쓰기 여부
Returns:
성공시 true, 실패시 false(화일 크기가 잘못된 경우)
Throws:
java.io.IOException -  
Since:
6.0 v120

resetRead

public void resetRead()
               throws java.io.IOException
서명된 화일을 읽기 위한 초기화 작업을 수행한다.
처음부터 다시 읽는 경우 사용할 수 있다.
Throws:
java.io.IOException -  
Since:
6.0 v120