xecure.crypto
Class SplitFileSign

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

이 클래스는 전자서명된 화일을 분리/병합 한다.
서명된 화일에서 원본화일과 서명자 인증서를 분리할 수 있다.
분리된 서명문은 그 자체로는 검증이 불가능하다.
따라서 분리된 화일서명문을 검증할 때에는 원본화일과 서명자 인증서를 가지고 있어야 한다.
일반 서명문과 달리 FileMultiSignVerifier를 사용하면 분리된 상태로 검증이 가능하다.
단일서명/복수서명 모두 적용 가능.

Since:
6.0 v130

Field Summary
static int CERT_OPT_DER
          서명자 인증서를 DER형식으로 분리함
static int CERT_OPT_NONE
          서명자 인증서를 분리하지 않음
static int CERT_OPT_PEM
          서명자 인증서를 PEM형식으로 분리함
 
Constructor Summary
SplitFileSign(XecureConfig config)
          인스턴스를 생성한다.
생성된 인스턴스로 여러번 분리/병합을 수행할 수 있다.
 
Method Summary
 byte[][] getDerCertificates()
          분리된 서명자 인증서(DER)를 리턴한다.
서명문에 포함된 서명자 인증서 개수만큼의 byte[][] 로 리턴된다.
서명 분리시 CERT_OPT_DER 옵션을 사용해야 한다.
 int getLastError()
          가장 최근 발생한 에러코드를 리턴한다.
최근 작업이 성공한 경우 마지막으로 발생한 에러코드 리턴.
 java.lang.String getLastErrorMsg()
          가장 최근 발생한 에러 메시지를 리턴한다.
최근 작업이 성공한 경우 마지막으로 발생한 에러메시지 리턴.
 int getNumberOfCertificates()
          분리된 서명자 인증서 개수를 리턴한다.
 java.lang.String getOrgFileName(byte[] splitedFileSignData)
          서명될 당시의 원본화일의 화일명을 얻는다.
 java.util.Date getOrgTime(byte[] splitedFileSignData)
          서명될 당시의 원본화일의 시간을 얻는다.
 java.lang.String[] getPemCertificates()
          분리된 서명자 인증서(PEM)를 리턴한다.
서명문에 포함된 서명자 인증서 개수만큼의 String[] 로 리턴된다.
서명 분리시 CERT_OPT_PEM 옵션을 사용해야 한다.
 int merge(java.lang.String fileOutPath, java.lang.String contentFilePath, byte[] splitedFileSign, byte[][] certDer)
          분리된 화일서명을 병합하여 화일로 저장한다.
 int merge(java.lang.String fileOutPath, java.lang.String contentFilePath, byte[] splitedFileSign, java.lang.String[] certPem)
          분리된 화일서명을 병합하여 화일로 저장한다.
 byte[] mergeSign(byte[] splitedFileSign, byte[][] certDer)
          원본화일을 제외한 순수 서명문과 서명자 인증서(DER)를 병합한다.
 byte[] mergeSign(byte[] splitedFileSign, java.lang.String[] certPem)
          원본화일을 제외한 순수 서명문과 서명자 인증서(PEM)를 병합한다.
 byte[] split(java.lang.String fileInPath, int certOption)
          서명된 화일을 분리한다.
 byte[] split(java.lang.String fileInPath, java.lang.String contentFilePath, int certOption)
          서명된 화일을 분리한다.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

CERT_OPT_NONE

public static final int CERT_OPT_NONE
서명자 인증서를 분리하지 않음

CERT_OPT_PEM

public static final int CERT_OPT_PEM
서명자 인증서를 PEM형식으로 분리함

CERT_OPT_DER

public static final int CERT_OPT_DER
서명자 인증서를 DER형식으로 분리함
Constructor Detail

SplitFileSign

public SplitFileSign(XecureConfig config)
인스턴스를 생성한다.
생성된 인스턴스로 여러번 분리/병합을 수행할 수 있다.
Parameters:
config - XecureConfig인스턴스
Since:
6.0 v130
Method Detail

split

public byte[] split(java.lang.String fileInPath,
                    int certOption)
서명된 화일을 분리한다. 원본화일은 저장하지 않는다.
분리되고난 서명문을 리턴값으로 받을 수 있다.
서명자 인증서는 본 메소드의 성공적인 실행 후 별도의 메소드를 이용하여 얻는다.
PEM인증서: getPemCertificates()
DER인증서: getDerCertificates()
Parameters:
fileInPath - 분리할 화일의 경로명
certOption - 인증서 분리 옵션: 인증서 분리 여부 및 형식 지정
    CERT_OPT_NONE
    CERT_OPT_DER
    CERT_OPT_PEM
