SignedAndEnvelopedData (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 SignedAndEnvelopedData

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

public class SignedAndEnvelopedData
extends java.lang.Object

서명 및 비대칭키 암호 메시지(SignedAndEnvelopedData)를 처리하기 위한 클래스이다.

서명 및 비대칭키 암호 메시지는 메시지의 인증, 무결성, 기밀성을 위해서 메시지의 서명 생성 및 대칭키로 암호화하고 대칭키는 수신자의 공개키(인증서)를 이용해서 암호화하여 수신자 만이 메시지를 확인할 수 있도록 하는 보안 메시지 형식이다.

해당 클래스에서는 PKCS#7에서 정의하는 SignedAndEnvelopedData를 지원한다.

서명 및 비대칭키 암호 메시지에 대한 자세한 정보는 "PKCS#7"에서 확인할 수 있다.

서명 및 비대칭키 암호 메시지의 ASN.1 포맷은 다음과 같다.

 SignedAndEnvelopedData ::= SEQUENCE {
 		version                  Version,
 		recipientInfos           RecipientInfos,
		digestAlgorithms         DigestAlgorithmIdentifiers,
		encryptedContentInfo     EncryptedContentInfo,
		certificates         [0] IMPLICIT ExtendedCertificatesAndCertificates OPTIONAL,
		crls                 [1] IMPLICIT CertificateRevocationLists OPTIONAL,
		signerInfos              SignerInfos }
 
 서명 및 비대칭키 암호 메시지 객체 생성 예제 :
  
 byte[] data = <서명 및 비대칭키 암호 메시지 읽기>
 SignedAndEnvelopedData signedAndEnvData = SignedAndEnvelopedData.getInstance(data);

[Note]
서명 및 비대칭키 암호 메시지는 인증된 속성값(AuthenticatedAttribute), 인증되지 않은 속성값(UnauthenticatedAttribute)을 포함하지 않고, 서명 값을 제외한 서명자 정보가 보호되지 않기 때문에 SignedData와 EnvelopedData를 순차적으로 사용하는 것을 권장한다.

Since:: 1.0.0.0

Method Summary
`byte[]`	`decryptAndVerify(X509Certificate myCert, PKCS8PrivateKeyInfo myPriKeyInfo)` 수신자의 인증서와 개인키를 이용하여 메시지를 복호화하고 서명값을 검증한다.
`void`	`decryptAndVerify(X509Certificate myCert, PKCS8PrivateKeyInfo myPriKeyInfo, java.io.OutputStream os)` 수신자의 인증서와 개인키를 이용하여 메시지를 복호화하고 서명값을 검증한다.
`java.util.ArrayList`	`getCertificates()` 서명 메시지에 포함되어있는 인증서 목록을 획득한다.
`java.lang.String`	`getContentEncryptionAlgorithm()` 메시지 암호화 시 사용한 알고리즘을 확인한다.
`java.lang.String`	`getContentType()` 암호화된 메시지 종류를 확인한다.
`java.lang.String[]`	`getDigestAlgorihtms()` 서명 메시지의 다이제스트 알고리즘 목록을 획득한다.
`byte[]`	`getEncoded()` DER 인코딩 되어있는 서명 및 비대칭키 암호 메시지 데이터를 획득한다.
`void`	`getEncoded(java.io.OutputStream os)` DER 인코딩 되어있는 서명 및 비대칭키 암호 메시지 데이터를 획득한다.
`byte[]`	`getEncryptedContent()` 암호화된 메시지를 확인한다.
`void`	`getEncryptedContent(java.io.OutputStream os)` 암호화된 메시지를 확인한다.
`static SignedAndEnvelopedData`	`getInstance(byte[] data)` 서명 및 비대칭키 암호 메시지를 입력하여 SignedAndEnvelopedData 객체로 변환한다.
`static SignedAndEnvelopedData`	`getInstance(java.lang.Object o)` 서명 및 비대칭키 암호 메시지를 입력하여 SignedAndEnvelopedData 객체로 변환한다.
`java.security.Key`	`getKey()` 메시지 암호화에 사용되었던 대칭키를 획득한다.
`java.security.spec.AlgorithmParameterSpec`	`getParameter()` 메시지 암호화에 사용되었던 대칭키 알고리즘의 파라메터 (IV 등)를 획득한다.
`java.util.ArrayList`	`getRecipientInfos()` 수신자 정보를 획득한다.
`X509Certificate`	`getSignerCert(SignerIdentifier sid)` 서명자 정보에 있는 서명자 식별자를 이용하여 해당 서명자에 대한 인증서를 획득한다.
`java.util.ArrayList`	`getSignerInfos()` 서명 메시지에 서명한 사람들의 정보를 확인한다.
`int`	`getVersion()` 서명 및 비대칭키 암호 메시지의 버전을 확인한다.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

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

서명 및 비대칭키 암호 메시지를 입력하여 SignedAndEnvelopedData 객체로 변환한다.

Parameters:: data - DER 인코딩된 형태의 서명 및 비대칭키 암호 메시지
Throws:: java.io.IOException - 디코딩 실패시 발생

getInstance

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

서명 및 비대칭키 암호 메시지를 입력하여 SignedAndEnvelopedData 객체로 변환한다.

Parameters:: o - 서명 및 비대칭키 암호 메시지 (DER 인코딩된 값 또는 ASN.1 형태)
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 - OutputStream 형식의 DER 인코딩 되어있는 서명 및 비대칭키 암호 메시지
Throws:: java.io.IOException - 인코딩 실패 시 발생

getVersion

public int getVersion()

서명 및 비대칭키 암호 메시지의 버전을 확인한다.

Returns:: 버전

getRecipientInfos

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

수신자 정보를 획득한다. 현재 수신자 정보 형태 중 "KeyTransRecipientInfo" 만 지원된다.

Returns:: KeyTransRecipientInfo의 ArrayList 형태의 수신자 정보
Throws:: java.io.IOException - 수신자 정보 디코딩 실패 시 발생

getDigestAlgorihtms

public java.lang.String[] getDigestAlgorihtms()

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

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

getContentType

public java.lang.String getContentType()

암호화된 메시지 종류를 확인한다.

Returns:: 메시지 종류(OID)

getContentEncryptionAlgorithm

public java.lang.String getContentEncryptionAlgorithm()

메시지 암호화 시 사용한 알고리즘을 확인한다.

Returns:: 대칭키 알고리즘

getEncryptedContent

public byte[] getEncryptedContent()

암호화된 메시지를 확인한다.

Returns:: 암호화된 메시지

getEncryptedContent

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

암호화된 메시지를 확인한다.

Parameters:: os - 형식의 암호화된 메시지
Throws:: java.io.IOException - 출력 실패 시 발생

getCertificates

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

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

Returns:: 인증서 목록. X509Certificate의 ArrayList 형태
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

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

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

decryptAndVerify

public byte[] decryptAndVerify(X509Certificate myCert,
                               PKCS8PrivateKeyInfo myPriKeyInfo)
                        throws java.io.IOException,
                               java.security.SignatureException,
                               ParsingException,
                               VerifyException,
                               java.security.InvalidKeyException,
                               java.security.spec.InvalidKeySpecException,
                               java.security.NoSuchAlgorithmException,
                               javax.crypto.NoSuchPaddingException,
                               NoSuchModeException,
                               NotForUserException,
                               java.security.NoSuchProviderException,
                               javax.crypto.IllegalBlockSizeException,
                               javax.crypto.BadPaddingException,
                               NotExistSignerCertException,
                               java.security.InvalidAlgorithmParameterException

수신자의 인증서와 개인키를 이용하여 메시지를 복호화하고 서명값을 검증한다.

Parameters:: myCert - 수신자 인증서; myPriKeyInfo - 수신자 개인키
Returns:: 복호화된 메시지
Throws:: java.io.IOException - 인증서 디코딩 실패시 발생; ParsingException - 지원하지 않는 수신자 정보 형태가 있는 경우에 발생; java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생; java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생; javax.crypto.NoSuchPaddingException - 지원하지 않는 패딩 종류일 경우에 발생; NoSuchModeException - 지원하지 않는 암호 모드일 경우에 발생; NotForUserException - 해당 수신자로 처리할 수 없을 경우에 발생; java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생; javax.crypto.IllegalBlockSizeException - 입력 데이터의 길이가 블럭 알고리즘에 적합하지 않는 경우에 발생; javax.crypto.BadPaddingException - 입력값이 지정된 패딩 타입으로 패딩 되어있지 않은 경우에 발생; java.security.InvalidAlgorithmParameterException - 알고리즘 파라메터가 적합하지 않은 경우에 발생; java.security.SignatureException; VerifyException; java.security.spec.InvalidKeySpecException; NotExistSignerCertException

decryptAndVerify

public void decryptAndVerify(X509Certificate myCert,
                             PKCS8PrivateKeyInfo myPriKeyInfo,
                             java.io.OutputStream os)
                      throws java.io.IOException,
                             ParsingException,
                             java.security.InvalidKeyException,
                             java.security.NoSuchAlgorithmException,
                             javax.crypto.NoSuchPaddingException,
                             NoSuchModeException,
                             NotForUserException,
                             java.security.NoSuchProviderException,
                             javax.crypto.IllegalBlockSizeException,
                             javax.crypto.BadPaddingException,
                             VerifyException,
                             java.security.SignatureException,
                             NotExistSignerCertException,
                             java.security.spec.InvalidKeySpecException,
                             java.security.InvalidAlgorithmParameterException

수신자의 인증서와 개인키를 이용하여 메시지를 복호화하고 서명값을 검증한다.

Parameters:: myCert - 수신자 인증서; myPriKeyInfo - 수신자 개인키; os - 복호화된 메시지
Throws:: java.io.IOException - 인증서 디코딩 실패시 발생; ParsingException - 지원하지 않는 수신자 정보 형태가 있는 경우에 발생; java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생; java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생; javax.crypto.NoSuchPaddingException - 지원하지 않는 패딩 종류일 경우에 발생; NoSuchModeException - 지원하지 않는 암호 모드일 경우에 발생; NotForUserException - 해당 수신자로 처리할 수 없을 경우에 발생; java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생; javax.crypto.IllegalBlockSizeException - 입력 데이터의 길이가 블럭 알고리즘에 적합하지 않는 경우에 발생; javax.crypto.BadPaddingException - 입력값이 지정된 패딩 타입으로 패딩 되어있지 않은 경우에 발생; java.security.InvalidAlgorithmParameterException - 알고리즘 파라메터가 적합하지 않은 경우에 발생; VerifyException; java.security.SignatureException; NotExistSignerCertException; java.security.spec.InvalidKeySpecException

getKey

public java.security.Key getKey()

메시지 암호화에 사용되었던 대칭키를 획득한다.

Returns:: 대칭키
See Also:: getParameter()

getParameter

public java.security.spec.AlgorithmParameterSpec getParameter()

메시지 암호화에 사용되었던 대칭키 알고리즘의 파라메터 (IV 등)를 획득한다.

Returns:: 알고리즘 파라메터 (IV)
See Also:: getKey()

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 SignedAndEnvelopedData

getInstance

getInstance

getEncoded

getEncoded

getVersion

getRecipientInfos

getDigestAlgorihtms

getContentType

getContentEncryptionAlgorithm

getEncryptedContent

getEncryptedContent

getCertificates

getSignerInfos

getSignerCert

decryptAndVerify

decryptAndVerify

getKey

getParameter

com.dreamsecurity.jcaos.cms
Class SignedAndEnvelopedData