Интерфейс DSAKeyPairGenerator

public interface DSAKeyPairGenerator

Интерфейс объекта, способного генерировать пары ключей DSA.

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

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

1. Получают генератор пар ключей для алгоритма DSA, вызвав метод KeyPairGenerator getInstance с аргументом "DSA".
2. Проверяют, является ли возвращённый генератор пар ключей экземпляром DSAKeyPairGenerator, прежде чем привести результат к типу DSAKeyPairGenerator и вызвать один из методов initialize из этого интерфейса DSAKeyPairGenerator.
3. Генерируют пару ключей, вызвав метод generateKeyPair класса KeyPairGenerator.

Примечание: не всегда необходимо выполнять инициализацию, специфичную для алгоритма, для генератора пар ключей DSA. То есть, не всегда необходимо вызывать метод initialize в этом интерфейсе. Достаточно выполнить инициализацию, независимую от алгоритма, с помощью метода initialize в интерфейсе KeyPairGenerator, если вы принимаете значения по умолчанию для параметров, специфичных для алгоритма.

Примечание: некоторые более ранние реализации этого интерфейса могут не поддерживать большие значения параметров DSA, такие как 3072-битные.

Методы

initialize

void initialize(DSAParams params,
                SecureRandom random)
         throws InvalidParameterException

Инициализирует генератор пар ключей, используя параметры семейства DSA (p, q и g) и необязательный источник случайных битов SecureRandom. Если необходим источник случайных битов SecureRandom, но он не предоставлен (т.е. null), будет использован по умолчанию SecureRandom.

Параметры:

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

random - источник случайных битов для генерации битов ключа; может быть null.

Исключения:

InvalidParameterException - если значение params является недопустимым, null или не поддерживается.

initialize

void initialize(int modlen,
                boolean genParams,
                SecureRandom random)
         throws InvalidParameterException

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

Если genParams равно true, этот метод генерирует новые параметры p, q и g. Если оно равно false, метод использует предварительно вычисленные параметры для запрошенной длины модуля. Если для этой длины модуля нет предварительно вычисленных параметров, будет выброшено исключение.

Параметры:

modlen - длина модуля в битах. Допустимые значения — любые кратные 64 от 512 до 1024 включительно, 2048 и 3072.

random - источник случайных битов для генерации битов ключа; может быть null.

genParams - флаг, указывающий, нужно ли генерировать новые параметры для запрошенной длины модуля.

Исключения:

InvalidParameterException - если modlen является недопустимым или не поддерживается, или если genParams равно false и нет предварительно вычисленных параметров для запрошенной длины модуля.