Returns:
byte[] 분리된 서명문(DER encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getNumberOfCertificates(), getPemCertificates(), getDerCertificates(), getLastError(), getLastErrorMsg()

split

public byte[] split(java.lang.String fileInPath,
                    java.lang.String contentFilePath,
                    int certOption)
서명된 화일을 분리한다. 원본화일을 저장한다.
분리되고난 서명문을 리턴값으로 받을 수 있다.
서명자 인증서는 본 메소드의 성공적인 실행 후 별도의 메소드를 이용하여 얻는다.
PEM인증서: getPemCertificates()
DER인증서: getDerCertificates()
FileMultiSignVerifier를 이용하여 병합하지 않고 검증할 수 있다.
Parameters:
fileInPath - 분리할 화일의 경로명
contentFilePath - 저장될 원본화일 경로명
certOption - 인증서 분리 옵션: 인증서 분리 여부 및 형식 지정
    CERT_OPT_NONE
    CERT_OPT_DER
    CERT_OPT_PEM
Returns:
byte[] 분리된 서명문 (DER encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getNumberOfCertificates(), getPemCertificates(), getDerCertificates(), getLastError(), getLastErrorMsg()

mergeSign

public byte[] mergeSign(byte[] splitedFileSign,
                        byte[][] certDer)
원본화일을 제외한 순수 서명문과 서명자 인증서(DER)를 병합한다.
Parameters:
splitedFileSign - 분리된 순수 서명문 (DER encoded)
certDer - 병합할 인증서 (DER), 복수개의 인증서를 병합할 수 있도록 byte[][] 입력.
    ex) byte[][] certs=new byte[2][]; certs[0]=cert1; certs[1]=cert2;
Returns:
병합된 서명문 (DER encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

mergeSign

public byte[] mergeSign(byte[] splitedFileSign,
                        java.lang.String[] certPem)
원본화일을 제외한 순수 서명문과 서명자 인증서(PEM)를 병합한다.
Parameters:
splitedFileSign - 분리된 순수 서명문 (DER encoded)
certPem - 병합할 인증서 (PEM), 복수개의 인증서를 병합할 수 있도록 String[] 입력.
    ex) String[] certs=new String[2]; certs[0]=cert1; certs[1]=cert2;
Returns:
병합된 서명문 (DER encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

merge

public int merge(java.lang.String fileOutPath,
                 java.lang.String contentFilePath,
                 byte[] splitedFileSign,
                 byte[][] certDer)
분리된 화일서명을 병합하여 화일로 저장한다.
Parameters:
fileOutPath - 저장될 화일서명의 경로명
contentFilePath - 원본화일의 경로명
splitedFileSign - 분리된 순수 서명문 (DER encoded)
certDer - 병합할 인증서 (DER), 복수개의 인증서를 병합할 수 있도록 byte[][] 입력.
    ex) byte[][] certs=new byte[2][]; certs[0]=cert1; certs[1]=cert2;
Returns:
success: 0, fail: error code
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

merge

public int merge(java.lang.String fileOutPath,
                 java.lang.String contentFilePath,
                 byte[] splitedFileSign,
                 java.lang.String[] certPem)
분리된 화일서명을 병합하여 화일로 저장한다.
Parameters:
fileOutPath - 저장될 화일서명의 경로명
contentFilePath - 원본화일의 경로명
splitedFileSign - 분리된 순수 서명문 (DER encoded)
certPem - 병합할 인증서 (PEM), 복수개의 인증서를 병합할 수 있도록 String[] 입력.
    ex) String[] certs=new String[2]; certs[0]=cert1; certs[1]=cert2;
Returns:
success: 0, fail: error code
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

getNumberOfCertificates

public int getNumberOfCertificates()
분리된 서명자 인증서 개수를 리턴한다.
Returns:
int 인증서 개수
Since:
6.0 v130

getPemCertificates

public java.lang.String[] getPemCertificates()
분리된 서명자 인증서(PEM)를 리턴한다.
서명문에 포함된 서명자 인증서 개수만큼의 String[] 로 리턴된다.
서명 분리시 CERT_OPT_PEM 옵션을 사용해야 한다.
Returns:
String[] 분리된 서명자 인증서, 에러 또는 없는 경우 null
Since:
6.0 v130

getDerCertificates

public byte[][] getDerCertificates()
분리된 서명자 인증서(DER)를 리턴한다.
서명문에 포함된 서명자 인증서 개수만큼의 byte[][] 로 리턴된다.
서명 분리시 CERT_OPT_DER 옵션을 사용해야 한다.
Returns:
byte[][] 분리된 서명자 인증서, 에러 또는 없는 경우 null
Since:
6.0 v130

getLastError

public int getLastError()
가장 최근 발생한 에러코드를 리턴한다.
최근 작업이 성공한 경우 마지막으로 발생한 에러코드 리턴.
Returns:
error code
Since:
6.0 v130

getLastErrorMsg

public java.lang.String getLastErrorMsg()
가장 최근 발생한 에러 메시지를 리턴한다.
최근 작업이 성공한 경우 마지막으로 발생한 에러메시지 리턴.
Returns:
error message
Since:
6.0 v130

getOrgFileName

public java.lang.String getOrgFileName(byte[] splitedFileSignData)
서명될 당시의 원본화일의 화일명을 얻는다.
Parameters:
splitedFileSignData - 분리된 순수 서명문 (DER encoded)
Returns:
화일명, 에러시 null
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

getOrgTime

public java.util.Date getOrgTime(byte[] splitedFileSignData)
서명될 당시의 원본화일의 시간을 얻는다.
Parameters:
splitedFileSignData - 분리된 순수 서명문 (DER encoded)
Returns:
Date 화일 시간, 에러시 null
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()