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 비트만을 사용해,#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를 생성하기 위한 반복수를 취하는 생성자 입니다.

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

메서드 개요

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를 생성하기 위해서 파생되는 키의 길이를 취하는 생성자 입니다. 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를 생성하기 위한 반복수를 취하는 생성자 입니다. 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을 리턴합니다.

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

반환값:

파생되는 키의 길이