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 EnvelopedData

java.lang.Object
  extended bycom.dreamsecurity.jcaos.cms.EnvelopedData
public class EnvelopedData
extends java.lang.Object

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

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

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

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

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

 RFC3852에서 정의하는 EnvelopedData 형식 : 
 
 EnvelopedData ::= SEQUENCE {
		version                  CMSVersion,
		originatorInfo       [0] IMPLICIT OriginatorInfo OPTIONAL,
		recipientInfos           RecipientInfos,
		encryptedContentInfo     EncryptedContentInfo,
		unprotectedAttrs     [1] IMPLICIT UnprotectedAttributes OPTIONAL 
 }
 
 PKCS#7에서 정의하는 EnvelopedData 형식 :
  
 EnvelopedData ::= SEQUENCE {
 		version              Version,
 		recipientInfos       RecipientInfos,
 		encryptedContentInfo EncryptedContentInfo }
 
 비대칭키 암호 메시지 객체 생성 예제 :
  
 byte[] envData = <비대칭키 암호 메시지 읽기>
 EnvelopedData envelopedData = EnvelopedData.getInstance(envData);

Since:
1.0.0.0

Method Summary
 byte[] decrypt(X509Certificate myCert, PKCS8PrivateKeyInfo myPriKeyInfo)
          수신자의 인증서와 개인키를 이용하여 메시지를 복호화한다.
 byte[] decrypt(X509Certificate myCert, PKCS8PrivateKeyInfo myPriKeyInfo, java.io.InputStream encContent)
          수신자의 인증서와 개인키를 이용하여 메시지를 복호화한다.
 void decrypt(X509Certificate myCert, PKCS8PrivateKeyInfo myPriKeyInfo, java.io.InputStream encContent, java.io.OutputStream content)
          수신자의 인증서와 개인키를 이용하여 메시지를 복호화한다.
 void decrypt(X509Certificate myCert, PKCS8PrivateKeyInfo myPriKeyInfo, java.io.OutputStream content)
          수신자의 인증서와 개인키를 이용하여 메시지를 복호화한다.
 java.lang.String getContentEncryptionAlgorithm()
          메시지 암호화 시 사용한 대칭키 알고리즘을 확인한다.
 java.lang.String getContentType()
          암호화된 메시지 종류를 확인한다.
 byte[] getEncoded()
          DER 인코딩 되어있는 비대칭키 암호 메시지 데이터를 획득한다.
 void getEncoded(java.io.OutputStream os)
          DER 인코딩 되어있는 비대칭키 암호 메시지 데이터를 획득한다.
 byte[] getEncryptedContent()
          대칭키 암호화된 메시지를 확인한다.
 void getEncryptedContent(java.io.OutputStream os)
          암호화된 메시지를 확인한다.
static EnvelopedData getInstance(byte[] data)
          비대칭키 암호 메시지를 입력하여 EnvelopedData 객체로 변환한다.
static EnvelopedData getInstance(java.lang.Object o)
          비대칭키 암호 메시지를 입력하여 EnvelopedData 객체로 변환한다.
 java.security.Key getKey()
          메시지 암호화에 사용되었던 대칭키를 획득한다.
 java.security.spec.AlgorithmParameterSpec getParameter()
          메시지 암호화에 사용되었던 대칭키 알고리즘의 파라메터 (IV 등)를 획득한다.
 java.util.ArrayList getRecipientInfos()
          수신자 정보를 획득한다.
 int getVersion()
          비대칭키 암호 메시지의 버전을 확인한다.
static EnvelopedData seperate(java.io.InputStream envData, java.io.OutputStream cipherText)
          암호문을 포함하는 비대칭키 암호 메시지 (EnvelopedData)를 암호문과 암호 메시지를 분리한다.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getInstance

public static EnvelopedData getInstance(byte[] data)
                                 throws java.io.IOException
비대칭키 암호 메시지를 입력하여 EnvelopedData 객체로 변환한다.

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

