Пакет javax.xml.crypto.dsig

Классы для создания и проверки цифровых подписей XML. Этот пакет содержит классы, представляющие основные элементы, определённые в спецификации W3C для цифровых подписей XML: XMLSignature, SignedInfo, CanonicalizationMethod, SignatureMethod, Reference, DigestMethod, XMLObject, Manifest, SignatureProperties и SignatureProperty. Типы KeyInfo определены в под-пакете javax.xml.crypto.dsig.keyinfo. XMLSignatureFactory — это абстрактная фабрика, которая создаёт объекты XMLSignature с нуля или на основе уже существующего представления XML, например узла DOM. TransformService — это интерфейс поставщика услуг для создания и подключения реализаций алгоритмов преобразования и каноникализации.

Основное значение в этом пакете имеет класс XMLSignature, который позволяет подписывать и проверять цифровую подпись XML.

Поставщики услуг

Поставщик услуг — это конкретная реализация абстрактных классов XMLSignatureFactory и KeyInfoFactory, отвечающая за создание объектов и алгоритмов, которые разбирают, создают и проверяют подписи XML и структуры KeyInfo. Конкретная реализация XMLSignatureFactory ДОЛЖНА поддерживать каждый из ОБЯЗАТЕЛЬНЫХ алгоритмов, указанных в рекомендации W3C для подписей XML. Она МОЖЕТ поддерживать другие алгоритмы, определённые рекомендацией W3C или другими спецификациями.

API использует модель поставщиков JCA (см. the Provider class) для регистрации и загрузки реализаций XMLSignatureFactory и KeyInfoFactory.

Каждая конкретная реализация XMLSignatureFactory или KeyInfoFactory поддерживает определённый тип механизма XML, идентифицирующий механизм обработки XML, который реализация использует внутри для разбора и создания структур подписи XML и KeyInfo.

Реализация поставщика услуг ДОЛЖНА использовать базовые классы движка JCA, такие как Signature и MessageDigest, для выполнения криптографических операций.

Помимо классов XMLSignatureFactory и KeyInfoFactory, API поддерживает интерфейс поставщика услуг для алгоритмов преобразования и каноникализации. Класс TransformService позволяет разработать и подключить реализацию определённого алгоритма преобразования или каноникализации для конкретного типа механизма XML. Класс TransformService использует стандартную модель поставщиков JCA для регистрации и загрузки реализаций. Каждая реализация поставщика услуг ДОЛЖНА использовать класс TransformService для поиска поставщика, поддерживающего алгоритмы преобразования и каноникализации в подписях XML, которые она создаёт или проверяет.

Требования к механизму DOM

При реализации основанных на DOM XMLSignatureFactory, KeyInfoFactory или TransformService НЕОБХОДИМО соблюдать следующие требования, чтобы свести к минимуму проблемы совместимости:

1. Метод unmarshalXMLSignature класса XMLSignatureFactory ДОЛЖЕН поддерживать типы DOMValidateContext. Если тип — DOMValidateContext, он ДОЛЖЕН содержать Element типа Signature. Кроме того, метод unmarshalXMLSignature МОЖЕТ заполнять сопоставления Id/Element переданного DOMValidateContext.
2. Метод sign объектов XMLSignature, созданных посредством XMLSignatureFactory, ДОЛЖЕН поддерживать типы DOMSignContext, а метод validate ДОЛЖЕН поддерживать типы DOMValidateContext. Это требование также относится к методу validate класса SignatureValue и методу validate класса Reference.
3. Реализация ДОЛЖНА поддерживать DOMStructure в качестве механизма, с помощью которого приложение задаёт расширяемое содержимое (любые элементы или смешанное содержимое).
4. Если метод dereference пользовательских объектов URIDereferencer возвращает объекты NodeSetData, метод iterator ДОЛЖЕН возвращать итератор по объектам типа org.w3c.dom.Node.
5. Объекты URIReference, передаваемые методу dereference пользовательских объектов URIDereferencer, ДОЛЖНЫ иметь тип DOMURIReference, а объекты XMLCryptoContext ДОЛЖНЫ реализовывать DOMCryptoContext.
6. Предыдущие два требования также относятся к объектам URIDereferencer, возвращаемым методом getURIDereferencer класса XMLSignatureFactory и KeyInfoFactory.
7. Метод unmarshalKeyInfo класса KeyInfoFactory ДОЛЖЕН поддерживать типы DOMStructure. Если тип — DOMStructure, он ДОЛЖЕН содержать Element типа KeyInfo.
8. Метод transform класса Transform ДОЛЖЕН поддерживать типы параметров контекста DOMCryptoContext.
9. Методы newtransform и newCanonicalizationMethod класса XMLSignatureFactory ДОЛЖНЫ поддерживать типы параметров DOMStructure.
10. Методы init и marshalParams класса TransformService ДОЛЖНЫ поддерживать типы DOMStructure и DOMCryptoContext.
11. Метод unmarshalXMLSignature класса XMLSignatureFactory ДОЛЖЕН поддерживать типы DOMStructure. Если тип — DOMStructure, он ДОЛЖЕН содержать Element типа Signature.
12. Метод marshal класса KeyInfo ДОЛЖЕН поддерживать типы параметров DOMStructure и DOMCryptoContext.

Обратите внимание, что реализация DOM МОЖЕТ внутри использовать другие API разбора XML, помимо DOM, если это не влияет на совместимость. Например, реализация XMLSignatureFactory для DOM может использовать внутри парсер SAX для каноникализации данных.

Спецификация пакета

• Синтаксис и обработка XML-подписей: рекомендация W3C
• RFC 3275: синтаксис и обработка XML-подписей