Класс KeyPairGenerator

public abstract class KeyPairGenerator extends KeyPairGeneratorSpi

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

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

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

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

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

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

  Если алгоритм — алгоритм DSA, а размер ключа (размер модуля) равен 512, 768, 1024 или 2048, то поставщик Sun использует набор предварительно вычисленных значений для p, q, и g параметров. Если размер модуля не равен одному из вышеперечисленных значений, поставщик Sun создает новый набор параметров. Другие поставщики могут иметь наборы предварительно вычисленных параметров для более чем только указанных выше размеров модуля. Другие вообще могут не иметь списка предварительно вычисленных параметров и всегда создавать новые наборы параметров.

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

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

В случае, если клиент не инициализирует KeyPairGenerator явно (через вызов метода initialize), каждый поставщик должен предоставить (и задокументировать) значения по умолчанию для инициализации. См. разделы с ограничениями на размер ключа в документе JDK Providers для получения информации о значениях по умолчанию KeyPairGenerator, используемых поставщиками JDK. Однако обратите внимание, что значения по умолчанию могут различаться между различными поставщиками. Кроме того, значение по умолчанию для поставщика может измениться в будущей версии. Поэтому рекомендуется явно инициализировать KeyPairGenerator, вместо того, чтобы полагаться на значения по умолчанию поставщиков.

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

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

• DiffieHellman (1024, 2048, 4096)
• DSA (1024, 2048)
• RSA (1024, 2048, 4096)

Эти алгоритмы описаны в разделе KeyPairGenerator спецификации Java Security Standard Algorithm Names. Обратитесь к документации выпуска вашей реализации, чтобы узнать, какие другие алгоритмы поддерживаются.