Класс SecretKeyFactory

public class SecretKeyFactory
extends Object

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

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

Фабрики ключей двунаправленные, т.е. они позволяют создать непрозражный объект ключа из заданной спецификации ключа (материала ключа) или извлечь базовый материал ключа объекта ключа в подходящем формате.

Разработчики приложений должны обратиться к документации своего поставщика, чтобы узнать, какие спецификации ключей поддерживаются методами generateSecret и getKeySpec. Например, фабрика секретных ключей DES, поставляемая поставщиком "SunJCE", поддерживает DESKeySpec в качестве прозрачного представления ключей DES, а фабрика секретных ключей этого поставщика для ключей Triple DES поддерживает DESedeKeySpec в качестве прозрачного представления ключей Triple DES.

Каждая реализация Java платформы должна поддерживать следующие стандартные SecretKeyFactory алгоритмы:

• DES
• DESede

Эти алгоритмы описаны в разделе SecretKeyFactory документации Java Cryptography Architecture по стандартным именам алгоритмов. Обратитесь к документации выпуска вашей реализации, чтобы узнать, поддерживаются ли какие-либо другие алгоритмы.

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

SecretKeyFactory

protected SecretKeyFactory(SecretKeyFactorySpi keyFacSpi,
                           Provider provider,
                           String algorithm)

Создаёт объект SecretKeyFactory.

Параметры:

keyFacSpi - делегат

provider - поставщик

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

Методы

getInstance

public static final SecretKeyFactory getInstance(String algorithm)
                                          throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма секретного ключа. См. раздел SecretKeyFactory в документации по стандартным именам алгоритмов Java Cryptography Architecture для получения информации о стандартных именах алгоритмов.

Возвращает:

новый объект SecretKeyFactory.

Исключения:

NullPointerException - если указанный алгоритм равен null.

NoSuchAlgorithmException - если ни один поставщик не поддерживает реализацию SecretKeyFactorySpi для указанного алгоритма.

См. также:

Provider

getInstance

public static final SecretKeyFactory getInstance(String algorithm,
                                                 String provider)
                                          throws NoSuchAlgorithmException,
                                                 NoSuchProviderException

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма секретного ключа. См. раздел SecretKeyFactory в документации по стандартным именам алгоритмов Java Cryptography Architecture для получения информации о стандартных именах алгоритмов.

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

Возвращает:

новый объект SecretKeyFactory.

Исключения:

NoSuchAlgorithmException - если реализация SecretKeyFactorySpi для указанного алгоритма недоступна от указанного поставщика.

NullPointerException - если указанный алгоритм равен null.

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

IllegalArgumentException - если provider равен null или пуст.

См. также:

Provider

getInstance

public static final SecretKeyFactory getInstance(String algorithm,
                                                 Provider provider)
                                          throws NoSuchAlgorithmException

Параметры:

algorithm - стандартное имя запрашиваемого алгоритма секретного ключа. См. раздел SecretKeyFactory в документации по стандартным именам алгоритмов Java Cryptography Architecture для получения информации о стандартных именах алгоритмов.

provider - поставщик.

Возвращает:

новый объект SecretKeyFactory.

Исключения:

NullPointerException - если указанный алгоритм равен null.

NoSuchAlgorithmException - если реализация SecretKeyFactorySpi для указанного алгоритма недоступна от указанного объекта поставщика.

IllegalArgumentException - если provider равен null.

См. также:

Provider

getProvider

public final Provider getProvider()

Возвращает поставщика этого объекта SecretKeyFactory.

Возвращает:

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

getAlgorithm

public final String getAlgorithm()

Возвращает:

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

generateSecret

public final SecretKey generateSecret(KeySpec keySpec)
                               throws InvalidKeySpecException

Генерирует объект SecretKey из предоставленного спецификации ключа (материала ключа).

Параметры:

keySpec - спецификация (материал ключа) секретного ключа

Возвращает:

секретный ключ

Исключения:

InvalidKeySpecException - если данная спецификация ключа не подходит для этого фабрики секретных ключей для создания секретного ключа.

getKeySpec

public final KeySpec getKeySpec(SecretKey key,
                                Class<?> keySpec)
                         throws InvalidKeySpecException

Возвращает спецификацию (материал ключа) данного объекта ключа в запрошенном формате.

Параметры:

key - ключ

keySpec - запрашиваемый формат, в котором должен быть возвращён материал ключа

Возвращает:

базовая спецификация ключа (материал ключа) в запрошенном формате

Исключения:

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

translateKey

public final SecretKey translateKey(SecretKey key)
                             throws InvalidKeyException

Преобразует объект ключа, чей поставщик может быть неизвестен или потенциально недоверен, в соответствующий объект ключа этой фабрики секретных ключей.

Параметры:

key - ключ, чей поставщик неизвестен или недоверен

Возвращает:

преобразованный ключ

Исключения:

InvalidKeyException - если данный ключ не может быть обработан этой фабрикой секретных ключей.