PKCS8 (JCAOS V1.4.4.0 - DreamSecurity)

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 PKCS8

java.lang.Object
  com.dreamsecurity.jcaos.pkcs.PKCS8

public class PKCS8
extends java.lang.Object

비밀번호 기반의 개인키 암호화 또는 복호화를 위한 클래스이다. PKCS#5 표준을 기반으로 하여 암/복호화 를 수행한다.

개인키, 암호화된 개인키에 대한 구조는 표준문서 "PKCS#8" 에서 확인할 수 있다. 또한 비밀번호를 기반으로 한 암/복호화에 대한 표준문서 "PKCS#5" 에 기술되어있다.

개인키 정보와 암호화된 개인키 정보의 ASN.1 포맷은 다음과 같다.

 PrivateKeyInfo ::= SEQUENCE {
		version 					Version,
		privateKeyAlgorithm 		AlgorithmIdentifier {{PrivateKeyAlgorithms}},
		privateKey 				PrivateKey,
		attributes 			[0] Attributes OPTIONAL }
 
 EncryptedPrivateKeyInfo ::= SEQUENCE {
 		encryptionAlgorithm AlgorithmIdentifier {{KeyEncryptionAlgorithms}},
		encryptedData EncryptedData }

Since:: 1.0.0.0

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

Method Summary
`PKCS8PrivateKeyInfo`	`decrypt(byte[] encPriKey)` 암호화된 개인키를 복호화한다.
`byte[]`	`encrypt(PKCS8PrivateKeyInfo priKeyInfo)` 개인키를 암호화한다.
`void`	`setIterationCount(int cnt)` 키를 유도할때 사용되는 interation count 값을 지정한다.
`void`	`setPBES1Algorithm(java.lang.String pbes)` PKCS#5 V1.5 방법을 이용하여 개인키를 암호화한다.
`void`	`setPBES2Algorithm(java.lang.String pbes)` PKCS#5 V2.0 방법을 이용하여 개인키를 암호화한다.

Methods inherited from class java.lang.Object

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

Constructor Detail

PKCS8

public PKCS8(java.lang.String password)

개인키 암/복호화에 사용할 비밀번호를 설정하여 PKCS8 클래스를 초기화 한다.
Parameters:: password - 비밀번호

Method Detail

setPBES1Algorithm

public void setPBES1Algorithm(java.lang.String pbes)

PKCS#5 V1.5 방법을 이용하여 개인키를 암호화한다. 지정하지 않으면 V2.0의 HmacSHA1, SEED/CBC로 암호화 된다.

지원 알고리즘 : "SEED/CBC", "DES/CBC"

Parameters:: pbes - 대칭키 알고리즘

setPBES2Algorithm

public void setPBES2Algorithm(java.lang.String pbes)

PKCS#5 V2.0 방법을 이용하여 개인키를 암호화한다. 지정하지 않으면 V2.0의 HmacSHA1, SEED/CBC로 암호화 된다.

지원 알고리즘 : "SEED/CBC", "ARIA/CBC", "DESede/CBC", "DES/CBC"

Parameters:: pbes - 대칭키 알고리즘

setIterationCount

public void setIterationCount(int cnt)

키를 유도할때 사용되는 interation count 값을 지정한다. 지정하지 않으면 기본값 1024가 설정된다.

Parameters:: cnt - interation count

encrypt

public byte[] encrypt(PKCS8PrivateKeyInfo priKeyInfo)
               throws java.io.IOException,
                      AlgorithmException,
                      java.security.NoSuchAlgorithmException,
                      NoSuchModeException,
                      javax.crypto.NoSuchPaddingException,
                      java.security.NoSuchProviderException,
                      java.security.InvalidKeyException,
                      javax.crypto.BadPaddingException,
                      javax.crypto.IllegalBlockSizeException,
                      java.security.InvalidAlgorithmParameterException

개인키를 암호화한다.

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

decrypt

public PKCS8PrivateKeyInfo decrypt(byte[] encPriKey)
                            throws java.io.IOException,
                                   ParsingException,
                                   AlgorithmException,
                                   java.security.NoSuchAlgorithmException,
                                   javax.crypto.NoSuchPaddingException,
                                   java.security.NoSuchProviderException,
                                   NoSuchModeException,
                                   java.security.InvalidKeyException,
                                   ConfirmPasswordException,
                                   java.security.InvalidAlgorithmParameterException

암호화된 개인키를 복호화한다.

Parameters:: encPriKey - 암호화된 개인키
Returns:: 복호화된 개인키
Throws:: ConfirmPasswordException - 개인키 비밀번호가 틀린 경우에 발생; java.io.IOException - 암호화된 개인키 디코딩 실패 시 발생; ParsingException - 지원하지 않는 메시지 값이 존재할때 발생; java.security.NoSuchAlgorithmException - 지원하지 않는 알고리즘일 경우에 발생; javax.crypto.NoSuchPaddingException - 지원하지 않는 패딩 종류일 경우에 발생; NoSuchModeException - 지원하지 않는 암호 모드일 경우에 발생; java.security.NoSuchProviderException - 지원하지 않는 암호 모듈 제공자일 경우에 발생; java.security.InvalidKeyException - 알고리즘에 대한 적합한 키(잘못된 인코딩, 잘못된 길이, 초기화 되지 않음 등)가 아닌 경우에 발생; java.security.InvalidAlgorithmParameterException - 알고리즘 파라메터가 적합하지 않은 경우에 발생; AlgorithmException