javax.crypto.spec
클래스 PBEKeySpec

java.lang.Object 
  |
  +--javax.crypto.spec.PBEKeySpec

모든 구현 인터페이스:

KeySpec

public class PBEKeySpec

extends Object

implements KeySpec

패스워드 베이스의 암호화 (PBE)로 사용할 수 있는 유저가 선택한 패스워드입니다.

패스워드는 일종의 생의열쇠 데이터라고 볼 수가 있습니다. 패스워드를 사용하는 암호화 기구는 열쇠 데이터로부터 암호화열쇠를 파생합니다.

PBE 기구가 다르면(자), 각 패스워드 캐릭터의 비트수도 다른 경우가 있습니다. 예를 들어,「PKCS #5」로 정의되고 있는 PBE 기구는 각 캐릭터의 하위 8 비트만을 사용해,「PKCS #12」에서는 각 캐릭터의 16 비트 모든 것을 사용합니다.

해당하는 비밀열쇠 팩토리의 인스턴스를 생성해, 패스워드 캐릭터를 PBE 열쇠로 변환합니다. 예를 들어, PKCS #5 의 비밀열쇠 팩토리는 각 패스워드 캐릭터의 하위 8 비트만으로부터 PBE 열쇠를 구축해, PKCS #12 의 비밀열쇠 팩토리는 각 캐릭터의 16 비트 모든 것을 취합니다.

또, 이 클래스는 패스워드를 String 오브젝트 (이것이 논리적으로 생각될지도 모른다)는 아니고 char 배열로서 저장합니다. 이것은 String 클래스는 변경 불가능해서, 저장되고 있는 패스워드가 필요없게 되었을 때에 내부치를 덧쓰기할 방법이 없기 때문입니다. 즉, 이 클래스는 패스워드를 char 배열로서 요구하므로, 완료시에 덧쓰기할 수 있습니다.

도입된 버젼:

1.4

관련 항목:

SecretKeyFactory , PBEParameterSpec

생성자의 개요

PBEKeySpec (char[] password)
패스워드를 취하는 콘스트라타입니다.

PBEKeySpec (char[] password, byte[] salt, int iterationCount)
패스워드, 소금, 및 고정열쇠 사이즈의 PBE 암호의 PBEKey 를 생성하기 위한 반복수를 취하는 constructor 입니다.

PBEKeySpec (char[] password, byte[] salt, int iterationCount, int keyLength)
패스워드, 소금, 반복수, 및 가변열쇠 사이즈의 PBE 암호의 PBEKey 를 생성하기 위해서 파생되는 열쇠의 길이를 취하는 constructor 입니다.

메소드의 개요

void	clearPassword () 패스워드의 내부 카피를 클리어 합니다.
int	getIterationCount () 반복수를 돌려줍니다.
int	getKeyLength () 파생되는 열쇠의 길이를 돌려줍니다.
char[]	getPassword () 패스워드의 카피를 돌려줍니다.
byte[]	getSalt () 소금의 카피를 돌려줍니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

PBEKeySpec

public PBEKeySpec(char[] password)

패스워드를 취하는 콘스트라타입니다. null 가 지정되었을 경우는 하늘의 char[] 가 사용됩니다.

주: password 는 복제되고 나서 새로운 PBEKeySpec 오브젝트에 저장됩니다.

파라미터:

password - 패스워드

PBEKeySpec

public PBEKeySpec(char[] password,
                  byte[] salt,
                  int iterationCount,
                  int keyLength)

패스워드, 소금, 반복수, 및 가변열쇠 사이즈의 PBE 암호의 PBEKey 를 생성하기 위해서 파생되는 열쇠의 길이를 취하는 constructor 입니다. password 에 null 가 지정되었을 경우는 하늘의 char[] 가 사용됩니다.

주: password 및 salt 는 복제되고 나서 새로운 PBEKeySpec 오브젝트에 저장됩니다.

파라미터:

password - 패스워드

salt - 소금

iterationCount - 반복수

keyLength - 파생되는 열쇠의 길이

예외:

NullPointerException - salt 가 null 의 경우

IllegalArgumentException - salt 가 하늘, 즉 길이 0 인 경우, 혹은 iterationCount 또는 keyLength 가 정이 아닌 경우

PBEKeySpec

public PBEKeySpec(char[] password,
                  byte[] salt,
                  int iterationCount)

패스워드, 소금, 및 고정열쇠 사이즈의 PBE 암호의 PBEKey 를 생성하기 위한 반복수를 취하는 constructor 입니다. password 에 null 가 지정되었을 경우는 하늘의 char[] 가 사용됩니다.

주: password 및 salt 는 복제되고 나서 새로운 PBEKeySpec 오브젝트에 저장됩니다.

파라미터:

password - 패스워드

salt - 소금

iterationCount - 반복수

예외:

NullPointerException - salt 가 null 의 경우

IllegalArgumentException - salt 가 하늘, 즉 길이 0 인 경우, 또는 iterationCount 가 정이 아닌 경우

메소드의 상세

clearPassword

public final void clearPassword()

패스워드의 내부 카피를 클리어 합니다.

getPassword

public final char[] getPassword()

패스워드의 카피를 돌려줍니다.

주: 이 메소드는 패스워드의 카피를 돌려줍니다. 불필요하게 된 패스워드 정보를 제로로 하는 (소거한다) 것은 호출측의 책임입니다.

반환값:

패스워드

예외:

IllegalStateException - clearPassword 메소드를 호출해 패스워드가 클리어 되었을 경우

getSalt

public final byte[] getSalt()

소금의 카피를 돌려줍니다. 지정되어 있지 않은 경우는 null 를 돌려줍니다.

주: 이 메소드는 소금의 카피를 돌려줍니다. 불필요하게 된 소금 정보를 제로로 하는 (소거한다) 것은 호출측의 책임입니다.

반환값:

소금

getIterationCount

public final int getIterationCount()

반복수를 돌려줍니다. 지정되어 있지 않은 경우는 0 을 돌려줍니다.

반환값:

반복수

getKeyLength

public final int getKeyLength()

파생되는 열쇠의 길이를 돌려줍니다. 지정되어 있지 않은 경우는 0 을 돌려줍니다.

주: 이것은 가변열쇠 사이즈 암호의 열쇠의 길이의 설정을 나타내는데 사용됩니다. 실제의 열쇠 사이즈는 각 프로바이더의 구현에 따라서 다릅니다.

반환값:

파생되는 열쇠의 길이