Класс 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 для получения информации о значениях по умолчанию, используемых поставщиками JDK. Однако обратите внимание, что значения по умолчанию могут различаться между разными поставщиками. Кроме того, значение по умолчанию для поставщика может измениться в будущих версиях. Поэтому рекомендуется явно инициализировать KeyPairGenerator вместо того, чтобы полагаться на значения по умолчанию, специфичные для поставщика.

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

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

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

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