Класс Cipher

public static final int ENCRYPT_MODE

См. также:

• Значения константных полей

public static final int DECRYPT_MODE

См. также:

• Значения константных полей

public static final int WRAP_MODE

См. также:

• Значения константных полей

public static final int UNWRAP_MODE

См. также:

• Значения константных полей

public static final int PUBLIC_KEY

См. также:

• Значения константных полей

public static final int PRIVATE_KEY

См. также:

• Значения константных полей

public static final int SECRET_KEY

См. также:

• Значения константных полей

protected Cipher(CipherSpi cipherSpi, Provider provider, String transformation)

Параметры:

cipherSpi — делегат

provider — поставщик

transformation — преобразование

Выбрасывает:

NullPointerException — если provider имеет значение null

IllegalArgumentException — если переданные аргументы признаны недопустимыми для создания объекта Cipher

public static final Cipher getInstance(String transformation) throws NoSuchAlgorithmException, NoSuchPaddingException

Примечание к API:

Рекомендуется использовать преобразование, в котором полностью указаны алгоритм, режим и схема дополнения. В противном случае поставщик будет использовать значения режима и схемы дополнения по умолчанию, которые могут не соответствовать требованиям безопасности вашего приложения.

Примечание по реализации:

Эталонная реализация JDK дополнительно использует следующие свойства безопасности:

• свойство jdk.security.provider.preferred Security для определения предпочтительного порядка поставщиков для указанного алгоритма. Он может отличаться от порядка поставщиков, возвращаемых методом Security.getProviders(). См. также раздел «Преобразования Cipher» документа Поставщики JDK, где приведены сведения о значениях преобразования по умолчанию, используемых поставщиками JDK.
• свойство jdk.crypto.disabledAlgorithms Security для определения, разрешён ли указанный алгоритм. Если задано значение jdk.crypto.disabledAlgorithms, оно имеет приоритет над значением свойства безопасности.

Параметры:

transformation — имя преобразования, например AES/CBC/PKCS5Padding. Сведения о стандартных именах преобразований см. в разделе Cipher спецификации стандартных имён алгоритмов безопасности Java.

Возвращает:

объект Cipher, реализующий запрошенное преобразование

Выбрасывает:

NoSuchAlgorithmException — если transformation имеет значение null, пуст или имеет недопустимый формат; либо если реализация CipherSpi не найдена или найдена, но не поддерживает режим

NoSuchPaddingException — если реализация CipherSpi найдена, но не поддерживает схему дополнения

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

См. также:

• Provider

public static final Cipher getInstance(String transformation, String provider) throws NoSuchAlgorithmException, NoSuchProviderException, NoSuchPaddingException

Примечание к API:

Рекомендуется использовать преобразование, в котором полностью указаны алгоритм, режим и схема дополнения. В противном случае поставщик будет использовать значения режима и схемы дополнения по умолчанию, которые могут не соответствовать требованиям безопасности вашего приложения.

Примечание по реализации:

Сведения о значениях преобразования по умолчанию, используемых поставщиками JDK, см. в разделе «Преобразования Cipher» документа Поставщики JDK. Эталонная реализация JDK дополнительно использует свойство jdk.crypto.disabledAlgorithms Security для определения, разрешён ли указанный алгоритм. Если задано значение jdk.crypto.disabledAlgorithms, оно имеет приоритет над значением свойства безопасности.

Параметры:

transformation — имя преобразования, например AES/CBC/PKCS5Padding. Сведения о стандартных именах преобразований см. в разделе Cipher спецификации стандартных имён алгоритмов безопасности Java.

provider — имя поставщика

Возвращает:

объект Cipher, реализующий запрошенное преобразование

Выбрасывает:

IllegalArgumentException — если provider имеет значение null или пуст

NoSuchAlgorithmException — если transformation имеет значение null, пуст или имеет недопустимый формат; либо если реализация CipherSpi указанного provider не найдена или найдена, но не поддерживает режим

NoSuchPaddingException — если реализация CipherSpi указанного provider найдена, но не поддерживает схему дополнения

NoSuchProviderException — если указанный provider не зарегистрирован в списке поставщиков безопасности

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

См. также:

• Provider

public static final Cipher getInstance(String transformation, Provider provider) throws NoSuchAlgorithmException, NoSuchPaddingException

Примечание к API:

