Класс PBEKeySpec

java.lang.Object
- 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 битов каждого символа.

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

С:: 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()` Возвращает копию соли или null, если она не указана.

Методы, унаследованные от класса java.lang.Object

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

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

PBEKeySpec

public PBEKeySpec(char[] password)

Конструктор, принимающий пароль. Используется пустой массив char[], если указан null.

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

Параметры:: password - пароль.

PBEKeySpec

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

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

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

Параметры:: password - пароль.; salt - соль.; iterationCount - количество итераций.; keyLength - длина ключа для вывода.
Исключения:: NullPointerException - если salt равен null.; IllegalArgumentException - если salt пуст, т.е. длины 0, iterationCount или keyLength не положительны.

PBEKeySpec

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

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

Примечание: 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, если она не указана.

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

Возвращает:: длину ключа для вывода.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.