XACML v3.0 Multiple Decision Profile Version 1.0
Committee Specification 02
18 May 2014
Specification URIs
This version:
http://docs.oasis-open.org/xacml/3.0/multiple/v1.0/cs02/xacml-3.0-multiple-v1.0-cs02.doc (Authoritative)
http://docs.oasis-open.org/xacml/3.0/multiple/v1.0/cs02/xacml-3.0-multiple-v1.0-cs02.html
http://docs.oasis-open.org/xacml/3.0/multiple/v1.0/cs02/xacml-3.0-multiple-v1.0-cs02.pdf
Previous version:
http://docs.oasis-open.org/xacml/3.0/xacml-3.0-multiple-v1-spec-cs-01-en.doc (Authoritative)
http://docs.oasis-open.org/xacml/3.0/xacml-3.0-multiple-v1-spec-cs-01-en.html
http://docs.oasis-open.org/xacml/3.0/xacml-3.0-multiple-v1-spec-cs-01-en.pdf
Latest version:
http://docs.oasis-open.org/xacml/3.0/multiple/v1.0/xacml-3.0-multiple-v1.0.doc (Authoritative)
http://docs.oasis-open.org/xacml/3.0/multiple/v1.0/xacml-3.0-multiple-v1.0.html
http://docs.oasis-open.org/xacml/3.0/multiple/v1.0/xacml-3.0-multiple-v1.0.pdf
Technical Committee:
OASIS eXtensible Access Control Markup Language (XACML) TC
Chairs:
Bill Parducci (bill@parducci.net), Individual
Hal Lockhart (hal.lockhart@oracle.com), Oracle
Editor:
Erik Rissanen (erik@axiomatics.com), Axiomatics
Related work:
This specification replaces or supersedes:
This specification is related to:
Abstract:
This document provides a profile for requesting more than one access control decision in a single XACML Request Context, or for requesting a single combined decision based on multiple individual decisions.
Status:
This document was last revised or approved by the OASIS eXtensible Access Control Markup Language (XACML) TC on the above date. The level of approval is also listed above. Check the “Latest version” location noted above for possible later revisions of this document.
Technical Committee members should send comments on this specification to the Technical Committee’s email list. Others should send comments to the Technical Committee by using the “Send A Comment” button on the Technical Committee’s web page at https://www.oasis-open.org/committees/xacml/.
For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the Technical Committee web page (https://www.oasis-open.org/committees/xacml/ipr.php).
Citation format:
When referencing this specification the following citation format should be used:
[xacml-3.0-multiple-v1.0]
XACML v3.0 Multiple Decision Profile Version 1.0. Edited by Erik Rissanen. 18 May 2014. OASIS Committee Specification 02. http://docs.oasis-open.org/xacml/3.0/multiple/v1.0/cs02/xacml-3.0-multiple-v1.0-cs02.html. Latest version: http://docs.oasis-open.org/xacml/3.0/multiple/v1.0/xacml-3.0-multiple-v1.0.html.
Notices
Copyright © OASIS Open 2014. All Rights Reserved.
All capitalized terms in the following text have the meanings assigned to them in the OASIS Intellectual Property Rights Policy (the "OASIS IPR Policy"). The full Policy may be found at the OASIS website.
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to OASIS, except as needed for the purpose of developing any document or deliverable produced by an OASIS Technical Committee (in which case the rules applicable to copyrights, as set forth in the OASIS IPR Policy, must be followed) or as required to translate it into languages other than English.
The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns.
This document and the information contained herein is provided on an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
OASIS requests that any OASIS Party or any other party that believes it has patent claims that would necessarily be infringed by implementations of this OASIS Committee Specification or OASIS Standard, to notify OASIS TC Administrator and provide an indication of its willingness to grant patent licenses to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification.
OASIS invites any party to contact the OASIS TC Administrator if it is aware of a claim of ownership of any patent claims that would necessarily be infringed by implementations of this specification by a patent holder that is not willing to provide a license to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification. OASIS may include such claims on its website, but disclaims any obligation to do so.
OASIS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on OASIS' procedures with respect to rights in any document or deliverable produced by an OASIS Technical Committee can be found on the OASIS website. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be obtained from the OASIS TC Administrator. OASIS makes no representation that any information or list of intellectual property rights will at any time be complete, or that any claims in such list are, in fact, Essential Claims.
The name "OASIS" is a trademark of OASIS, the owner and developer of this specification, and should be used only to refer to the organization and its official outputs. OASIS welcomes reference to, and implementation and use of, specifications, while reserving the right to enforce its marks against misleading uses. Please see https://www.oasis-open.org/policies-guidelines/trademark for above guidance.
Table of Contents
1.1 Background (non-normative)
3 Requests for multiple decisions
3.1 Nodes identified by “scope”
3.1.2 Original request context syntax
3.2.2 Original request context
3.3 Repeated <Attributes> categories
3.3.2 Original request context
3.4 By reference to <Attributes> elements
3.4.2 Original request context
4 Requests for a combined decision
5 Conceptual model for creating Individual Decision Requests
8.1 Processor of requests for multiple decisions as nodes identified by “scope”
8.2 Processor of requests for multiple decisions as nodes identified by XPath
8.3 Processor of requests for multiple decisions by multiple <Attributes> elements
8.4 Processor of requests for multiple decisions by reference to <Attributes> elements
8.5 Processor of requests for a combined decision
The policy evaluation performed by an XACML Policy Decision Point, or PDP, is defined in terms of a single decision request in the XACML Specification [XACML], with the authorization decision contained in a single <Result> element of the response context. A Policy Enforcement Point, or PEP, however, may wish to submit a single request context for multiple access control decisions, and may wish to obtain a single response context that contains a separate authorization decision (<Result> element) for each requested decision. Such a request context might be used to avoid sending multiple decision request messages between a PEP and PDP, for example. Additionally, a PEP may wish to submit a single request context for multiple decisions, and may wish to obtain a single authorization decision (<Result> element) that indicates whether access is permitted to all of the requested decisions. Such a request context might be used when the requester wants access to an entire XML document, to an entire sub-tree of elements in such a document, or to an entire file system directory with all its subdirectories and files, for example.
This Profile describes several ways in which a PEP can request multiple authorization decisions in a single request context, and how the result of each such authorization decision is represented in the single response context that is returned to the PEP.
This Profile also describes a mechanism by which a PEP can request a single combined authorization decision in response to a request for multiple decisions.
Support for each of the mechanisms described in this Profile is optional for compliant XACML implementations.
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in [RFC2119].
[Hierarchical] XACML v3.0 Hierarchical Resource Profile Version 1.0, 10 August 2010. Committee Specification 01. http://docs.oasis-open.org/xacml/3.0/xacml-3.0-55 hierarchical-v1-spec-cs-01-en.doc
[RFC2119] Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels”, BCP 14, RFC 2119, March 1997. http://www.ietf.org/rfc/rfc2119.txt.
[XACML] eXtensible Access Control Markup Language (XACML) Version 3.0, 22 January 2013. OASIS Standard. http://docs.oasis-open.org/xacml/3.0/xacml-3.0-core-spec-os-en.doc
[XPath] XML Path Language (XPath), Version 1.0, W3C Recommendation 16, November 1999. Available at http://www.w3.org/TR/xpath
None
Hierarchical resource
A resource that is organized as a tree or forest (Directed Acyclic Graph) of individual resources called nodes.
Node
An individual resource that is part of a hierarchical resource.
Commonly used resource attributes are abbreviated as follows:
“resource-id” attribute
A resource attribute with an AttributeId of “urn:oasis:names:tc:xacml:1.0:resource:resource-id”.
“scope” attribute
A resource attribute with an AttributeId of “urn:oasis:names:tc:xacml:2.0:resource:scope”. See Section 6.1 for more information about this attribute.
“content-selector”
An attribute with an AttributeId of “urn:oasis:names:tc:xacml:3.0:content-selector”. See [Hierarchical] for more information about this attribute.
“multiple:content-selector”
An attribute with an AttributeId of “urn:oasis:names:tc:xacml:3.0:profile:multiple:content-selector”. See section 3.2 for more information about this attribute.
A single XACML request context MAY represent a request for multiple access control decisions. The syntax and semantics of such requests and responses are specified in this Section.
The <Result> elements produced by evaluating a request for multiple access control decisions SHALL be identical to those that would be produced from a series of requests, each requesting exactly one of the decisions. Each such decision is called an Individual Decision. The conceptual request context that corresponds to each <Result> element is called an Individual Decision Request. This mapping of an original request context containing multiple authorization decision requests to Individual Decision Requests, and the corresponding mapping of multiple authorization decisions to multiple <Result> elements in a single response context MAY be performed by the Context Handler described in the non-normative Data-flow model of the core XACML specification [XACML].
Several ways of specifying requests for multiple access control decisions are described in the following Sections. Each way of specifying requests describes the Individual Decision Requests that correspond to the <Result> elements in the response context.
A single XACML request context submitted by a PEP MAY use more than one of these ways of requesting access to multiple decisions.
This Section describes the use of two values for the “scope“ resource attribute to specify a request for access to multiple resources in a hierarchy. This syntax MAY be used with any hierarchical resource [Hierarchical] which is not an XML document. The “scope” resource attribute is defined in Section6.1.
The following URI SHALL be used as a URI identifier for the functionality specified in this Section of this Profile. This identifier represents metadata about this specification and implementations implementing this specification. The identifier MAY be used to describe capabilities of an implementation or to make other references to this specification.
The original XACML request context <Attributes> element in the resource category SHALL contain a “scope” attribute with a value of either “Children”, or “Descendants”.
Such a request context SHALL be interpreted as a request for access to a set of nodes in a hierarchy relative to the single node specified in the “resource-id” attribute. If the value of the “scope” attribute is “Children”, each Individual Decision Request is for the one node indicated by the “resource-id” attribute (or attributes, where the single resource has multiple normative identifiers) and all of its immediate child nodes. If the value of the “scope” attribute is “Descendants”, the Individual Decision Request is for the one node indicated by the “resource-id” attribute and all of its descendant nodes.
Each Individual Decision Request SHALL be identical to the original request context with two exceptions: the “scope” attribute SHALL NOT be present and the <Attributes> element in the resource category SHALL represent a single Individual Resource. This <Attributes> element SHALL contain at least one “resource-id” attribute, and all values for such attributes SHALL be unique, normative identities of the Individual Resource. If the “resource-id” attribute in the original request context contained an Issuer, the “resource-id” attributes in the Individual Resource Request SHALL contain the same Issuer. The “resource-id” attributes in the Individual Decision Request SHALL contain the same IncludeInResult value as the “resource-id” attribute in the original request context
Neither XACML nor this Profile specifies how the Context Handler obtains the information required to determine which nodes are children or descendants of a given node.
This Section describes use of an XPath [XPath] expression in the “multiple:content-selector” attribute to specify a request for access described by multiple nodes in an XML document. This syntax SHALL be used only with resources, subjects, actions or other categories which are or are described by XML documents.
The following URI SHALL be used as the URI identifier for the functionality specified in this Section of this Profile. This identifier represents metadata about this specification and implementations implementing this specification. This identifier MAY be used to describe capabilities of an implementation or to make other references to this specification.
The original XACML request context <Attributes> element SHALL contain a <Content> element and a “multiple:content-selector” attribute with a DataType of “urn:oasis:names:tc:xacml:3.0:data-type:xpathExpression”, such that the <AttributeValue> of the “multiple:content-selector” attribute is an XPath expression that evaluates to a nodeset that represents multiple nodes in the <Content> element.
Such a request context SHALL be interpreted as a request for individual decisions regarding each of the nodes in the nodeset selected by the XPath expression given in the <AttributeValue> of the “multiple:content-selector” attribute.
Each Individual Decision Request SHALL be identical to the original request context with two exceptions: the “multiple:content-selector” attribute SHALL NOT be present and an added “content-selector” attribute value SHALL be an XPath expression that evaluates to a single node in the <Content> element. If the “multiple:content-selector” attribute in the original request context contained an Issuer, the “content-selector” attribute in the Individual Decision Request SHALL contain the same Issuer. The “content-selector” attribute in the Individual Decision Request SHALL contain the same IncludeInResult as the “multiple:content-selector” attribute in the original request context,
If multiple <Attributes> elements in different categories contain a “multiple:content-selector” attribute, then the set of Individual Decision Requests will be formed from the the cross product of the nodesets selected by the “multiple:content-selector” XPath expressions in the different different categories. See Section 5 for detailed description of the processing model.
This Section describes use of multiple <Attributes> elements with repeated category in a request context to specify a request for access to multiple decisions. This syntax MAY be used with any resource or resources, or any other category, regardless of whether they are XML documents or not and regardless of whether they are hierarchical resources [Hierarchical] or not.
The following URI SHALL be used as the URI identifier for the functionality specified in this Section of this Profile. This identifier represents metadata about this specification and implementations implementing this specification. This identifier MAY be used to describe capabilities of an implementation or to make other references to this specification
The XACML request context SHALL contain multiple <Attributes> elements with equal category.
Such a request context SHALL be interpreted as a request for access to all situations specified in the individual <Attributes> elements. Each <Attributes> element SHALL represent one Individual Resource, subject, or another category unless that element utilizes the other mechanisms described in this Profile.
For each combination of repeated <Attributes> elements, one Individual Decision Request SHALL be created. This Individual Request SHALL be identical to the original request context with one exception: only one <Attributes> element of each repeated category SHALL be present. If such a <Attributes> element contains a “scope” attribute having any value other than “Immediate”, then the Individual Request SHALL be further processed according to the processing model specified in Section 5. This processing may involve decomposing the one Individual Decision Request into other Individual Decision Requests before evaluation by the PDP.
This section describes use of a list of references to <Attributes> elements to construct multiple individual <Request> elements.
The following URI SHALL be used as the URI identifier for the functionality specified in this Section of this Profile. This identifier represents metadata about this specification and implementations implementing this specification. This identifier MAY be used to describe capabilities of an implementation or to make other references to this specification.
The original XACML <Request> element SHALL contain a <MultiRequests> element.
Such a request context SHALL be interpreted as multiple individual request contexts specified by references to <Attributes> elements.
The context handler MUST construct a new <Request> element for each <RequestReference> element contained in the <MultiRequests> element, and process the generated <Request> element.
Each <RequestReference> element contains one or more <AttributesReference> elements, each of which refers to the xml:id XML attribute of one of the <Attributes> elements in the enclosing original <Request> element. The generated <Request> element MUST be identical to a <Request> element which contains the referenced <Attributes> elements.
The result(s) of each such generated <Request> element MUST be included as one or more <Result> elements in the <Response> element corresponding to the original <Request> element. There may be multiple results for a single generated <Request> element when the generated <Request> element makes use of one or more of the other multiple decision request schemes in this profile. There MUST be exactly one <Response> element for the original <Request> element.
If a <RequestReference> contains an invalid reference, then the corresponding <Result> MUST contain an Indeterminate decision with status code urn:oasis:names:tc:xacml:1.0:status:syntax-error.
A request for multiple decisions as specified by any of the schemes in section 3 MAY in addition specify that the Individual Decisions be combined into a single aggregated decision and that only this single combined decision will be returned to the PEP.
If the CombinedDecision attribute of the initial <Request> is True, then the <Response> MUST contain only a single combined decision in a single <Result> element, and the following apply to the combined decision, in the given order.
The following URI SHALL be used as the URI identifier for the functionality specified in this Section of this Profile. This identifier represents metadata about this specification and implementations implementing this specification. This identifier MAY be used to describe capabilities of an implementation or to make other references to this specification.
This profile specifies several independent schemes for Multiple Decision Requests in sections 3 and 4. Any combination of features described by these schemes MAY be used in an initial request. This section defines a normative processing model to create Individual Decision Requests from an initial request context in which one or more features of the multiple profile are present. This Profile does NOT REQUIRE that the implementation of the evaluation of a request for access to multiple decisions conform to the model below or that actual Individual Decision Requests be constructed. The Profile REQUIRES only that the <Result> elements SHALL be the same as if the model below were used. An implementation MUST produce identical results to those that would be produced by performing the following operations in the given order.
The following identifier is used as the AttributeId of a resource attribute that indicates the scope of a request for access in a single <Attributes> element of a request context.
The attribute SHALL have a DataType of “http://www.w3.org/2001/XMLSchema#string“.
The valid values for this attribute are listed below, along with a reference to the Section of this Profile or to the core XACML specification that describes how the <Attributes> element with the resource category is to be processed. An implementation MAY support any subset of these values, including the empty set.
The following URI values SHALL be used as URI identifiers for the functionality specified in various Sections of this Profile. These identifiers represent metadata about this specification and implementations implementing this specification. These identifiers MAY be used to describe capabilities of an implementation or to make other references to this specification
Section 3.1: “scope attribute of “children” or “descendants” in <Attributes>: Non-XML resources
Section 3.2: XPath expression in “multiple:content-selector” attribute
Section 3.3: Multiple <Attributes> elements with repeated attribute categories
Section 3.4: By reference to <Attributes> elements
Section 4: Requests for a combined decision
An implementation may conform to this specification in one or more of the following ways.
An implementation conforms as a processor of requests for multiple resources as nodes identified by “scope” if it is able to process XACML requests in the manner described in sections 3.1 and 5 of this specification. Conformance to this MAY be indidicated with the identifier urn:oasis:names:tc:xacml:3.0:profile:multiple:scope.
An implementation conforms as a processor of requests for multiple decisions as nodes identified by XPath if it is able to process XACML requests in the manner described in sections 3.2 and 5 of this specification. Conformance to this MAY be indicated with the identifier urn:oasis:names:tc:xacml:3.0:profile:multiple:xpath-expression.
An implementation conforms as a processor of requests for multiple decisions by multiple <Attributes> elements if it is able to process XACML requests in the manner described in sections 3.3 and 5 of this specification. Conformance to this MAY be indicated with the identifier urn:oasis:names:tc:xacml:3.0:profile:multiple:repeated-attribute-categories.
An implementation conforms as a processor of requests for multiple decisions by references to <Attributes> elements if it is able to process XACML requests in the manner described in sections 3.4 and of this specification. Conformance to this MAY be indicated with the identifier urn:oasis:names:tc:xacml:3.0:profile:multiple:reference.
An implementation conforms as a processor of requests for a combined decision if it is able to process XACML requests in the manner described in section 4 and 5 of this specification. Conformance to this MAY be indicated with the identifier urn:oasis:names:tc:xacml:3.0:profile:multiple:combined-decision.
The following individuals have participated in the creation of this specification and are gratefully acknowledged:
Participants:
Anil Saldhana
Anil Tappetla
Anne Anderson
Anthony Nadalin
Bill Parducci
Craig Forster
David Chadwick
David Staggs
Dilli Arumugam
Duane DeCouteau
Erik Rissanen
Gareth Richards
Hal Lockhart
Jan Herrmann
John Tolbert
Ludwig Seitz
Michiharu Kudo
Naomaru Itoi
Paul Tyson
Prateek Mishra
Rich Levinson
Ronald Jacobson
Seth Proctor
Sridhar Muppidi
Tim Moses
Vernon Murdoch
Revision |
Date |
Editor |
Changes Made |
WD 1 |
Erik Rissanen |
Initial update to XACML 3.0. |
|
WD 2 |
28 Dec 2007 |
Erik Rissanen |
Update to current OASIS template. |
WD 3 |
4 Nov 2008 |
Erik Rissanen |
Define behavior for the IncludeInResult attribute. |
WD 4 |
3 Mar 2009 |
Erik Rissanen |
Added the new <MultiRequests> scheme. |
WD 5 |
|
Erik Rissanen |
Changed error behavior in <MultiRequests> Clarified some text Editorial cleanups Conformance section |
WD 6 |
14 Dec 2009 |
Erik Rissanen |
Renamed to “Multiple Decision Profile”. Clarified meaning of metadata identifiers. Remove “scope” for XML resources. Replaced scope EntireHierarchy with decision combining algorithm. Added more detailed text about nesting of schemes. |
WD 07 |
17 Dec 2009 |
Erik Rissanen |
Update acknowledgments Don’t allow obligations in combined decisions Fix formatting issues |
WD 08 |
|
Erik Rissanen |
Drop decision combining algorithms in favor of a more restricted (and safer) decision combining scheme. |
WD 09 |
12 Jan 2010 |
Erik Rissanen |
Updated cross references Fix typos and improve wording. Updated acknowledgments |
WD 10 |
8 Mar 2010 |
Erik Rissanen |
Updated cross references Fixed OASIS formatting issues |
WD 11 |
20 Dec 2013 |
Erik Rissanen |
Migrated the content to the current OASIS document template. |
WD 12 |
11 Mar 2014 |
Erik Rissanen |
Fixed references. |