Класс KeyAgreementSpi

public abstract class KeyAgreementSpi
extends Object

Этот класс определяет Интерфейс поставщика сервисов (SPI) для класса KeyAgreement. Все абстрактные методы в этом классе должны быть реализованы каждым поставщиком криптографических сервисов, желающим предоставить реализацию конкретного алгоритма согласования ключей.

Ключи, участвующие в установлении общего секрета, создаются одним из генераторов ключей (KeyPairGenerator или KeyGenerator), KeyFactory, или в результате промежуточной фазы протокола согласования ключей (engineDoPhase).

Для каждого из корреспондентов в обмене ключами необходимо вызвать engineDoPhase. Например, если обмен ключами происходит с одной другой стороной, нужно вызвать engineDoPhase один раз, установив флаг lastPhase в значение true. Если обмен ключами происходит с двумя другими сторонами, необходимо вызвать engineDoPhase дважды, первый раз установив флаг lastPhase в значение false, а второй раз — в значение true. Может быть любое количество сторон, участвующих в обмене ключами.

Подробное описание конструкторов

KeyAgreementSpi

public KeyAgreementSpi()

Подробное описание методов

engineInit

protected abstract void engineInit(Key key,
                                   SecureRandom random)
                            throws InvalidKeyException

Параметры:

key - приватная информация стороны. Например, в случае согласования ключей Диффи-Хеллмана, это собственный приватный ключ Диффи-Хеллмана стороны.

random - источник случайных чисел

Исключения:

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

engineInit

protected abstract void engineInit(Key key,
                                   AlgorithmParameterSpec params,
                                   SecureRandom random)
                            throws InvalidKeyException,
                                   InvalidAlgorithmParameterException

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

Параметры:

key - приватная информация стороны. Например, в случае согласования ключей Диффи-Хеллмана, это собственный приватный ключ Диффи-Хеллмана стороны.

params - параметры согласования ключей

random - источник случайных чисел

Исключения:

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

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

engineDoPhase

protected abstract Key engineDoPhase(Key key,
                                     boolean lastPhase)
                              throws InvalidKeyException,
                                     IllegalStateException

Выполняет следующую фазу согласования ключей с заданным ключом, полученным от одной из других сторон, участвующих в этом согласовании ключей.

Параметры:

key - ключ для этой фазы. Например, в случае Диффи-Хеллмана между 2 сторонами, это публичный ключ Диффи-Хеллмана другой стороны.

lastPhase - флаг, указывающий, является ли это последняя фаза этого согласования ключей.

Возвращаемое значение:

результирующий (промежуточный) ключ этой фазы или null, если эта фаза не возвращает ключ

Исключения:

InvalidKeyException - если заданный ключ не подходит для этой фазы.

IllegalStateException - если это согласование ключей не было инициализировано.

engineGenerateSecret

protected abstract byte[] engineGenerateSecret()
                                        throws IllegalStateException

Возвращаемое значение:

новый буфер с общим секретом

Исключения:

IllegalStateException - если это согласование ключей еще не завершено

engineGenerateSecret

protected abstract int engineGenerateSecret(byte[] sharedSecret,
                                            int offset)
                                     throws IllegalStateException,
                                            ShortBufferException

Параметры:

sharedSecret - буфер для общего секрета

offset - смещение в sharedSecret, где будет храниться общий секрет

Возвращаемое значение:

количество байтов, помещённых в sharedSecret

Исключения:

IllegalStateException - если это согласование ключей еще не завершено

ShortBufferException - если заданный буфер вывода слишком мал для хранения секрета

engineGenerateSecret

protected abstract SecretKey engineGenerateSecret(String algorithm)
                                           throws IllegalStateException,
                                                  NoSuchAlgorithmException,
                                                  InvalidKeyException

Параметры:

algorithm - запрашиваемый алгоритм секретного ключа

Возвращаемое значение:

секретный ключ общего секрета

Исключения:

IllegalStateException - если это согласование ключей ещё не завершено

NoSuchAlgorithmException - если запрашиваемый алгоритм секретного ключа недоступен

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