javax.crypto.spec

Класс PBEKeySpec

java.lang. Объект

javax.crypto.spec. PBEKeySpec

Все Реализованные Интерфейсы:

KeySpec

public class PBEKeySpec
extends Object
implements KeySpec

Выбранный пользователем пароль, который может использоваться с основанным на пароле шифрованием (PBE).

Пароль может быть просмотрен как некоторый необработанный ключевой материал, от который механизм шифрования, который использует это, получает криптографический ключ.

Различные механизмы PBE могут использовать различные биты каждого символа пароля. Например, механизм PBE, определенный в PKCS #5, смотрит только на младший разряд 8 битов каждого символа, тогда как PKCS #12 смотрит на все 16 битов каждого символа.

Вы преобразовываете символы пароля в ключ PBE, создавая экземпляр соответствующей фабрики секретного ключа. Например, фабрика секретного ключа для PKCS #5 создаст ключ PBE из только младшего разряда 8 битов каждого символа пароля, тогда как фабрика секретного ключа для PKCS #12 возьмет все 16 битов каждого символа.

Также отметьте, что этот class хранит пароли, поскольку случайная работа выстраивает вместо String объекты (который казался бы более логичным), потому что Строка class является неизменной и нет никакого способа перезаписать его внутреннее значение, когда пароль, сохраненный в этом, больше не необходим. Следовательно, этот class запрашивает пароль как массив случайной работы, таким образом, это может быть перезаписано когда сделано.

С тех пор:

1.4

См. Также:

SecretKeyFactory, PBEParameterSpec

Сводка конструктора

Конструкторы

Конструктор и Описание
PBEKeySpec(char[] password) Конструктор, который берет пароль.
PBEKeySpec(char[] password, byte[] salt, int iterationCount) Конструктор, который берет пароль, соль, итеративный счет для генерирования PBEKey шифров PBE фиксированного размера ключа.
PBEKeySpec(char[] password, byte[] salt, int iterationCount, int keyLength) Конструктор, который берет пароль, соль, итеративное количество, и будущим образом полученную длину ключа для того, чтобы генерировать PBEKey шифров PBE переменного размера ключа.

Сводка метода

Модификатор и Тип	Метод и Описание
void	clearPassword() Очищает внутреннюю копию пароля.
int	getIterationCount() Возвращает итеративное количество или 0 если не определенный.
int	getKeyLength() Возвращает будущим образом полученную длину ключа или 0 если не определенный.
char[]	getPassword() Возвращает копию пароля.
byte[]	getSalt() Возвращает копию соли или нуля если не определенный.

Методы, наследованные от class java.lang. Объект

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

Деталь конструктора

PBEKeySpec

public PBEKeySpec(char[] password)

Конструктор, который берет пароль. Пустая случайная работа [] используется, если нуль определяется.

Отметьте: password клонируется прежде, чем это будет сохранено в новом PBEKeySpec объект.

Параметры:

password - пароль.

PBEKeySpec

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

Конструктор, который берет пароль, соль, итеративное количество, и будущим образом полученную длину ключа для того, чтобы генерировать PBEKey шифров PBE переменного размера ключа. Пустая случайная работа [] используется, если нуль определяется для password.

Отметьте: password и salt клонируются прежде, чем они будут сохранены в новом PBEKeySpec объект.

Параметры:

password - пароль.

salt - соль.

iterationCount - итеративное количество.

keyLength - будущим образом полученная длина ключа.

Броски:

NullPointerException - если salt нуль.

IllegalArgumentException - если salt пусто, то есть 0-длиной, iterationCount или keyLength не положительно.

PBEKeySpec

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

Конструктор, который берет пароль, соль, итеративный счет для генерирования PBEKey шифров PBE фиксированного размера ключа. Пустая случайная работа [] используется, если нуль определяется для password.

Отметьте: password и salt клонируются прежде, чем они будут сохранены в новом PBEKeySpec объект.

Параметры:

password - пароль.

salt - соль.

iterationCount - итеративное количество.

Броски:

NullPointerException - если salt нуль.

IllegalArgumentException - если salt пусто, то есть 0-длиной, или iterationCount не положительно.

Деталь метода

clearPassword

public final void clearPassword()

Очищает внутреннюю копию пароля.

getPassword

public final char[] getPassword()

Возвращает копию пароля.

Отметьте: этот метод возвращает копию пароля. Это - обязанность вызывающей стороны обнулить информацию о пароле после того, как это больше не необходимо.

Возвраты:

пароль.

Броски:

IllegalStateException - если пароль был очищен, вызывая clearPassword метод.

getSalt

public final byte[] getSalt()

Возвращает копию соли или нуля если не определенный.

Отметьте: этот метод должен возвратить копию соли. Это - обязанность вызывающей стороны обнулить соленую информацию после того, как это больше не необходимо.

Возвраты:

соль.

getIterationCount

public final int getIterationCount()

Возвращает итеративное количество или 0 если не определенный.

Возвраты:

итеративное количество.

getKeyLength

public final int getKeyLength()

Возвращает будущим образом полученную длину ключа или 0 если не определенный.

Отметьте: это используется, чтобы указать на предпочтение на длине ключа для шифров переменного размера ключа. Фактический размер ключа зависит от реализации каждого провайдера.

Возвраты:

будущим образом полученная длина ключа.