Класс EncryptedPrivateKeyInfo

public class EncryptedPrivateKeyInfo
extends Object

Этот класс реализует тип EncryptedPrivateKeyInfo, как определено в PKCS #8.

Его определение в ASN.1 выглядит следующим образом:

EncryptedPrivateKeyInfo ::=  SEQUENCE {
     encryptionAlgorithm   AlgorithmIdentifier,
     encryptedData   OCTET STRING }

 AlgorithmIdentifier  ::=  SEQUENCE  {
     algorithm              OBJECT IDENTIFIER,
     parameters             ANY DEFINED BY algorithm OPTIONAL  }

Детали конструкторов

EncryptedPrivateKeyInfo

public EncryptedPrivateKeyInfo(byte[] encoded)
                        throws IOException

Создаёт (т.е. парсит) объект EncryptedPrivateKeyInfo из его кодировки ASN.1.

Параметры:

encoded - ASN.1 кодировка этого объекта. Содержимое массива копируется для защиты от последующих изменений.

Исключения:

NullPointerException - если encoded равно null.

IOException - если произошла ошибка при парсинге ASN.1 кодировки.

EncryptedPrivateKeyInfo

public EncryptedPrivateKeyInfo(String algName,
                               byte[] encryptedData)
                        throws NoSuchAlgorithmException

Параметры:

algName - имя алгоритма шифрования. См. Приложение А в Руководстве по архитектуре Java Cryptography для информации о стандартных именах алгоритмов шифрования.

encryptedData - зашифрованные данные. Содержимое encrypedData копируется для защиты от последующих изменений при создании этого объекта.

Исключения:

NullPointerException - если algName или encryptedData равно null.

IllegalArgumentException - если encryptedData пусто, т.е. имеет длину 0.

NoSuchAlgorithmException - если указанное имя algName не поддерживается.

EncryptedPrivateKeyInfo

public EncryptedPrivateKeyInfo(AlgorithmParameters algParams,
                               byte[] encryptedData)
                        throws NoSuchAlgorithmException

Создаёт объект EncryptedPrivateKeyInfo по параметрам алгоритма шифрования и зашифрованным данным.

Параметры:

algParams - параметры алгоритма шифрования. algParams.getEncoded() должен вернуть ASN.1 закодированные байты поля parameters компоненты AlgorithmIdentifer типа EncryptedPrivateKeyInfo.

encryptedData - зашифрованные данные. Содержимое encrypedData копируется для защиты от последующих изменений при создании этого объекта.

Исключения:

NullPointerException - если algParams или encryptedData равно null.

IllegalArgumentException - если encryptedData пусто, т.е. имеет длину 0.

NoSuchAlgorithmException - если указанное имя algName указанных параметров algParams не поддерживается.

Детали методов

getAlgName

public String getAlgName()

Возвращает:

имя алгоритма шифрования.

getAlgParameters

public AlgorithmParameters getAlgParameters()

Возвращает параметры алгоритма, используемые алгоритмом шифрования.

Возвращает:

параметры алгоритма.

getEncryptedData

public byte[] getEncryptedData()

Возвращает зашифрованные данные.

Возвращает:

зашифрованные данные. Каждый раз при вызове этого метода возвращается новый массив.

getKeySpec

public PKCS8EncodedKeySpec getKeySpec(Cipher cipher)
                               throws InvalidKeySpecException

Извлекает объект PKCS8EncodedKeySpec из зашифрованных данных и возвращает его.
Примечание: Для успешного извлечения объекта PKCS8EncodedKeySpec, cipher должен быть инициализирован либо в режиме Cipher.DECRYPT_MODE, либо Cipher.UNWRAP_MODE, с тем же ключом и параметрами, которые использовались для создания зашифрованных данных.

Параметры:

cipher - инициализированный объект шифра, который будет использоваться для дешифрования зашифрованных данных.

Возвращает:

объект PKCS8EncodedKeySpec.

Исключения:

NullPointerException - если cipher равно null.

InvalidKeySpecException - если данный шифр непригоден для зашифрованных данных или зашифрованные данные повреждены и не могут быть расшифрованы.

getKeySpec

public PKCS8EncodedKeySpec getKeySpec(Key decryptKey)
                               throws NoSuchAlgorithmException,
                                      InvalidKeyException

Извлекает объект PKCS8EncodedKeySpec из зашифрованных данных и возвращает его.

Параметры:

decryptKey - ключ, используемый для дешифрования зашифрованных данных.

Возвращает:

объект PKCS8EncodedKeySpec.

Исключения:

NullPointerException - если decryptKey равно null.

NoSuchAlgorithmException - если не удается найти подходящий шифр для дешифрования зашифрованных данных.

InvalidKeyException - если decryptKey не может быть использован для дешифрования зашифрованных данных или результат дешифрования не является допустимым PKCS8KeySpec.

Since:

1.5

getKeySpec

public PKCS8EncodedKeySpec getKeySpec(Key decryptKey,
                                      String providerName)
                               throws NoSuchProviderException,
                                      NoSuchAlgorithmException,
                                      InvalidKeyException

Извлекает объект PKCS8EncodedKeySpec из зашифрованных данных и возвращает его.

Параметры:

decryptKey - ключ, используемый для дешифрования зашифрованных данных.

providerName - имя провайдера, чья реализация Cipher будет использоваться.

Возвращает:

объект PKCS8EncodedKeySpec.

Исключения:

NullPointerException - если decryptKey или providerName равно null.

NoSuchProviderException - если провайдер providerName не зарегистрирован.

NoSuchAlgorithmException - если не удается найти подходящий шифр для дешифрования зашифрованных данных.

InvalidKeyException - если decryptKey не может быть использован для дешифрования зашифрованных данных или результат дешифрования не является допустимым PKCS8KeySpec.

Since:

1.5

getKeySpec

public PKCS8EncodedKeySpec getKeySpec(Key decryptKey,
                                      Provider provider)
                               throws NoSuchAlgorithmException,
                                      InvalidKeyException

Извлекает объект PKCS8EncodedKeySpec из зашифрованных данных и возвращает его.

Параметры:

decryptKey - ключ, используемый для дешифрования зашифрованных данных.

provider - имя провайдера, чья реализация Cipher будет использоваться.

Возвращает:

объект PKCS8EncodedKeySpec.

Исключения:

NullPointerException - если decryptKey или provider равно null.

NoSuchAlgorithmException - если не удается найти подходящий шифр для дешифрования зашифрованных данных в provider.

InvalidKeyException - если decryptKey не может быть использован для дешифрования зашифрованных данных или результат дешифрования не является допустимым PKCS8KeySpec.

Since:

1.5

getEncoded

public byte[] getEncoded()
                  throws IOException

Возвращает ASN.1 кодировку этого объекта.

Возвращает:

ASN.1 кодировка. Каждый раз при вызове этого метода возвращается новый массив.

Исключения:

IOException - если произошла ошибка при построении ASN.1 кодировки.