xecure.crypto
Class SplitSign

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

이 클래스는 전자서명된 메시지를 분리/병합 한다.
서명문에서 컨텐트와 서명자 인증서를 분리할 수 있다.
분리된 서명문은 그 자체로는 검증이 불가능하다.
따라서 분리된 서명문을 검증할 때에는 분리할때 얻은 컨텐트와 서명자 인증서를 반드시 병합시켜야 한다.
단일서명/복수서명 모두 적용 가능하다.

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
SplitSign(XecureConfig config)
          인스턴스를 생성한다.
생성된 인스턴스로 여러번 분리/병합을 수행할 수 있다.
 
Method Summary
 byte[] getContent()
          분리된 컨텐트를 리턴한다.
서명 분리시 컨텐트 분리 플래그를 true로 해야 한다.
 byte[][] getDerCertificates()
          분리된 서명자 인증서(DER)를 리턴한다.
서명문에 포함된 서명자 인증서 개수만큼의 byte[][] 로 리턴된다.
서명 분리시 CERT_OPT_DER 옵션을 사용해야 한다.
 int getLastError()
          가장 최근 발생한 에러코드를 리턴한다.
 java.lang.String getLastErrorMsg()
          가장 최근 발생한 에러 메시지를 리턴한다.
 int getNumberOfCertificates()
          분리된 서명자 인증서 개수를 리턴한다.
 java.lang.String[] getPemCertificates()
          분리된 서명자 인증서(PEM)를 리턴한다.
서명문에 포함된 서명자 인증서 개수만큼의 String[] 로 리턴된다.
서명 분리시 CERT_OPT_PEM 옵션을 사용해야 한다.
 java.lang.String merge(java.lang.String splitedMsg, byte[] content)
          분리된 서명문에 컨텐트를 병합한다.
 java.lang.String merge(java.lang.String splitedMsg, byte[][] certDer)
          분리된 서명문에 서명자 인증서(DER)를 병합한다.
 java.lang.String merge(java.lang.String splitedMsg, byte[] content, byte[][] certDer)
          분리된 서명문에 컨텐트와 서명자 인증서(DER)를 병합한다.
 java.lang.String merge(java.lang.String splitedMsg, byte[] content, java.lang.String[] certPem)
          분리된 서명문에 컨텐트와 서명자 인증서(PEM)를 병합한다.
 java.lang.String merge(java.lang.String splitedMsg, java.lang.String[] certPem)
          분리된 서명문에 서명자 인증서(PEM)를 병합한다.
 java.lang.String split(java.lang.String signedMsg, boolean splitContent, int certOption)
          서명문을 분리한다.
분리되고난 서명문을 리턴값으로 받을 수 있다.
서명자 인증서와 컨텐트는 본 메소드의 성공적인 실행 후 별도의 메소드를 이용하여 얻는다.
컨텐트 : getContent()
PEM인증서: getPemCertificates()
DER인증서: getDerCertificates()
 
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

SplitSign

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

split

public java.lang.String split(java.lang.String signedMsg,
                              boolean splitContent,
                              int certOption)
서명문을 분리한다.
분리되고난 서명문을 리턴값으로 받을 수 있다.
서명자 인증서와 컨텐트는 본 메소드의 성공적인 실행 후 별도의 메소드를 이용하여 얻는다.
컨텐트 : getContent()
PEM인증서: getPemCertificates()
DER인증서: getDerCertificates()
Parameters:
signedMsg - 서명문 (HEXA encoded)
splitContent - 컨텐트 분리여부: false인경우 컨텐트를 분리하지 않는다.
certOption - 인증서 분리 옵션: 인증서 분리 여부 및 형식 지정
    CERT_OPT_NONE
    CERT_OPT_DER
    CERT_OPT_PEM
Returns:
String 분리된 서명문 (HEXA encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getContent(), getNumberOfCertificates(), getPemCertificates(), getDerCertificates(), getLastError(), getLastErrorMsg()

merge

public java.lang.String merge(java.lang.String splitedMsg,
                              byte[] content)
분리된 서명문에 컨텐트를 병합한다.
Parameters:
splitedMsg - 분리된 서명문 (HEXA encoded)
content - 병합할 컨텐트
Returns:
병합된 서명문 (HEXA encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

merge

public java.lang.String merge(java.lang.String splitedMsg,
                              byte[][] certDer)
분리된 서명문에 서명자 인증서(DER)를 병합한다.
Parameters:
splitedMsg - 분리된 서명문 (HEXA encoded)
certDer - 병합할 인증서 (DER), 복수개의 인증서를 병합할 수 있도록 byte[][] 입력.
    ex) byte[][] certs=new byte[2][]; certs[0]=cert1; certs[1]=cert2;
Returns:
병합된 서명문 (HEXA encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

merge

public java.lang.String merge(java.lang.String splitedMsg,
                              java.lang.String[] certPem)
분리된 서명문에 서명자 인증서(PEM)를 병합한다.
Parameters:
splitedMsg - 분리된 서명문 (HEXA encoded)
certPem - 병합할 인증서 (PEM), 복수개의 인증서를 병합할 수 있도록 String[] 입력.
    ex) String[] certs=new String[2]; certs[0]=cert1; certs[1]=cert2;
Returns:
병합된 서명문 (HEXA encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

merge

public java.lang.String merge(java.lang.String splitedMsg,
                              byte[] content,
                              byte[][] certDer)
분리된 서명문에 컨텐트와 서명자 인증서(DER)를 병합한다.
Parameters:
splitedMsg - 분리된 서명문 (HEXA encoded)
content - 병합할 컨텐트
certDer - 병합할 인증서 (DER), 복수개의 인증서를 병합할 수 있도록 byte[][] 입력.
    ex) byte[][] certs=new byte[2][]; certs[0]=cert1; certs[1]=cert2;
Returns:
병합된 서명문 (HEXA encoded), 에러시 null 리턴
Since:
6.0 v130
See Also:
getLastError(), getLastErrorMsg()

merge

public java.lang.String merge(java.lang.String splitedMsg,
                              byte[] content,
                              java.lang.String[] certPem)
분리된 서명문에 컨텐트와 서명자 인증서(PEM)를 병합한다.
Parameters:
splitedMsg - 분리된 서명문 (HEXA encoded)
content - 병합할 컨텐트
certPem - 병합할 인증서 (PEM), 복수개의 인증서를 병합할 수 있도록 String[] 입력.
    ex) String[] certs=new String[2]; certs[0]=cert1; certs[1]=cert2;
Returns:
병합된 서명문 (HEXA encoded), 에러시 null 리턴
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

getContent

public byte[] getContent()
분리된 컨텐트를 리턴한다.
서명 분리시 컨텐트 분리 플래그를 true로 해야 한다.
Returns:
분리된 컨텐트, 에러 또는 없는 경우 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