javax.crypto

Класс KeyAgreementSpi

java.lang. Объект

javax.crypto. KeyAgreementSpi

public abstract class KeyAgreementSpi
extends Object

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

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

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

С тех пор:

1.4

См. Также:

KeyGenerator, SecretKey

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

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

Конструктор и Описание
KeyAgreementSpi()

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

Модификатор и Тип	Метод и Описание
protected abstract Key	engineDoPhase(Key key, boolean lastPhase) Выполняет следующую фазу этого согласования ключей с данным ключом, который был получен от одной из других сторон, включенных в это согласование ключей.
protected abstract byte[]	engineGenerateSecret() Генерирует совместно используемый секрет и возвращает это в новом буфере.
protected abstract int	engineGenerateSecret(byte[] sharedSecret, int offset) Генерирует совместно используемый секрет, и помещает это в буфер sharedSecret, начало в offset включительно.
protected abstract SecretKey	engineGenerateSecret(String algorithm) Создает совместно используемый секрет и возвращает это как объект секретного ключа требуемого типа алгоритма.
protected abstract void	engineInit(Key key, AlgorithmParameterSpec params, SecureRandom random) Инициализирует это согласование ключей с данным ключом, набором параметров алгоритма, и источником случайности.
protected abstract void	engineInit(Key key, SecureRandom random) Инициализирует это согласование ключей с данным ключом и источником случайности.

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

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

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

KeyAgreementSpi

public KeyAgreementSpi()

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

engineInit

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

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

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

Параметры:

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

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

Броски:

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

engineInit

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

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

Параметры:

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

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

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

Броски:

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

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

engineDoPhase

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

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

Параметры:

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

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

Возвраты:

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

Броски:

InvalidKeyException - если данный ключ является несоответствующим для этой фазы.

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

engineGenerateSecret

protected abstract byte[] engineGenerateSecret()
                                        throws IllegalStateException

Генерирует совместно используемый секрет и возвращает это в новом буфере.

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

Возвраты:

новый буфер с совместно используемым секретом

Броски:

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

engineGenerateSecret

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

Генерирует совместно используемый секрет, и помещает это в буфер sharedSecret, начало в offset включительно.

Если sharedSecret буфер является слишком маленьким, чтобы содержать результат, a ShortBufferException бросается. В этом случае этот вызов должен быть повторен с большим буфером вывода.

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

Параметры:

sharedSecret - буфер для совместно используемого секрета

offset - смещение в sharedSecret где совместно используемый секрет будет сохранен

Возвраты:

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

Броски:

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

ShortBufferException - если данный буфер вывода является слишком небольшим, чтобы содержать секрет

engineGenerateSecret

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

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

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

Параметры:

algorithm - требуемый алгоритм секретного ключа

Возвраты:

совместно используемый секретный ключ

Броски:

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

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

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