Рекомендуется использовать преобразование, в котором полностью указаны алгоритм, режим и схема дополнения. В противном случае поставщик будет использовать значения режима и схемы дополнения по умолчанию, которые могут не соответствовать требованиям безопасности вашего приложения.

Примечание по реализации:

Сведения о значениях преобразования по умолчанию, используемых поставщиками JDK, см. в разделе «Преобразования Cipher» документа Поставщики JDK. Эталонная реализация JDK дополнительно использует свойство jdk.crypto.disabledAlgorithms Security для определения, разрешён ли указанный алгоритм. Если задано значение jdk.crypto.disabledAlgorithms, оно имеет приоритет над значением свойства безопасности.

Параметры:

transformation — имя преобразования, например AES/CBC/PKCS5Padding. Сведения о стандартных именах преобразований см. в разделе Cipher спецификации стандартных имён алгоритмов безопасности Java.

provider — поставщик

Возвращает:

объект Cipher, реализующий запрошенное преобразование

Выбрасывает:

IllegalArgumentException — если provider имеет значение null

NoSuchAlgorithmException — если transformation имеет значение null, пуст или имеет недопустимый формат; либо если реализация CipherSpi указанного provider не найдена или найдена, но не поддерживает режим

NoSuchPaddingException — если реализация CipherSpi указанного provider найдена, но не поддерживает схему дополнения

Внешние спецификации

• Стандартные имена алгоритмов безопасности Java

См. также:

• Provider

public final Provider getProvider()

Возвращает:

поставщика этого объекта Cipher

public final String getAlgorithm()

Возвращает:

имя алгоритма этого объекта Cipher

public final int getBlockSize()

Возвращает:

размер блока (в байтах) или 0, если этот шифр не является блочным

public final int getOutputSize(int inputLen)

Параметры:

inputLen — длина входных данных (в байтах)

Возвращает:

требуемый размер выходного буфера (в байтах)

Выбрасывает:

IllegalStateException — если объект Cipher находится в неправильном состоянии (например, ещё не инициализирован)

public final byte[] getIV()

Возвращает:

вектор инициализации в новом буфере или null, если этот шифр не использует IV либо IV ещё не задан.

public final AlgorithmParameters getParameters()

Возвращает:

параметры, используемые этим шифром, или null

public final ExemptionMechanism getExemptionMechanism()

Возвращает:

объект механизма освобождения от ограничений, используемый этим объектом Cipher, или null, если этот объект Cipher не использует механизм освобождения от ограничений.

public final void init(int opmode, Key key) throws InvalidKeyException

Параметры:

opmode — режим операции этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ

Выбрасывает:

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

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но нижележащая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не является одним из распознаваемых значений

public final void init(int opmode, Key key, SecureRandom random) throws InvalidKeyException

Параметры:

opmode — режим операции этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

random — источник случайных данных

Выбрасывает:

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

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но нижележащая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не является одним из распознаваемых значений

public final void init(int opmode, Key key, AlgorithmParameterSpec params) throws InvalidKeyException, InvalidAlgorithmParameterException

Параметры:

opmode — режим операции этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

params — параметры алгоритма

Выбрасывает:

InvalidKeyException — если заданный ключ не подходит для инициализации этого шифра или его размер превышает максимально допустимый (определяемый настроенными файлами политик юрисдикции)

InvalidAlgorithmParameterException — если заданные параметры алгоритма не подходят для этого шифра, если для этого шифра требуются параметры алгоритма, а params имеет значение null, либо если заданные параметры алгоритма подразумевают криптографическую стойкость, превышающую допустимые пределы (определяемые настроенными файлами политик юрисдикции)

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но нижележащая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не является одним из распознаваемых значений

public final void init(int opmode, Key key, AlgorithmParameterSpec params, SecureRandom random) throws InvalidKeyException, InvalidAlgorithmParameterException

Параметры:

opmode — режим операции этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

params — параметры алгоритма

random — источник случайных данных

Выбрасывает:

InvalidKeyException — если заданный ключ не подходит для инициализации этого шифра или его размер превышает максимально допустимый (определяемый настроенными файлами политик юрисдикции)

InvalidAlgorithmParameterException — если заданные параметры алгоритма не подходят для этого шифра, если для этого шифра требуются параметры алгоритма, а params имеет значение null, либо если заданные параметры алгоритма подразумевают криптографическую стойкость, превышающую допустимые пределы (определяемые настроенными файлами политик юрисдикции)

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но нижележащая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не является одним из распознаваемых значений

