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.pkcs
Class PKCS12

java.lang.Object
  extended bycom.dreamsecurity.jcaos.pkcs.PKCS12
public class PKCS12
extends java.lang.Object

인증서, 개인키와 같은 중요한 개인 정보를 이동하기 위한 위한 클래스이다. 해당 내용은 표준문서 "PKCS#12" 에서 기술하고 있다.

비밀번호를 이용한 키 유도만을 제공한다.

PFX ASN.1 포맷은 다음과 같다. 

 PFX ::= SEQUENCE {
 		version INTEGER {v3(3)}(v3,...),
 		authSafe ContentInfo,
 		macData MacData OPTIONAL
 }
 
 MacData ::= SEQUENCE {
 		mac DigestInfo,
 		macSalt OCTET STRING,
 		iterations INTEGER DEFAULT 1
 		- Note: The default is for historical reasons and its use is deprecated. A higher
 		-- value, like 1024, is recommended.
 }

Since:
1.0.0.0

Constructor Summary
PKCS12(byte[] password)
          개인정보 암/복호화에 사용할 비밀번호를 설정하여 PKCS12 클래스를 초기화 한다.
PKCS12(java.lang.String password)
          개인정보 암/복호화에 사용할 비밀번호를 설정하여 PKCS12 클래스를 초기화 한다.
 
Method Summary
 void add(X509Certificate cert)
          이동할 인증서를 추가한다.
 void add(X509Certificate cert, PKCS8PrivateKeyInfo priKey)
          이동할 인증서와 개인키 쌍을 추가한다.
 byte[] exportPFX()
          개인 정보를 이동하기 위한 암호화 및 인증 포맷을 생성한다.
 java.util.ArrayList getCaCerts()
          이동한 개인 정보를 처리한 후, 포함되어있던 인증기관 인증서를 획득한다.
 java.util.ArrayList getCerts()
          이동한 개인 정보를 처리한 후, 포함되어있던 인증서를 획득한다.
 java.util.ArrayList getPriKeys()
          이동한 개인 정보를 처리한 후, 포함되어있던 개인키를 획득한다.
 void importPFX(byte[] data)
          이동된 개인 정보를 처리한다.
 void setCertBagPBEAlg(java.lang.String alg)
          인증서 암호화 알고리즘을 설정한다.
 void setIterationCountForEnc(int count)
          개인 정보를 암호화를 위해서 키를 유도할때 사용하는 반복횟수(IterationCount) 값을 지정한다.
 void setIterationCountForMac(int count)
          개인 정보 변경 방지를 위한 인증 코드 생성 시 사용할 키를 유도할때 사용하는 반복횟수(IterationCount) 값을 지정한다.
 void setPKCS8ShroudedKeyBagPBEAlg(java.lang.String alg)
          개인키 암호화 알고리즘을 설정한다.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PKCS12

public PKCS12(java.lang.String password)
개인정보 암/복호화에 사용할 비밀번호를 설정하여 PKCS12 클래스를 초기화 한다.

Parameters:
password - String 형식의 비밀번호

PKCS12

public PKCS12(byte[] password)
개인정보 암/복호화에 사용할 비밀번호를 설정하여 PKCS12 클래스를 초기화 한다.

Parameters:
password - byte 배열 형식의 비밀번호
Method Detail

setCertBagPBEAlg

public void setCertBagPBEAlg(java.lang.String alg)
인증서 암호화 알고리즘을 설정한다. 지정하지 않으면 "SHAAnd40BitRC2/CBC"가 사용된다.

현재 지원 알고리즘 : SHAAndDESede/CBC, SHAAnd128BitRC2/CBC, SHAAnd40BitRC2/CBC

Parameters:
alg - 인증서 암호화 알고리즘

setPKCS8ShroudedKeyBagPBEAlg

public void setPKCS8ShroudedKeyBagPBEAlg(java.lang.String alg)
개인키 암호화 알고리즘을 설정한다. 지정하지 않으면 "SHAAndDESede/CBC"가 사용된다.

현재 지원 알고리즘 : SHAAndDESede/CBC, SHAAnd128BitRC2/CBC, SHAAnd40BitRC2/CBC

Parameters:
alg - 개인키 암호화 알고리즘

setIterationCountForEnc

public void setIterationCountForEnc(int count)
개인 정보를 암호화를 위해서 키를 유도할때 사용하는 반복횟수(IterationCount) 값을 지정한다. 지정하지 않으면 2000이 사용된다.

Parameters:
count - 반복 횟수

setIterationCountForMac

