SignedData (JCAOS V1.4.4.0

Overview

Package

Class

Tree

Deprecated

Index

Help

JCaosLib
V1.4.4.0

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.dreamsecurity.jcaos.cms
Class SignedData

java.lang.Object
  com.dreamsecurity.jcaos.cms.SignedData

public class SignedData
extends java.lang.Object

서명 메시지(SignedData)를 처리하기 위한 클래스이다.

서명 메시지는 서명자의 개인키를 이용하여 서명값을 생성함으로서 메시지의 인증과 무결성을 제공하는 보안 메시지 형식이다.

해당 클래스에서는 RFC3852에서 정의하는 SignedData와 PKCS#7에서 정의하는 SignedData를 모두 지원한다.

서명 메시지에 대한 자세한 정보는 "RFC3852" 또는 "PKCS#7"에서 확인할 수 있다.

서명 메시지의 ASN.1 포맷은 다음과 같다.

 RFC3852에서 정의하는 SignedData 형식 :
  
 SignedData ::= SEQUENCE {
 		version              CMSVersion,
		digestAlgorithms     DigestAlgorithmIdentifiers,
		encapContentInfo     EncapsulatedContentInfo,
		certificates     [0] IMPLICIT CertificateSet OPTIONAL,
		crls             [1] IMPLICIT RevocationInfoChoices OPTIONAL,
		signerInfos          SignerInfos 
 }
         
 PKCS#7에서 정의하는 SignedData 형식 :
  
 SignedData ::= SEQUENCE {
		version               Version,
		digestAlgorithms      DigestAlgorithmIdentifiers,
		contentInfo           ContentInfo,
		certificates      [0] IMPLICIT ExtendedCertificatesAndCertificates OPTIONAL,
		crls              [1] IMPLICIT CertificateRevocationLists OPTIONAL,
		signerInfos           SignerInfos }

 서명 메시지 객체 생성 예제 :
  
 byte[] signData = <서명 메시지 읽기>
 SignedData signedData = SignedData.getInstance(signData);

Since:: 1.0.0.0

Method Summary
`void`	`addSignerCerts(X509Certificate cert)` 서명 메시지안에 서명자의 인증서가 포함되어있지 않은 경우에 서명 값 검증을 위해서 필요한 서명자의 인증서를 지정한다.
`java.util.ArrayList`	`getCertificates()` 서명 메시지에 포함되어있는 인증서 목록을 획득한다.
`byte[]`	`getContent()` 서명한 원본 메시지를 획득한다.
`java.lang.String`	`getContentType()` 서명한 원본 메시지의 종류를 확인한다.
`java.util.ArrayList`	`getDigestAlgorithms()` 서명 메시지의 다이제스트 알고리즘 목록을 획득한다.
`byte[]`	`getEncoded()` DER 인코딩된 서명 메시지를 획득한다.
`void`	`getEncoded(java.io.OutputStream os)` DER 인코딩된 서명 메시지를 획득한다.
`static SignedData`	`getInstance(byte[] data)` 서명 메시지를 입력하여 SignedData 객체로 변환한다.
`static SignedData`	`getInstance(java.lang.Object o)` 서명 메시지를 입력하여 SignedData 객체로 변환한다.
`X509Certificate`	`getSignerCert(SignerIdentifier sid)` 서명자 정보에 있는 서명자 식별자를 이용하여 해당 서명자에 대한 인증서를 획득한다.
`java.util.ArrayList`	`getSignerInfos()` 서명 메시지에 서명한 사람들의 정보를 확인한다.
`java.lang.String`	`getType()` 서명 메시지의 종류를 확인한다.
`int`	`getVersion()` 서명 메시지의 버전을 획득한다.
`void`	`insertUnsignedAttributes(int signerIndex, java.lang.Object attrType, byte[] attrValue)`
`com.dreamsecurity.jcaos.asn1.cms.SignedData`	`toASN1Object()` ASN.1 형태의 SignedData를 획득한다.
`void`	`verify()` 서명 메시지에 포함되어있는 모든 서명자의 서명값을 검증한다.
`void`	`verify(byte[] content)` 서명 메시지에 포함되어있는 모든 서명자의 서명값을 검증한다.
`void`	`verify(java.io.InputStream content)` 서명 메시지에 포함되어있는 모든 서명자의 서명값을 검증한다.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static SignedData getInstance(byte[] data)
                              throws java.io.IOException

서명 메시지를 입력하여 SignedData 객체로 변환한다.

Parameters:: data - DER 인코딩된 형태의 서명 메시지
Throws:: java.io.IOException - 디코딩 실패시 발생

getInstance

public static SignedData getInstance(java.lang.Object o)
                              throws java.io.IOException

서명 메시지를 입력하여 SignedData 객체로 변환한다.

Parameters:: o - 서명 메시지 (DER 인코딩된 값, ASN.1 형태 또는 InputStream 형태)
Throws:: java.io.IOException - 디코딩 실패시 발생

getEncoded

public byte[] getEncoded()
                  throws java.io.IOException

DER 인코딩된 서명 메시지를 획득한다.

Returns:: DER 인코딩된 서명 메시지
Throws:: java.io.IOException

getEncoded

public void getEncoded(java.io.OutputStream os)
                throws java.io.IOException

DER 인코딩된 서명 메시지를 획득한다.

Parameters:: os - OuputStream 형식의 DER 인코딩된 서명 메시지
Throws:: java.io.IOException - 출력 스트림에 쓰기 실패시 발생

toASN1Object

public com.dreamsecurity.jcaos.asn1.cms.SignedData toASN1Object()

ASN.1 형태의 SignedData를 획득한다.

Returns:: ASN.1 형태의 SignedData

addSignerCerts

public void addSignerCerts(X509Certificate cert)

서명 메시지안에 서명자의 인증서가 포함되어있지 않은 경우에 서명 값 검증을 위해서 필요한 서명자의 인증서를 지정한다.

Parameters:: cert - 서명자의 인증서

getType

public java.lang.String getType()

서명 메시지의 종류를 확인한다.

Returns:: 서명 메시지의 종류 ("CMS", "PKCS7")

getVersion

public int getVersion()

서명 메시지의 버전을 획득한다.

Returns:: 버전

getDigestAlgorithms

public java.util.ArrayList getDigestAlgorithms()

서명 메시지의 다이제스트 알고리즘 목록을 획득한다.

Returns:: 다이제스트 알고리즘 목록. String의 ArrayList 형태임

getContentType

public java.lang.String getContentType()

서명한 원본 메시지의 종류를 확인한다.

Returns:: 메시지 종류 OID

getContent

public byte[] getContent()

서명한 원본 메시지를 획득한다.

Returns:: 원본 메시지. 만약 원본 메시지가 포함되어있지 않다면 null이 리턴됨.

getCertificates

public java.util.ArrayList getCertificates()
                                    throws java.io.IOException

서명 메시지에 포함되어있는 인증서 목록을 획득한다.

Returns:: 인증서 목록. X509Certificate의 ArrayList 형태. 만약 인증서 목록이 없으면 null이 리턴됨.
Throws:: java.io.IOException - 인증서 디코딩 실패 시 발생

getSignerInfos

public java.util.ArrayList getSignerInfos()
                                   throws java.io.IOException

서명 메시지에 서명한 사람들의 정보를 확인한다.

Returns:: 서명자 정보. SignerInfo의 ArrayList 형태
Throws:: java.io.IOException - 서명자 정보 디코딩 실패시 발생

getSignerCert

public X509Certificate getSignerCert(SignerIdentifier sid)
                              throws NotExistSignerCertException,
                                     ParsingException,
                                     java.io.IOException

서명자 정보에 있는 서명자 식별자를 이용하여 해당 서명자에 대한 인증서를 획득한다. 서명자 식별자는 메소드 CMSSignerInfo.getSid()을 이용하여 획득할 수 있다.

Parameters:: sid - 서명자 식별자
Returns:: 서명자 인증서
Throws:: NotExistSignerCertException - 해당 서명자 인증서가 존재하지 않을 경우에 발생; ParsingException - 서명자 식별자의 이름 정보에 처리할 수 없는 속성이 있는 경우에 발생; java.io.IOException - 정보 디코딩 실패 시 발생

verify

public void verify(java.io.InputStream content)
            throws ParsingException,
                   java.security.NoSuchAlgorithmException,
                   NotExistSignerCertException,
                   java.security.NoSuchProviderException,
                   java.security.spec.InvalidKeySpecException,
                   java.security.InvalidKeyException,
                   java.security.SignatureException,
                   VerifyException,
                   java.io.IOException

서명 메시지에 포함되어있는 모든 서명자의 서명값을 검증한다. 본 함수는 서명 메시지에 원본이 포함되어있지 않은 경우에 사용한다.

Parameters:: content - InputStream 형식의 서명 메시지의 원본 메시지
Throws:: ParsingException - 서명자 식별자의 이름 정보에 처리할 수 없는 속성이 있는 경우에 발생; java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생; NotExistSignerCertException - 서명 검증 시 필요한 서명자 인증서가 존재하지 않을 경우에 발생; java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생; java.security.spec.InvalidKeySpecException - 적합하지 않은 키 정보인 경우에 발생; java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생; java.security.SignatureException - 일반적인 서명과 관련한 예외 사항 발생한 경우 발생; VerifyException - 서명 검증 실패 시 발생; java.io.IOException - 입력 스트림 읽기 실패 또는 서명 메시지 디코딩 실패 시 발생
See Also:: verify()

insertUnsignedAttributes

public void insertUnsignedAttributes(int signerIndex,
                                     java.lang.Object attrType,
                                     byte[] attrValue)
                              throws java.io.IOException

Throws:: java.io.IOException

verify

public void verify(byte[] content)
            throws ParsingException,
                   java.security.NoSuchAlgorithmException,
                   NotExistSignerCertException,
                   java.security.NoSuchProviderException,
                   java.security.spec.InvalidKeySpecException,
                   java.security.InvalidKeyException,
                   java.security.SignatureException,
                   VerifyException,
                   java.io.IOException

서명 메시지에 포함되어있는 모든 서명자의 서명값을 검증한다. 본 함수는 서명 메시지에 원본이 포함되어있지 않은 경우에 사용한다.

Parameters:: content - 서명 메시지의 원본 메시지
Throws:: ParsingException - 서명자 식별자의 이름 정보에 처리할 수 없는 속성이 있는 경우에 발생; java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생; NotExistSignerCertException - 서명 검증 시 필요한 서명자 인증서가 존재하지 않을 경우에 발생; java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생; java.security.spec.InvalidKeySpecException - 적합하지 않은 키 정보인 경우에 발생; java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생; java.security.SignatureException - 일반적인 서명과 관련한 예외 사항 발생한 경우 발생; VerifyException - 서명 검증 실패 시 발생; java.io.IOException - 서명 메시지 디코딩 실패 시 발생
See Also:: verify()

verify

public void verify()
            throws ParsingException,
                   java.security.NoSuchAlgorithmException,
                   NotExistSignerCertException,
                   java.security.NoSuchProviderException,
                   java.security.spec.InvalidKeySpecException,
                   java.security.InvalidKeyException,
                   java.security.SignatureException,
                   VerifyException,
                   java.io.IOException

서명 메시지에 포함되어있는 모든 서명자의 서명값을 검증한다. 단, 서명 메시지에는 원본 메시지가 포함되어 있어야 한다.

Throws:: ParsingException - 서명자 식별자의 이름 정보에 처리할 수 없는 속성이 있는 경우에 발생; java.security.NoSuchAlgorithmException - 지원되지 않는 서명 알고리즘이 사용되었을 경우에 발생; NotExistSignerCertException - 서명 검증 시 필요한 서명자 인증서가 존재하지 않을 경우에 발생; java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생; java.security.spec.InvalidKeySpecException - 적합하지 않은 키 정보인 경우에 발생; java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생; java.security.SignatureException - 일반적인 서명과 관련한 예외 사항 발생한 경우 발생; VerifyException - 서명 검증 실패 시 발생; java.io.IOException - 디코딩 실패 시 발생
See Also:: verify(byte[])

Overview

Package

Class

Tree

Deprecated

Index

Help

JCaosLib
V1.4.4.0

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.dreamsecurity.jcaos.cms Class SignedData

getInstance

getInstance

getEncoded

getEncoded

toASN1Object

addSignerCerts

getType

getVersion

getDigestAlgorithms

getContentType

getContent

getCertificates

getSignerInfos

getSignerCert

verify

insertUnsignedAttributes

verify

verify

com.dreamsecurity.jcaos.cms
Class SignedData