javax.crypto

Класс SealedObject

java.lang. Объект

javax.crypto. SealedObject

Все Реализованные Интерфейсы:

Сериализуемый

public class SealedObject
extends Object
implements Serializable

Этот class позволяет программисту создать объект и защитить его конфиденциальность с криптографическим алгоритмом.

Учитывая любой Сериализуемый объект, можно создать SealedObject, который инкапсулирует исходный объект, в сериализированном формате (то есть, "глубокая копия"), и изоляции (шифруют) ее сериализированное содержание, используя криптографический алгоритм, такое как DES, чтобы защитить ее конфиденциальность. Зашифрованный контент может позже быть дешифрован (с соответствующим алгоритмом, используя корректный ключ расшифровки) и десериализован, приводя к исходному объекту.

Отметьте, что объект Шифра должен быть полностью инициализирован с корректным алгоритмом, ключом, дополняя схему, и т.д., прежде, чем быть примененным к SealedObject.

Исходный объект, который был изолирован, может быть восстановлен двумя различными способами:

• при использовании getObject метод, который берет a Cipher объект.

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

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

• при использовании одного из getObject методы, которые берут a Key объект.

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

  У этого подхода есть преимущество, что сторона, кто распечатывает объект, не должна отследить параметры (например, IV), которые использовались, чтобы изолировать объект.

С тех пор:

1.4

См. Также:

Cipher, Сериализированная Форма

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected byte[]	encodedParams Криптографические параметры, используемые Шифром изоляции, закодированным в формате значения по умолчанию.

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

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

Модификатор	Конструктор и Описание
protected	SealedObject(SealedObject so) Создает объект SealedObject из переданного - в SealedObject.
	SealedObject(Serializable object, Cipher c) Создает SealedObject из любого Сериализуемого объекта.

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

Модификатор и Тип	Метод и Описание
Строка	getAlgorithm() Возвращает алгоритм, который использовался, чтобы изолировать этот объект.
Объект	getObject(Cipher c) Получает исходный (инкапсулировавший) объект.
Объект	getObject(Key key) Получает исходный (инкапсулировавший) объект.
Объект	getObject(Key key, String provider) Получает исходный (инкапсулировавший) объект.

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

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

Полевая Деталь

encodedParams

protected byte[] encodedParams

Криптографические параметры, используемые Шифром изоляции, закодированным в формате значения по умолчанию.

Таким образом, cipher.getParameters().getEncoded().

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

SealedObject

public SealedObject(Serializable object,
                    Cipher c)
             throws IOException,
                    IllegalBlockSizeException

Создает SealedObject из любого Сериализуемого объекта.

Данный объект сериализируется, и его сериализированное содержание шифруется, используя данный Шифр, который должен быть полностью инициализирован.

Любые параметры алгоритма, которые могут использоваться в работе шифрования, сохранены в новом SealedObject.

Параметры:

object - объект, который будет изолирован; может быть нуль.

c - шифр, используемый, чтобы изолировать объект.

Броски:

NullPointerException - если данный шифр является нулем.

IOException - если ошибка происходит во время сериализации

IllegalBlockSizeException - если данный шифр является блочным шифром, никакое дополнение не требовали, и длина общих затрат (то есть, длина сериализированного объектного содержания) не являются кратным числом размера блока шифра

SealedObject

protected SealedObject(SealedObject so)

Создает объект SealedObject из переданного - в SealedObject.

Параметры:

so - объект SealedObject

Броски:

NullPointerException - если данный изолированный объект является нулем.

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

getAlgorithm

public final String getAlgorithm()

Возвращает алгоритм, который использовался, чтобы изолировать этот объект.

Возвраты:

алгоритм, который использовался, чтобы изолировать этот объект.

getObject

public final Object getObject(Key key)
                       throws IOException,
                              ClassNotFoundException,
                              NoSuchAlgorithmException,
                              InvalidKeyException

Получает исходный (инкапсулировавший) объект.

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

Инкапсулировавший объект распечатывается и десериализовывается, прежде, чем он будет возвращен.

Параметры:

key - ключ, используемый, чтобы распечатать объект.

Возвраты:

исходный объект.

Броски:

IOException - если ошибка происходит во время де-serialiazation.

ClassNotFoundException - если ошибка происходит во время де-serialiazation.

NoSuchAlgorithmException - если алгоритм, чтобы распечатать объект не доступен.

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

NullPointerException - если key нуль.

getObject

public final Object getObject(Cipher c)
                       throws IOException,
                              ClassNotFoundException,
                              IllegalBlockSizeException,
                              BadPaddingException

Получает исходный (инкапсулировавший) объект.

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

Параметры:

c - шифр, используемый, чтобы распечатать объект

Возвраты:

исходный объект.

Броски:

NullPointerException - если данный шифр является нулем.

IOException - если ошибка происходит во время де-serialiazation

ClassNotFoundException - если ошибка происходит во время де-serialiazation

IllegalBlockSizeException - если данный шифр является блочным шифром, никакое дополнение не требовали, и длина общих затрат не является кратным числом размера блока шифра

BadPaddingException - если данный шифр был инициализирован для дешифрования, и дополнение было определено, но входные данные не имеют надлежащим, ожидал дополнять байты

getObject

public final Object getObject(Key key,
                              String provider)
                       throws IOException,
                              ClassNotFoundException,
                              NoSuchAlgorithmException,
                              NoSuchProviderException,
                              InvalidKeyException

Получает исходный (инкапсулировавший) объект.

Этот метод создает шифр для алгоритма, который использовался в работе изоляции, используя реализацию того алгоритма от данного provider. Объект Шифра инициализируется для дешифрования, используя данный key и параметры (если любой), который использовался в работе изоляции.

Инкапсулировавший объект распечатывается и десериализовывается, прежде, чем он будет возвращен.

Параметры:

key - ключ, используемый, чтобы распечатать объект.

provider - имя провайдера алгоритма, чтобы распечатать объект.

Возвраты:

исходный объект.

Броски:

IllegalArgumentException - если данный провайдер является нулем или пустой.

IOException - если ошибка происходит во время де-serialiazation.

ClassNotFoundException - если ошибка происходит во время де-serialiazation.

NoSuchAlgorithmException - если алгоритм, чтобы распечатать объект не доступен.

NoSuchProviderException - если данный провайдер не конфигурируется.

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

NullPointerException - если key нуль.