public void setIterationCountForMac(int count)
개인 정보 변경 방지를 위한 인증 코드 생성 시 사용할 키를 유도할때 사용하는 반복횟수(IterationCount) 값을 지정한다. 지정하지 않으면 1024가 사용된다.

Parameters:
count - 반복 횟수

add

public void add(X509Certificate cert,
                PKCS8PrivateKeyInfo priKey)
이동할 인증서와 개인키 쌍을 추가한다.

Parameters:
cert - 인증서
priKey - 개인키

add

public void add(X509Certificate cert)
이동할 인증서를 추가한다. 이때 추가되는 인증서는 일반적으로 함께 이동할 개인키 쌍 없는 인증기관 인증서가 된다.

Parameters:
cert - 인증서

getPriKeys

public java.util.ArrayList getPriKeys()
이동한 개인 정보를 처리한 후, 포함되어있던 개인키를 획득한다. 목록에 있는 각 개인키는 getCerts 메소드로 획득한 인증서와 같은 인덱스에 대해서 쌍이된다.

Returns:
ArrayList 형식의 개인키 목록. 각각은 PKCS8PrivateKeyInfo 형식의 개인키이다.
See Also:
getCaCerts()

getCerts

public java.util.ArrayList getCerts()
이동한 개인 정보를 처리한 후, 포함되어있던 인증서를 획득한다. 목록에 있는 각 인증서는 getPriKeys() 메소드로 획득한 개인키와 같은 인덱스에 대해서 쌍이된다.

Returns:
ArrayList 형식의 인증서 목록. 각각은 X509Certificate 형식의 인증서이다.

getCaCerts

public java.util.ArrayList getCaCerts()
이동한 개인 정보를 처리한 후, 포함되어있던 인증기관 인증서를 획득한다.

Returns:
ArrayList 형식의 인증서 목록. 각각은 X509Certificate 형식의 인증서이다.

exportPFX

public byte[] exportPFX()
                 throws java.io.IOException,
                        java.security.NoSuchProviderException,
                        java.security.NoSuchAlgorithmException,
                        javax.crypto.NoSuchPaddingException,
                        java.security.InvalidAlgorithmParameterException,
                        javax.crypto.BadPaddingException,
                        javax.crypto.IllegalBlockSizeException,
                        java.security.InvalidKeyException
개인 정보를 이동하기 위한 암호화 및 인증 포맷을 생성한다.

Returns:
PFX 형식의 암호화 된 개인정보
Throws:
java.io.IOException - DER 포맷 인코딩 실패 시 발생
java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생
java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생
javax.crypto.NoSuchPaddingException - 지원하지 않는 패딩 종류일 경우에 발생
java.security.InvalidAlgorithmParameterException - 알고리즘 파라메터가 적합하지 않은 경우에 발생
javax.crypto.BadPaddingException - 입력값이 지정된 패딩 타입으로 패딩 되어있지 않은 경우에 발생
javax.crypto.IllegalBlockSizeException - 입력 데이터의 길이가 블럭 알고리즘에 적합하지 않는 경우에 발생
java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생

importPFX

public void importPFX(byte[] data)
               throws java.io.IOException,
                      VerifyException,
                      ParsingException,
                      javax.crypto.BadPaddingException,
                      java.security.InvalidKeyException,
                      javax.crypto.NoSuchPaddingException,
                      java.security.spec.InvalidKeySpecException,
                      java.security.NoSuchProviderException,
                      java.security.NoSuchAlgorithmException,
                      javax.crypto.IllegalBlockSizeException,
                      java.security.InvalidAlgorithmParameterException
이동된 개인 정보를 처리한다.

Parameters:
data - PFX 형식의 이동된 개인 정보
Throws:
UseOrderException - 암호화할 메시지를 설정하지 않았거나 수신자를 추가하지 않았을 경우에 발생
javax.crypto.NoSuchPaddingException - 지원하지 않는 패딩 종류일 경우에 발생
java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생
NoSuchModeException - 지원하지 않는 암호 모드일 경우에 발생
java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생
javax.crypto.BadPaddingException - 입력값이 지정된 패딩 타입으로 패딩 되어있지 않은 경우에 발생
java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생
javax.crypto.IllegalBlockSizeException - 입력 데이터의 길이가 블럭 알고리즘에 적합하지 않는 경우에 발생
java.security.InvalidAlgorithmParameterException - 알고리즘 파라메터가 적합하지 않은 경우에 발생
java.io.IOException - 정보 디코딩 실패 시 발생한다.
VerifyException - 서명 검증 실패 시 발생
ParsingException - 지원하지 않는 포맷으로 암호화/인증 되어있는 경우에 발생
java.security.spec.InvalidKeySpecException - 적합하지 않은 키 정보인 경우에 발생
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