public final void init(int opmode, Key key, AlgorithmParameters params) throws InvalidKeyException, InvalidAlgorithmParameterException

Параметры:

opmode — режим работы этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

params — параметры алгоритма

Исключения:

InvalidKeyException — если указанный ключ не подходит для инициализации этого шифра или его размер превышает максимально допустимый размер ключа (согласно настроенным файлам политики юрисдикции).

InvalidAlgorithmParameterException — если указанные параметры алгоритма не подходят для этого шифра, этому шифру требуются параметры алгоритма, а params имеет значение null, либо указанные параметры алгоритма подразумевают криптографическую стойкость, превышающую установленные законом ограничения (согласно настроенным файлам политики юрисдикции)

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не является одним из распознаваемых значений

public final void init(int opmode, Key key, AlgorithmParameters params, SecureRandom random) throws InvalidKeyException, InvalidAlgorithmParameterException

Параметры:

opmode — режим работы этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

params — параметры алгоритма

random — источник случайных данных

Исключения:

InvalidKeyException — если указанный ключ не подходит для инициализации этого шифра или его размер превышает максимально допустимый размер ключа (согласно настроенным файлам политики юрисдикции)

InvalidAlgorithmParameterException — если указанные параметры алгоритма не подходят для этого шифра, этому шифру требуются параметры алгоритма, а params имеет значение null, либо указанные параметры алгоритма подразумевают криптографическую стойкость, превышающую установленные законом ограничения (согласно настроенным файлам политики юрисдикции)

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не является одним из распознаваемых значений

public final void init(int opmode, Certificate certificate) throws InvalidKeyException

Параметры:

opmode — режим работы этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

certificate — сертификат

Исключения:

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

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не является одним из распознаваемых значений

public final void init(int opmode, Certificate certificate, SecureRandom random) throws InvalidKeyException

Параметры:

opmode — режим работы этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

certificate — сертификат

random — источник случайных данных

Исключения:

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

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не является одним из распознаваемых значений

public final byte[] update(byte[] input)

Параметры:

input — входной буфер

Возвращает:

новый буфер с результатом или null, если этот шифр является блочным и входных данных недостаточно для формирования нового блока

Исключения:

IllegalStateException — если этот объект Cipher находится в недопустимом состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

public final byte[] update(byte[] input, int inputOffset, int inputLen)

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

Возвращает:

новый буфер с результатом или null, если этот шифр является блочным и входных данных недостаточно для формирования нового блока.

Исключения:

IllegalStateException — если этот объект Cipher находится в недопустимом состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

public final int update(byte[] input, int inputOffset, int inputLen, byte[] output) throws ShortBufferException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

output — буфер для результата

Возвращает:

количество байтов, сохранённых в output

Исключения:

IllegalStateException — если этот объект Cipher находится в недопустимом состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

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

public final int update(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) throws ShortBufferException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

output — буфер для результата

outputOffset — смещение в output, по которому сохраняется результат

Возвращает:

количество байтов, сохранённых в output

Исключения:

IllegalStateException — если этот объект Cipher находится в недопустимом состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

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

public final int update(ByteBuffer input, ByteBuffer output) throws ShortBufferException

Параметры:

input — входной ByteBuffer

output — выходной ByteByffer

Возвращает:

количество байтов, сохранённых в output

Исключения:

IllegalStateException — если этот объект Cipher находится в недопустимом состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

IllegalArgumentException — если входной и выходной буферы являются одним и тем же объектом

ReadOnlyBufferException — если выходной буфер доступен только для чтения

ShortBufferException — если в выходном буфере недостаточно места

Начиная с версии:

1.5

public final byte[] doFinal() throws IllegalBlockSizeException, BadPaddingException

Возвращает:

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

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном режиме или не может быть сброшен.

IllegalBlockSizeException — если этот шифр является блочным, дополнение не запрашивалось (только в режиме шифрования), а общая длина данных, обработанных этим шифром, не кратна размеру блока; либо если этот алгоритм шифрования не может обработать предоставленные входные данные.

BadPaddingException — если этот объект Cipher находится в режиме расшифрования и было запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher выполняет расшифрование в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final int doFinal(byte[] output, int outputOffset) throws IllegalBlockSizeException, ShortBufferException, BadPaddingException

Параметры:

output — буфер для результата

