Класс SealedObject

public class SealedObject
extends Object
implements Serializable

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

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

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

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

• с помощью метода getObject, который принимает объект Cipher.

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

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

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

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

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

Подробное описание полей

encodedParams

protected byte[] encodedParams

Подробное описание конструкторов

SealedObject

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

Параметры:

object - объект, который должен быть запечатан; может быть null.

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

Исключения:

NullPointerException - если переданный шифр null.

IOException - если возникла ошибка во время сериализации

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

SealedObject

protected SealedObject(SealedObject so)

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

Параметры:

so - объект SealedObject

Исключения:

NullPointerException - если переданный запечатанный объект null.

Подробное описание методов

getAlgorithm

public final String getAlgorithm()

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

Возвращает:

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

getObject

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

Параметры:

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

Возвращает:

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

Исключения:

IOException - если возникла ошибка во время десериализации.

ClassNotFoundException - если возникла ошибка во время десериализации.

NoSuchAlgorithmException - если алгоритм для расшифровки объекта недоступен.

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

NullPointerException - если key null.

getObject

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

Параметры:

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

Возвращает:

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

Исключения:

NullPointerException - если переданный шифр null.

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

ClassNotFoundException - если возникла ошибка во время десериализации

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

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

getObject

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

Параметры:

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

provider - имя поставщика алгоритма для расшифровки объекта.

Возвращает:

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

Исключения:

IllegalArgumentException - если переданный поставщик null или пуст.

IOException - если возникла ошибка во время десериализации.

ClassNotFoundException - если возникла ошибка во время десериализации.

NoSuchAlgorithmException - если алгоритм для расшифровки объекта недоступен.

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

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

NullPointerException - если key null.