ru.CryptoPro.JCP.Key

Interface PrivateKeyInterface

All Superinterfaces:

java.lang.Cloneable, javax.security.auth.Destroyable, KeyInterface, java.security.spec.KeySpec

public interface PrivateKeyInterface
extends KeyInterface

Стандартный интерфейс представления в памяти закрытых ключей подписи и обмена.

See Also:

Key, KeyInterface

Version:2.0

Method Summary

Modifier and Type	Method and Description
void	addExtension(ru.CryptoPro.JCP.ASN.PKIX1Explicit88.Extension extension) Добавление расширения в header.
boolean	checkFP(byte[] checked, int checkLen) Проверка FP (для контейнеров версии 2) и открытого ключа (для версии 4).
SecretKeyInterface	doDHPhase(PublicKeyInterface publicKey, byte[] iv) Метод реализует одну фазу алгоритма обмена ключами Диффи - Хеллмана.
PublicKeyInterface	generatePublic() Создание открытого ключа, соответствующего данному закрытому.
ru.CryptoPro.JCP.ASN.PKIX1Explicit88.Extension	getExtension(com.objsys.asn1j.runtime.Asn1ObjectIdentifier id) Получение расширения из header.
ru.CryptoPro.JCP.ASN.PKIX1Explicit88.Extension[]	getExtensions() Получение списка расширений header.
boolean	isDhAllowed() Получение флага уведомления о возможности использовать ключ подписи для операций согласования.
boolean	isExportable() Получения флага возможности экспорта ключа.
boolean	isPreExportable() Получения флага возможности экспорта ключа после его сохранения.
boolean	isUserProtected() Получения флага уведомления об операции при доступе к ключу.
boolean	match(java.security.PublicKey publicKey) Проверка соответствия ключей.
boolean	match(java.security.PublicKey publicKey, java.lang.String provider) Проверка соответствия ключей.
void	setDhAllowed() Установка флага уведомления о возможности использовать ключ подписи для операций согласования.
void	setNotExportable() Установка флага неэкспортируемости ключа.
void	setNotWriteAvailable() Установка флага недопустимости записи ключа.
void	setUserProtected() Установка флага уведомления об операции при доступе к ключу.
ru.CryptoPro.JCP.Sign.SignValue	signature(byte[] hash) Создание подписи.
ru.CryptoPro.JCP.Sign.SignValue	signature(byte[] hash, int digestAlgId) Создание подписи.

Methods inherited from interface ru.CryptoPro.JCP.Key.KeyInterface

clear, clone, getParams, setParams

Methods inherited from interface javax.security.auth.Destroyable

destroy, isDestroyed

Method Detail

generatePublic

PublicKeyInterface generatePublic()
                           throws java.security.InvalidKeyException

Создание открытого ключа, соответствующего данному закрытому.

Returns:

открытый ключ

Throws:

java.security.InvalidKeyException

signature

ru.CryptoPro.JCP.Sign.SignValue signature(byte[] hash)
                                   throws java.security.SignatureException,
                                          java.security.InvalidKeyException

Создание подписи.

Parameters:

hash - значение хеша подписываемых данных

Returns:

объект подписи GostSignature

Throws:

java.security.SignatureException

java.security.InvalidKeyException

signature

ru.CryptoPro.JCP.Sign.SignValue signature(byte[] hash,
                                          int digestAlgId)
                                   throws java.security.SignatureException,
                                          java.security.InvalidKeyException

Создание подписи.

Parameters:

hash - значение хеша подписываемых данных

digestAlgId - идентификатор алгоритма хеширования

Returns:

объект подписи GostSignature

Throws:

java.security.SignatureException

java.security.InvalidKeyException

isExportable

boolean isExportable()

Получения флага возможности экспорта ключа.

Returns:

true - ключ экспортируемый, false - иначе.

isPreExportable

boolean isPreExportable()

Получения флага возможности экспорта ключа после его сохранения.

Returns:

true - ключ экспортируемый, false - иначе.

setNotExportable

void setNotExportable()

Установка флага неэкспортируемости ключа.

setNotWriteAvailable

void setNotWriteAvailable()

Установка флага недопустимости записи ключа.

isUserProtected

boolean isUserProtected()

Получения флага уведомления об операции при доступе к ключу.

Returns:

true - ключ userProtected, false - иначе.

setUserProtected

void setUserProtected()

Установка флага уведомления об операции при доступе к ключу.

isDhAllowed

boolean isDhAllowed()

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

Returns:

true - ключ dh_allowed, false - иначе.

addExtension

void addExtension(ru.CryptoPro.JCP.ASN.PKIX1Explicit88.Extension extension)

Добавление расширения в header.

Parameters:

extension - Расширение.

getExtension

ru.CryptoPro.JCP.ASN.PKIX1Explicit88.Extension getExtension(com.objsys.asn1j.runtime.Asn1ObjectIdentifier id)

Получение расширения из header.

Parameters:

id - Идентификатор расширения.

Returns:

расширение или null.

getExtensions

ru.CryptoPro.JCP.ASN.PKIX1Explicit88.Extension[] getExtensions()

Получение списка расширений header.

Returns:

список расширений или null.

setDhAllowed

void setDhAllowed()

Установка флага уведомления о возможности использовать ключ подписи для операций согласования.

doDHPhase

SecretKeyInterface doDHPhase(PublicKeyInterface publicKey,
                             byte[] iv)
                      throws java.security.InvalidKeyException,
                             java.security.KeyManagementException

Метод реализует одну фазу алгоритма обмена ключами Диффи - Хеллмана. На вход нужно подавать открытый ключ получателя и значение SV, передаваемое объекту KeyAgreement и используемое для усложнения ключа согласования. Результатом фазы является новый ключ согласования.

Parameters:

publicKey - - открытый ключ получателя

iv - - вектор инициализации

Returns:

- усложненный ключ согласования

Throws:

java.security.InvalidKeyException - в случае повреждения ключа. критическая ошибка.

java.security.KeyManagementException - в случае неправильной работы хранилища ключей.

match

boolean match(java.security.PublicKey publicKey)
       throws java.lang.Exception

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

Parameters:

publicKey - Открытый ключ для сравнения.

Returns:

результат проверки.

Throws:

java.lang.Exception

match

boolean match(java.security.PublicKey publicKey,
              java.lang.String provider)
       throws java.lang.Exception

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

Parameters:

publicKey - Открытый ключ для сравнения.

provider - Провайдер.

Returns:

результат проверки.

Throws:

java.lang.Exception

checkFP

boolean checkFP(byte[] checked,
                int checkLen)
         throws java.security.InvalidKeyException

Проверка FP (для контейнеров версии 2) и открытого ключа (для версии 4). Количество проверяемых байтов задается параметром.

Parameters:

checked - Проверямое FP.

checkLen - количество проверяемыз байт.

Returns:

Результат проверки.

Throws:

java.security.InvalidKeyException - - ключ искажен.