javax.crypto

Класс KeyGenerator

java.lang. Объект

javax.crypto. KeyGenerator

public class KeyGenerator
extends Object

Этот class обеспечивает функциональность секретного (симметричного) ключевого генератора.

Ключевые генераторы создаются, используя один из getInstance Методы class этого class.

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

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

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

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

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

• Специфичная для алгоритма Инициализация

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

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

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

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

Эти алгоритмы описываются в разделе KeyGenerator Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java. Консультируйтесь с документацией выпуска для своей реализации, чтобы видеть, поддерживаются ли какие-либо другие алгоритмы.

С тех пор:

1.4

См. Также:

SecretKey

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

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

Модификатор	Конструктор и Описание
protected	KeyGenerator(KeyGeneratorSpi keyGenSpi, Provider provider, String algorithm) Создает объект KeyGenerator.

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

Модификатор и Тип	Метод и Описание
SecretKey	generateKey() Генерирует секретный ключ.
Строка	getAlgorithm() Возвращает имя алгоритма этого KeyGenerator объект.
static KeyGenerator	getInstance(String algorithm) Возвраты a KeyGenerator объект, который генерирует секретные ключи для указанного алгоритма.
static KeyGenerator	getInstance(String algorithm, Provider provider) Возвраты a KeyGenerator объект, который генерирует секретные ключи для указанного алгоритма.
static KeyGenerator	getInstance(String algorithm, String provider) Возвраты a KeyGenerator объект, который генерирует секретные ключи для указанного алгоритма.
Провайдер	getProvider() Возвращает провайдера этого KeyGenerator объект.
void	init(AlgorithmParameterSpec params) Инициализирует этот ключевой генератор с указанным набором параметра.
void	init(AlgorithmParameterSpec params, SecureRandom random) Инициализирует этот ключевой генератор с указанным набором параметра и предоставленным пользователем источником случайности.
void	init(int keysize) Инициализирует этот ключевой генератор для определенного размера ключа.
void	init(int keysize, SecureRandom random) Инициализирует этот ключевой генератор для определенного размера ключа, используя предоставленный пользователем источник случайности.
void	init(SecureRandom random) Инициализирует этот ключевой генератор.

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

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

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

KeyGenerator

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

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

Параметры:

keyGenSpi - делегат

provider - провайдер

algorithm - алгоритм

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

getAlgorithm

public final String getAlgorithm()

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

Это - то же самое имя, которое было определено в одном из getInstance вызовы, которые создали это KeyGenerator объект.

Возвраты:

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

getInstance

public static final KeyGenerator getInstance(String algorithm)
                                      throws NoSuchAlgorithmException

Возвраты a KeyGenerator объект, который генерирует секретные ключи для указанного алгоритма.

Этот метод пересекает список зарегистрированных поставщиков систем обеспечения безопасности, запускающихся с самого привилегированного Провайдера. Возвращается новый объект KeyGenerator инкапсуляция реализации KeyGeneratorSpi от первого Провайдера, который поддерживает указанный алгоритм.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - стандартное имя требуемого ключевого алгоритма. См. раздел KeyGenerator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

Возвраты:

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

Броски:

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

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

См. Также:

Provider

getInstance

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

Возвраты a KeyGenerator объект, который генерирует секретные ключи для указанного алгоритма.

Возвращается новый объект KeyGenerator инкапсуляция реализации KeyGeneratorSpi от указанного провайдера. Указанный провайдер должен быть зарегистрирован в списке поставщика систем обеспечения безопасности.

Отметьте, что список зарегистрированных провайдеров может быть получен через Security.getProviders() метод.

Параметры:

algorithm - стандартное имя требуемого ключевого алгоритма. См. раздел KeyGenerator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

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

Возвраты:

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

Броски:

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

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

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

IllegalArgumentException - если provider нуль или пустой.

См. Также:

Provider

getInstance

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

Возвраты a KeyGenerator объект, который генерирует секретные ключи для указанного алгоритма.

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

Параметры:

algorithm - стандартное имя требуемого ключевого алгоритма. См. раздел KeyGenerator в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах алгоритма.

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

Возвраты:

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

Броски:

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

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

IllegalArgumentException - если provider нуль.

См. Также:

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

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

Если этот ключевой генератор потребует каких-либо случайных байтов, то это получит их использующий SecureRandom реализация самого высокого приоритета установленный провайдер как источник случайности. (Если ни один из установленных провайдеров не предоставит реализацию SecureRandom, то обеспеченный системой источник случайности будет использоваться.)

Параметры:

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

Броски:

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

init

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

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

Параметры:

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

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

Броски:

InvalidAlgorithmParameterException - если params является несоответствующим для этого ключевого генератора

init

public final void init(int keysize)

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

Если этот ключевой генератор потребует каких-либо случайных байтов, то это получит их использующий SecureRandom реализация самого высокого приоритета установленный провайдер как источник случайности. (Если ни один из установленных провайдеров не предоставит реализацию SecureRandom, то обеспеченный системой источник случайности будет использоваться.)

Параметры:

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

Броски:

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

init

public final void init(int keysize,
                       SecureRandom random)

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

Параметры:

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

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

Броски:

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

generateKey

public final SecretKey generateKey()

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

Возвраты:

новый ключ