outputOffset — смещение в output, по которому сохраняется результат

Возвращает:

количество байтов, сохранённых в output

Исключения:

IllegalStateException — если этот объект Cipher находится в недопустимом состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

IllegalBlockSizeException — если этот шифр является блочным, дополнение не запрашивалось (только в режиме шифрования), а общая длина данных, обработанных этим шифром, не кратна размеру блока; либо если этот алгоритм шифрования не может обработать предоставленные входные данные.

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

BadPaddingException — если этот объект Cipher находится в режиме расшифрования и было запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher выполняет расшифрование в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final byte[] doFinal(byte[] input) throws IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной буфер

Возвращает:

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

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном режиме или не может быть сброшен.

IllegalBlockSizeException — если этот шифр является блочным, дополнение не запрашивалось (только в режиме шифрования), а общая длина данных, обработанных этим шифром, не кратна размеру блока; либо если этот алгоритм шифрования не может обработать предоставленные входные данные.

BadPaddingException — если этот объект Cipher находится в режиме расшифрования и было запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher выполняет расшифрование в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final byte[] doFinal(byte[] input, int inputOffset, int inputLen) throws IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

Возвращает:

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

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном режиме или не может быть сброшен.

IllegalBlockSizeException — если этот шифр является блочным, дополнение не запрашивалось (только в режиме шифрования), а общая длина данных, обработанных этим шифром, не кратна размеру блока; либо если этот алгоритм шифрования не может обработать предоставленные входные данные.

BadPaddingException — если этот объект Cipher находится в режиме расшифрования и было запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher выполняет расшифрование в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final int doFinal(byte[] input, int inputOffset, int inputLen, byte[] output) throws ShortBufferException, IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

output — буфер для результата

Возвращает:

количество байтов, сохранённых в output

Выбрасывает:

IllegalStateException — если объект Cipher находится в неправильном режиме или не может быть сброшен.

IllegalBlockSizeException — если данный шифр является блочным шифром, дополнение не было запрошено (только в режиме шифрования), а общая длина входных данных, обработанных этим шифром, не кратна размеру блока; или если этот алгоритм шифрования не может обработать предоставленные входные данные.

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

BadPaddingException — если объект Cipher находится в режиме расшифрования и было запрошено дополнение или его удаление, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final int doFinal(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) throws ShortBufferException, IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

output — буфер для результата

outputOffset — смещение в output, по которому сохраняется результат

Возвращает:

количество байтов, сохранённых в output

Выбрасывает:

IllegalStateException — если объект Cipher находится в неправильном режиме или не может быть сброшен.

IllegalBlockSizeException — если данный шифр является блочным шифром, дополнение не было запрошено (только в режиме шифрования), а общая длина входных данных, обработанных этим шифром, не кратна размеру блока; или если этот алгоритм шифрования не может обработать предоставленные входные данные.

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

BadPaddingException — если объект Cipher находится в режиме расшифрования и было запрошено дополнение или его удаление, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final int doFinal(ByteBuffer input, ByteBuffer output) throws ShortBufferException, IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной ByteBuffer

output — выходной ByteBuffer

Возвращает:

количество байтов, сохранённых в output

Выбрасывает:

IllegalStateException — если объект Cipher находится в неправильном режиме или не может быть сброшен.

IllegalArgumentException — если входной и выходной буферы являются одним и тем же объектом

ReadOnlyBufferException — если выходной буфер доступен только для чтения

IllegalBlockSizeException — если данный шифр является блочным шифром, дополнение не было запрошено (только в режиме шифрования), а общая длина входных данных, обработанных этим шифром, не кратна размеру блока; или если этот алгоритм шифрования не может обработать предоставленные входные данные.

ShortBufferException — если в выходном буфере недостаточно места

BadPaddingException — если объект Cipher находится в режиме расшифрования и было запрошено дополнение или его удаление, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

Начиная с:

1.5

public final byte[] wrap(Key key) throws IllegalBlockSizeException, InvalidKeyException

Параметры:

key — ключ для упаковки

Возвращает:

упакованный ключ

Выбрасывает:

IllegalStateException — если объект Cipher находится в неправильном состоянии (например, не был инициализирован или не находится в WRAP_MODE)

IllegalBlockSizeException — если данный шифр является блочным шифром, дополнение не было запрошено, а длина кодирования упаковываемого ключа не кратна размеру блока

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

