Класс KeyGenerator

public class KeyGenerator
extends Object

Этот класс предоставляет функциональность генератора секретных (симметричных) ключей.

Генераторы ключей создаются с помощью одного из методов класса getInstance.

Объекты KeyGenerator являются многоразовыми, т. е. после генерации ключа один и тот же объект KeyGenerator может быть повторно использован для генерации дополнительных ключей.

Существует два способа генерации ключа: независимый от алгоритма и зависящий от алгоритма. Единственное различие между ними заключается в инициализации объекта:

• Инициализация, независимая от алгоритма

  Все генераторы ключей используют понятия размер ключа и источник случайных чисел. В этом классе KeyGenerator есть метод init, который принимает эти два универсальных типа аргументов. Также есть метод, принимающий только аргумент keysize, и использующий реализацию SecureRandom поставщика с наивысшим приоритетом, установленного в системе (или системный источник случайных чисел, если ни один из установленных поставщиков не предоставляет реализацию SecureRandom), и один, принимающий только источник случайных чисел.

  Поскольку при вызове вышеперечисленных методов, независимых от алгоритма, init, другие параметры не указаны, то поставщик сам решает, как обработать любые алгоритм-специфические параметры (если таковые имеются) для каждого ключа.

• Инициализация, зависящая от алгоритма

  В ситуациях, когда уже существует набор параметров, специфичных для алгоритма, существуют два метода init, имеющие аргумент AlgorithmParameterSpec. Один также имеет аргумент SecureRandom, в то время как другой использует реализацию SecureRandom поставщика с наивысшим приоритетом (или системный источник случайных чисел, если ни один из установленных поставщиков не предоставляет реализацию SecureRandom).

В случае, если клиент не инициализирует KeyGenerator явно (через вызов метода init), каждый поставщик должен предоставить (и задокументировать) значения по умолчанию.

Каждая реализация Java платформы должна поддерживать следующие стандартные KeyGenerator алгоритмы с размерами ключей в скобках:

• AES (128)
• DES (56)
• DESede (168)
• HmacSHA1
• HmacSHA256

Эти алгоритмы описаны в разделе KeyGenerator документации по стандартным именам алгоритмов Java Cryptography Architecture. Обратитесь к документации выпуска вашей реализации, чтобы узнать, поддерживаются ли другие алгоритмы.

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

KeyGenerator

protected KeyGenerator(KeyGeneratorSpi keyGenSpi,
                       Provider provider,
                       String algorithm)

Создаёт объект KeyGenerator.

Параметры:

keyGenSpi - делегат

provider - провайдер

algorithm - алгоритм

Методы

getAlgorithm

public final String getAlgorithm()

Возвращает:

имя алгоритма этого объекта KeyGenerator.

getInstance

public static final KeyGenerator getInstance(String algorithm)
                                      throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма ключа. Сведения о стандартных именах алгоритмов см. в разделе KeyGenerator в документации Java Cryptography Architecture по стандартным именам алгоритмов.

Возвращает:

новый объект KeyGenerator.

Исключения:

NullPointerException - если указанный алгоритм равен null.

NoSuchAlgorithmException - если ни один провайдер не поддерживает реализацию KeyGeneratorSpi для указанного алгоритма.

См. также:

Provider

getInstance

public static final KeyGenerator getInstance(String algorithm,
                                             String provider)
                                      throws NoSuchAlgorithmException,
                                             NoSuchProviderException

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма ключа. Сведения о стандартных именах алгоритмов см. в разделе KeyGenerator в документации Java Cryptography Architecture по стандартным именам алгоритмов.

provider - имя провайдера.

Возвращает:

новый объект KeyGenerator.

Исключения:

NullPointerException - если указанный алгоритм равен null.

NoSuchAlgorithmException - если реализация KeyGeneratorSpi для указанного алгоритма недоступна от указанного провайдера.

NoSuchProviderException - если указанный провайдер не зарегистрирован в списке провайдеров безопасности.

IllegalArgumentException - если provider равен null или пуст.

См. также:

Provider

getInstance

public static final KeyGenerator getInstance(String algorithm,
                                             Provider provider)
                                      throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма ключа. Сведения о стандартных именах алгоритмов см. в разделе KeyGenerator в документации Java Cryptography Architecture по стандартным именам алгоритмов.

provider - провайдер.

Возвращает:

новый объект KeyGenerator.

Исключения:

NullPointerException - если указанный алгоритм равен null.

NoSuchAlgorithmException - если реализация KeyGeneratorSpi для указанного алгоритма недоступна от указанного объекта Provider.

IllegalArgumentException - если provider равен null.

См. также:

Provider

getProvider

public final Provider getProvider()

Возвращает провайдер этого объекта KeyGenerator.

Возвращает:

провайдер этого объекта KeyGenerator

init

public final void init(SecureRandom random)

Инициализирует этот генератор ключей.

Параметры:

random - источник случайности для этого генератора

init

public final void init(AlgorithmParameterSpec params)
                throws InvalidAlgorithmParameterException

Параметры:

params - параметры генерации ключа

Исключения:

InvalidAlgorithmParameterException - если заданные параметры неподходящие для этого генератора ключей

init

public final void init(AlgorithmParameterSpec params,
                       SecureRandom random)
                throws InvalidAlgorithmParameterException

Инициализирует этот генератор ключей заданным набором параметров и предоставленным пользователем источником случайности.

Параметры:

params - параметры генерации ключа

random - источник случайности для этого генератора ключей

Исключения:

InvalidAlgorithmParameterException - если params неподходящие для этого генератора ключей

init

public final void init(int keysize)

Параметры:

keysize - размер ключа. Это метрика, специфичная для алгоритма, указанная в количестве бит.

Исключения:

InvalidParameterException - если размер ключа неверен или не поддерживается.

init

public final void init(int keysize,
                       SecureRandom random)

Инициализирует этот генератор ключей для определённого размера ключа, используя предоставленный пользователем источник случайности.

Параметры:

keysize - размер ключа. Это метрика, специфичная для алгоритма, указанная в количестве бит.

random - источник случайности для этого генератора ключей

Исключения:

InvalidParameterException - если размер ключа неверен или не поддерживается.

generateKey

public final SecretKey generateKey()

Генерирует секретный ключ.

Возвращает:

новый ключ