Класс SignedObject

public final class SignedObject
extends Object
implements Serializable

Класс SignedObject предназначен для создания аутентичных объектов во время выполнения, целостность которых нельзя нарушить, не будучи обнаруженными.

Более конкретно, SignedObject содержит другой сериализуемый объект, объект (который будет) подписан и его подпись.

Подписанный объект представляет собой "глубокую копию" (в сериализованной форме) исходного объекта. После создания копии дальнейшие изменения исходного объекта не влияют на копию.

Алгоритм подписи определяется объектом Signature, переданным в конструктор, и методом verify. Типичное использование для подписи выглядит следующим образом:

Signature signingEngine = Signature.getInstance(algorithm,
                                                 provider);
 SignedObject so = new SignedObject(myobject, signingKey,
                                    signingEngine);

Типичное использование для проверки (получив SignedObject so) выглядит следующим образом:

Signature verificationEngine =
     Signature.getInstance(algorithm, provider);
 if (so.verify(publickey, verificationEngine))
     try {
         Object myobj = so.getObject();
     } catch (java.lang.ClassNotFoundException e) {};

Несколько моментов заслуживают внимания. Во-первых, нет необходимости инициализировать движок подписи или проверки, поскольку он будет повторно инициализирован внутри конструктора и метода verify. Во-вторых, для успешной проверки указанный открытый ключ должен соответствовать закрытому ключу, использованному для генерации SignedObject.

Более важно, что по соображениям гибкости, конструктор и метод verify позволяют использовать настраиваемые движки подписи, которые могут реализовывать алгоритмы подписи, не установленные формально как часть криптографического поставщика. Однако важно, чтобы программист, пишущий код верификатора, понимал, какой Signature движок используется, так как его собственная реализация метода verify вызывается для проверки подписи. Другими словами, злонамеренный Signature может выбрать всегда возвращать true при проверке, чтобы обойти проверку безопасности.

Алгоритм подписи может быть, среди прочих, стандартным NIST DSA, используя DSA и SHA-256. Алгоритм задаётся той же схемой, что и подписи. Например, алгоритм DSA с использованием алгоритма хеширования SHA-256 может быть задан как "SHA256withDSA". В случае RSA алгоритм подписи может быть задан, например, как "SHA256withRSA". Имя алгоритма должно быть указано, так как по умолчанию его нет.

Имя поставщика криптографического пакета также задаётся параметром Signature в конструкторе и методе verify. Если поставщик не указан, используется поставщик по умолчанию. Каждая установка может быть настроена для использования определённого поставщика по умолчанию.

Возможные применения SignedObject включают:

• Он может использоваться внутри любого Java runtime в качестве неоспоримого маркера авторизации — такого, который можно передавать без опасения, что маркер может быть злонамеренно изменён без обнаружения.
• Он может использоваться для подписи и сериализации данных/объектов для хранения вне Java runtime (например, для хранения критически важных данных управления доступом на диске).
• Вложенные SignedObject могут использоваться для построения логической последовательности подписей, напоминающей цепочку авторизации и делегирования.

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

SignedObject

public SignedObject(Serializable object,
                    PrivateKey signingKey,
                    Signature signingEngine)
             throws IOException,
                    InvalidKeyException,
                    SignatureException

Создаёт SignedObject из любого сериализуемого объекта. Указанный объект подписывается с помощью заданного ключа подписи, используя указанный движок подписи.

Параметры:

object — объект, подлежащий подписи.

signingKey — закрытый ключ для подписи.

signingEngine — движок подписи.

Исключения:

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

InvalidKeyException — если ключ недействителен.

SignatureException — если подпись не удалась.

Методы

getObject

public Object getObject()
                 throws IOException,
                        ClassNotFoundException

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

Возвращает:

инкапсулированный объект.

Исключения:

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

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

getSignature

public byte[] getSignature()

Возвращает подпись на подписанном объекте в виде массива байтов.

Возвращает:

подпись. Возвращает новый массив каждый раз при вызове этого метода.

getAlgorithm

public String getAlgorithm()

Возвращает имя алгоритма подписи.

Возвращает:

имя алгоритма подписи.

verify

public boolean verify(PublicKey verificationKey,
                      Signature verificationEngine)
               throws InvalidKeyException,
                      SignatureException

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

Параметры:

verificationKey — открытый ключ для проверки.

verificationEngine — движок проверки подписи.

Возвращает:

true если подпись действительна, false в противном случае

Исключения:

SignatureException — если проверка подписи не удалась (исключение помешало движку проверки подписи завершить работу нормально).

InvalidKeyException — если ключ проверки недействителен.