UnsupportedOperationException — если соответствующий метод в CipherSpi не поддерживается

public final Key unwrap(byte[] wrappedKey, String wrappedKeyAlgorithm, int wrappedKeyType) throws InvalidKeyException, NoSuchAlgorithmException

Параметры:

wrappedKey — ключ для распаковки

wrappedKeyAlgorithm — алгоритм, связанный с упакованным ключом

wrappedKeyType — тип упакованного ключа. Должен быть одним из следующих: SECRET_KEY, PRIVATE_KEY или PUBLIC_KEY

Возвращает:

распакованный ключ

Выбрасывает:

IllegalStateException — если объект Cipher находится в неправильном состоянии (например, не был инициализирован или не находится в UNWRAP_MODE)

NoSuchAlgorithmException — если ни один из установленных поставщиков не может создать ключи типа wrappedKeyType для wrappedKeyAlgorithm

InvalidKeyException — если wrappedKey не представляет собой упакованный ключ типа wrappedKeyType для wrappedKeyAlgorithm

UnsupportedOperationException — если соответствующий метод в CipherSpi не поддерживается

public static final int getMaxAllowedKeyLength(String transformation) throws NoSuchAlgorithmException

Параметры:

transformation — преобразование шифра

Возвращает:

максимальная длина ключа в битах или Integer.MAX_VALUE

Выбрасывает:

NullPointerException — если transformation имеет значение null

NoSuchAlgorithmException — если transformation не является допустимым преобразованием, то есть не имеет вид «algorithm» или «algorithm/mode/padding»

Начиная с:

1.5

public static final AlgorithmParameterSpec getMaxAllowedParameterSpec(String transformation) throws NoSuchAlgorithmException

Параметры:

transformation — преобразование шифра

Возвращает:

объект AlgorithmParameterSpec, содержащий максимальное значение, или null

Выбрасывает:

NullPointerException — если transformation имеет значение null

NoSuchAlgorithmException — если transformation не является допустимым преобразованием, то есть не имеет вид «algorithm» или «algorithm/mode/padding»

Начиная с:

1.5

public final void updateAAD(byte[] src)

Параметры:

src — буфер, содержащий дополнительные данные аутентификации

Выбрасывает:

IllegalArgumentException — если байтовый массив src имеет значение null

IllegalStateException — если объект Cipher находится в неправильном состоянии (например, не был инициализирован или не находится в ENCRYPT_MODE или DECRYPT_MODE), не принимает данные AAD или, при работе в режиме GCM либо CCM, один из методов update уже был вызван для текущей операции шифрования/расшифрования

UnsupportedOperationException — если соответствующий метод в CipherSpi не был переопределён реализацией

Начиная с:

1.7

public final void updateAAD(byte[] src, int offset, int len)

Параметры:

src — буфер, содержащий данные AAD

offset — смещение в src, с которого начинаются входные данные AAD

len — количество байтов AAD

Выбрасывает:

IllegalArgumentException — если байтовый массив src имеет значение null, offset или length меньше 0 либо сумма offset и len превышает длину байтового массива src

IllegalStateException — если объект Cipher находится в неправильном состоянии (например, не был инициализирован или не находится в ENCRYPT_MODE или DECRYPT_MODE), не принимает данные AAD или, при работе в режиме GCM либо CCM, один из методов update уже был вызван для текущей операции шифрования/расшифрования

UnsupportedOperationException — если соответствующий метод в CipherSpi не был переопределён реализацией

Начиная с:

1.7

public final void updateAAD(ByteBuffer src)

Параметры:

src — буфер, содержащий данные AAD

Выбрасывает:

IllegalArgumentException — если src ByteBuffer имеет значение null

IllegalStateException — если объект Cipher находится в неправильном состоянии (например, не был инициализирован или не находится в ENCRYPT_MODE или DECRYPT_MODE), не принимает данные AAD или, при работе в режиме GCM либо CCM, один из методов update уже был вызван для текущей операции шифрования/расшифрования

UnsupportedOperationException — если соответствующий метод в CipherSpi не был переопределён реализацией

Начиная с:

1.7

public String toString()

Переопределяет:

toString в классе Object

Примечание по реализации:

Эта реализация возвращает объект String, содержащий преобразование, режим и поставщика этого объекта Cipher. Точный формат String не определён и может измениться.

Возвращает:

строку, описывающую этот объект Cipher