| CARVIEW |
XML Security RELAX NG Schemas
W3C Working Draft 03 March 2011
- This version:
- https://www.w3.org/TR/2011/WD-xmlsec-rngschema-20110303/
- Latest published version:
- https://www.w3.org/TR/xmlsec-rngschema/
- Latest editor's draft:
- https://www.w3.org/2008/xmlsec/Drafts/xmlsec-rngschema/
- Previous version:
- https://www.w3.org/TR/2010/WD-xmlsec-rngschema-20100831/
- Editors:
- Makoto Murata, Invited Expert
- Frederick Hirsch, Nokia
Copyright © 2011 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C liability, trademark and document use rules apply.
Abstract
This document serves to publish RELAX NG schemas for XML Security specifications, including XML Signature 1.1, and XML Signature Properties.
Status of This Document
This section describes the status of this document at the time of its publication. Other documents may supersede this document. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.
This Working Draft collects non-normative RELAX NG Schemas for XML Security specifications, including XML Signature 1.1, XML Encryption 1.1, XML Security Generic Hybrid Ciphers and XML Signature Properties. The normative description of the respective data formats are included in the Recommendation-track Working Drafts.
These schemas are drafts and subject to further revisions. This is a work in progress. This document is intended to evolve to include additional RELAX NG schemas.
This specification has been updated since the 31 August 2010 publication to also reference rng files in addition to rnc files. The references have also been updated. Please review differences between this and the previous Working Draft.
This document was published by the XML Security Working Group as a Working Draft. If you wish to make comments regarding this document, please send them to public-xmlsec@w3.org (subscribe, archives). All feedback is welcome.
Publication as a Working Draft does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.
This document was produced by a group operating under the 5 February 2004 W3C Patent Policy. The group does not expect this document to become a W3C Recommendation. W3C maintains a public list of any patent disclosures made in connection with the deliverables of the group; that page also includes instructions for disclosing a patent. An individual who has actual knowledge of a patent which the individual believes contains Essential Claim(s) must disclose the information in accordance with section 6 of the W3C Patent Policy.
Table of Contents
1. Introduction
The XML Security specifications include normative XML Schema [XMLSCHEMA-1], [XMLSCHEMA-2]. This note provides non-normative RELAX NG schemas in compact form [RELAXNG-SCHEMA].
These RELAX NG schemas are highly modularized. This
modularization has two significant advantages. First, it is
easy to create schemas dedicated to enveloped or enveloping
signatures. Second, it is easy to
create schemas for imposing tight constraints where
<xsd:any> in the original XSD schemas does not impose such
tight constraints.
However, this modularization increases the number of schema modules.
First, a wildcard schema is needed for each core schema
(e.g., xmldsig-core-schema.rnc (xmldsig-core-schema.rng)
and xenc-schema.rnc (xenc-schema.rng)).
Wildcard schemas mimic <xsd:any> in core schemas. A
wildcard can be further customized by a driver schema or it
can be simply replaced by another schema when tight
constraints have to be hardcoded.
Second, one top-level schema is needed for each combination of core schemas and the choice from the "enveloping" and "enveloped" options. In this note, we only provide top-level schemas for enveloped signatures or encryptions, but it is easy to create top-level schemas for enveloping signatures.
2. Included RNG Schema files
This section is non-normative.
The following are RELAX NG schema files that are included in other files described in this document.
- Define
anyElementandanyAttribute - any.rnc (any.rng)
- Exclusive Canonicalization Algorithms RNG Schema Definitions
-
exclusiveC14N.rnc (exclusiveC14N.rng)
RNG Schema to allow Exclusive Canonicalization algorithms.
3. XML Signature 1.0 RNG Schema
This section is non-normative.
The following are RELAX NG schemas for XML Signature 1.0 [XMLDSIG-CORE].
- XML Signature Core RELAX NG Schema Instance
- xmldsig-core-schema.rnc (xmldsig-core-schema.rng)
- This is the schema corresponding to XML Signature 1.0, Second Edition.
- RELAX NG XML Signature 1.0 Top-Level Schema
- any-containing-xmldsig.rnc (any-containing-xmldsig.rng)
- Any correct use of XML Signature 1.0 schema is expected be valid against this top-level schema.
- RELAX NG XML Signature 1.0 schema, allowing Exclusive Canonicalization
- any-containing-xmldsig-exclusiveC14N.rnc (any-containing-xmldsig-exclusiveC14N.rng)
- Any correct use of XML Signature 1.0 schema is expected be valid against this top-level schema, including use of the Exclusive Canonicalization algorithm.
- RELAX NG Schema corresponding to
xsd:any - xmldsig-allowAnyForeign.rnc (xmldsig-allowAnyForeign.rng)
- This is used by the top-level schema to mimic
xsd:any.
4. XML Signature 1.1 RNG Schema
This section is non-normative.
The following are RELAX NG schemas for XML Signature 1.1 [XMLDSIG-CORE1].
- XML Signature 1.1 RELAX NG Schema Instance
- xmldsig11-schema.rnc (xmldsig11-schema.rng)
- RELAX NG XML Signature 1.1 Top-Level Schema
- any-containing-xmldsig11.rnc (any-containing-xmldsig11.rng)
- Any correct use of XML Signature 1.1 schema is expected be valid against this top-level schema.
- RELAX NG Schema corresponding to
xsd:any - xmldsig11-allowAnyForeign.rnc (xmldsig11-allowAnyForeign.rng)
- This is used by the top-level schema to mimic
xsd:any.
5. XML Signature Properties RNG Schema
This section is non-normative.
The following are RELAX NG schemas for XML Signature Properties [XMLDSIG-PROPERTIES].
- Signature Properties RNG Schema Instance
-
xmldsig-properties-schema.rnc (xmldsig-properties-schema.rng)
Valid RNG Schema instance.
- RELAX NG XML Signature 1.1 with Properties Top-Level Schema
- any-containing-xmldsig11-properties.rnc (any-containing-xmldsig11-properties.rng)
- Any correct use of XML Signature 1.1 schema containing Signature Properties defined in this specification is expected be valid against this top-level schema.
- RELAX NG XML Signature 1.1 with Properties Top-Level Schema, allowing Exclusive Canonicalization
- any-containing-xmldsig11-properties-exclusiveC14N.rnc (any-containing-xmldsig11-properties-exclusiveC14N.rng)
- Any correct use of XML Signature 1.1 schema containing Signature Properties defined in this specification is expected be valid against this top-level schema, including use of Exclusive Canonicalization algorithm.
6. XML Encryption 1.0 RNG Schema
This section is non-normative.
The following is a RELAX NG schema for XML Encryption 1.0 [XMLENC-CORE].
- XML Encryption 1.0 RELAX NG Schema Instance
- xenc-schema.rnc (xenc-schema.rng)
- This is the schema corresponding to XML Encryption 1.0.
- RELAX NG XML Encryption 1.0 Top-Level Schema
- any-containing-encryption.rnc (any-containing-encryption.rng)
- Any correct use of XML Encryption schema is expected be valid against this top-level schema.
- RELAX NG Schema corresponding to
xsd:any - xenc-allowAnyForeign.rnc (xenc-allowAnyForeign.rng)
- This is used by the top-level schema to mimic
xsd:any.
7. XML Encryption 1.1 RNG Schema
This section is non-normative.
The following are RELAX NG schemas for XML Encryption 1.1 [XMLENC-CORE1].
- XML Encryption 1.1 RELAX NG Schema Instance
- xenc-schema-11.rnc (xenc-schema-11.rng)
- RELAX NG XML Encryption 1.1 Top-Level Schema
- any-containing-encryption11.rnc (any-containing-encryption11.rng)
- Any correct use of XML Encryption 1.1 schema is expected be valid against this top-level schema.
- RELAX NG Schema corresponding to
xsd:any - xenc11-allowAnyForeign.rnc (xenc11-allowAnyForeign.rng)
8. XML Security Generic Hybrid Ciphers RNG Schema
This section is non-normative.
The following are RELAX NG schemas for XML Security Generic Hybrid Ciphers [XMLSEC-GHCIPHERS].
- XML Security Generic Hybrid Ciphers RELAX NG Schema Instance
- xmlsec-gh-schema.rnc (xmlsec-gh-schema.rng)
- RELAX NG XML Security Generic Hybrid Ciphers Top-Level Schema
- any-containing-encryption11-gh.rnc (any-containing-encryption11-gh.rng)
- Any correct use of XML Security Generic Hybrid Ciphers is expected be valid against this top-level schema.
- RELAX NG Schema corresponding to
xsd:any - xmlsec-gh-allowAnyForeign.rnc (xmlsec-gh-allowAnyForeign.rng)
A. References
Dated references below are to the latest known or appropriate edition of the referenced work. The referenced works may be subject to revision, and conformant implementations may follow, and are encouraged to investigate the appropriateness of following, some or all more recent editions or replacements of the works cited. It is in each case implementation-defined which editions are supported.
A.1 Normative references
No normative references.
A.2 Informative references
- [RELAXNG-SCHEMA]
- Information technology -- Document Schema Definition Language (DSDL) -- Part 2: Regular-grammar-based validation -- RELAX NG. ISO/IEC 19757-2:2008. URI: https://standards.iso.org/ittf/PubliclyAvailableStandards/c052348_ISO_IEC_19757-2_2008(E).zip
- [XMLDSIG-CORE]
- Joseph Reagle; et al. XML Signature Syntax and Processing (Second Edition). 10 June 2008. W3C Recommendation. URL: https://www.w3.org/TR/2008/REC-xmldsig-core-20080610
- [XMLDSIG-CORE1]
- D. Eastlake, J. Reagle, D. Solo, F. Hirsch, T. Roessler, K. Yiu. XML Signature Syntax and Processing Version 1.1. 3 March 2011. W3C Candidate Recommendation. (Work in progress.) URL: https://www.w3.org/TR/2011/CR-xmldsig-core1-20110303/
- [XMLDSIG-PROPERTIES]
- Frederick Hirsch. XML Signature Properties. 3 March 2011. W3C Candidate Recommendation. (Work in progress.) URL: https://www.w3.org/TR/2011/CR-xmldsig-properties-20110303/
- [XMLENC-CORE]
- Donald Eastlake; Joseph Reagle. XML Encryption Syntax and Processing. 10 December 2002. W3C Recommendation. URL: https://www.w3.org/TR/2002/REC-xmlenc-core-20021210/
- [XMLENC-CORE1]
- J. Reagle; D. Eastlake, F. Hirsch, T. Roessler XML Encryption Syntax and Processing Version 1.1. 3 March 2011. W3C Candidate Recommendation. (Work in progress.) URL: https://www.w3.org/TR/2011/CR-xmlenc-core1-20110303/
- [XMLSCHEMA-1]
- Henry S. Thompson; et al. XML Schema Part 1: Structures Second Edition. 28 October 2004. W3C Recommendation. URL: https://www.w3.org/TR/2004/REC-xmlschema-1-20041028/
- [XMLSCHEMA-2]
- Paul V. Biron; Ashok Malhotra. XML Schema Part 2: Datatypes Second Edition. 28 October 2004. W3C Recommendation. URL: https://www.w3.org/TR/2004/REC-xmlschema-2-20041028/
- [XMLSEC-GHCIPHERS]
- Magnus Nyström; Frederick Hirsch. XML Security Generic Hybrid Ciphers. 3 March 2011. W3C Candidate Recommendation. (Work in progress.) URL: https://www.w3.org/TR/2011/CR-xmlsec-generic-hybrid-20110303/