getInstance

public static EnvelopedData getInstance(java.lang.Object o)
                                 throws java.io.IOException
비대칭키 암호 메시지를 입력하여 EnvelopedData 객체로 변환한다.

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 - OutputStream 형식의 DER 인코딩 되어있는 비대칭키 암호 메시지
Throws:
java.io.IOException - 출력 스트림에 쓰기 실패 또는 인코딩 실패 시 발생

getVersion

public int getVersion()
비대칭키 암호 메시지의 버전을 확인한다.

Returns:
버전

getRecipientInfos

public java.util.ArrayList getRecipientInfos()
                                      throws ParsingException,
                                             java.io.IOException
수신자 정보를 획득한다. 현재 수신자 정보 형태 중 "KeyTransRecipientInfo" 만 지원된다.

Returns:
KeyTransRecipientInfo의 ArrayList 형태의 수신자 정보
Throws:
ParsingException - 수신자 정보 형태 중 지원하지 않는 형태가 있는 경우에 발생
java.io.IOException - 수신자 정보 디코딩 실패 시 발생

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

decrypt

public void decrypt(X509Certificate myCert,
                    PKCS8PrivateKeyInfo myPriKeyInfo,
                    java.io.OutputStream content)
             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
수신자의 인증서와 개인키를 이용하여 메시지를 복호화한다.

Parameters:
myCert - 수신자 인증서
myPriKeyInfo - 수신자 개인키
content - 복호화된 메시지
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 - 알고리즘 파라메터가 적합하지 않은 경우에 발생

decrypt

public void decrypt(X509Certificate myCert,
                    PKCS8PrivateKeyInfo myPriKeyInfo,
                    java.io.InputStream encContent,
                    java.io.OutputStream content)
             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
수신자의 인증서와 개인키를 이용하여 메시지를 복호화한다.

Parameters:
myCert - 수신자 인증서
myPriKeyInfo - 수신자 개인키
encContent - 암호화된 메시지 (복호화할 메시지)
content - 복호화된 메시지
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 - 알고리즘 파라메터가 적합하지 않은 경우에 발생
Since:
1.3.0.0

decrypt

public byte[] decrypt(X509Certificate myCert,
                      PKCS8PrivateKeyInfo myPriKeyInfo)
               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
수신자의 인증서와 개인키를 이용하여 메시지를 복호화한다.

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 - 알고리즘 파라메터가 적합하지 않은 경우에 발생

decrypt

public byte[] decrypt(X509Certificate myCert,
                      PKCS8PrivateKeyInfo myPriKeyInfo,
                      java.io.InputStream encContent)
               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
수신자의 인증서와 개인키를 이용하여 메시지를 복호화한다.

Parameters:
myCert - 수신자 인증서
myPriKeyInfo - 수신자 개인키
encContent - 암호화된 메시지 (복호화할 메시지)
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 - 알고리즘 파라메터가 적합하지 않은 경우에 발생
Since:
1.3.0.0

getKey

public java.security.Key getKey()
메시지 암호화에 사용되었던 대칭키를 획득한다.

Returns:
대칭키
See Also:
getParameter()

getParameter

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

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

seperate

public static EnvelopedData seperate(java.io.InputStream envData,
                                     java.io.OutputStream cipherText)
                              throws java.io.IOException,
                                     ParsingException
암호문을 포함하는 비대칭키 암호 메시지 (EnvelopedData)를 암호문과 암호 메시지를 분리한다.

Parameters:
envData - 암호문을 포함하는 비대칭키 암호 메시지 (EnvelopedData)
cipherText - 분리된 암호문
Returns:
암호문을 분리한 비대칭키 암호 메시지 (EnvelopedData)
Throws:
java.io.IOException - 입/출력 예외 발생
ParsingException - 비대칭키 암호문 처리 실패 시
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

Copyright ⓒ2007-2011 DreamSecurity Co.,Ltd . All rights reserved