SimpleAggregationAttributeResolver
Overview
Identified by type="SimpleAggregation"
, this AttributeResolver supports a primitive form of aggregation of attributes from multiple sources of authority through the use of SAML 2.0 attribute queries using an identifier derived from the attributes obtained prior to this plugin executing. In other words, the original data is used as input to form follow-up requests to other sources.
This simple form of aggregation relies on a plain-text identifier (which could be pseudonymous but is still "seen" by the SP) as a "link" to accounts at other SAML attribute authorities. Furthermore, this plugin only supports the same forms of authentication usable when making primary attribute queries with the Query plugin. This includes mechanisms like client TLS, message signing, or some forms of HTTP authentication, but is not "presence-oriented"; that is, there is no proof supplied the user is "present" at the SP, so there are no constraints on when the SP could perform such queries.
Conceptually, you can think of this mechanism as equivalent to a networked set of LDAP or X.500 directories queried by DN, merely in SAML terms. It is, however, relatively easy to implement and support when there are batch processes in place for the exchange of identity data to establish the links. No user intervention is required, which is a plus for simplicity but a minus for privacy and user control.
After each query is performed, the resolver applies the attribute extractor and filter plugin(s) configured for the application before continuing with other queries and eventually returning the resulting attributes. Each filtering step will operate on only the attributes extracted as a result of a particular query, and the filter policies can be expressed in terms of the actual "issuer" of each set of attributes for fine-grained control.
Reference
XML Namespaces
This page refers to the following XML namespaces:
Prefix | Namespace URI | Description |
---|---|---|
saml2 | urn:oasis:names:tc:SAML:2.0:assertion | SAML 2.0 Assertion namespace |
Attributes
The following optional attributes are supported:
Name | Type | Default | Description |
---|---|---|---|
policyId | string |
| Optional identifier of a customized security policy to use when performing the query |
attributeId | whitespace-delimited list of strings | Optional list of attribute IDs to search for a value to use as the identifier in the queries performed. The first attribute value found will be used as the value of the <NameID> in the query. If this attribute is omitted, the original <NameID> supplied by the user's original IdP is simply copied directly. | |
format | URI | Optional value to use as the Format attribute in a "generated" <NameID> element created from an arbitrary source attribute using the attributeId setting above. This value is ignored if the attributeId setting is omitted, or if the specified attribute used is a so-called "NameID-valued" attribute that resulted from a NameID-aware attribute decoder | |
subjectMatch | boolean | false | If true, enforces SAML "strong matching" requirements on the subject of the resulting assertions. By default, each AA is trusted to return an assertion about the queried subject without explicitly comparing the result. |
exceptionId | string | Optional identifier of a special attribute to create in the event of a "transient" failure during the aggregation process. Errors are considered transient if they are caused by system outages or misconfiguration. If an IdP appears to support the query protocol, then transient errors include any failure to obtain a successful SAML response or a violation of security policy while processing the result. If such errors occur, the attribute will contain one or more URL-encoded exception messages, and the application should be aware that not all of the "usual" attributes it might receive are available. |
Child Elements
The following optional child elements are supported:
Name | Cardinality | Description | |
---|---|---|---|
<Entity> | 0 or more | The value of the element is an entityID to query against. Metadata for a SAML 2.0 Attribute Authority role must be available. | |
<EntityReference> | 0 or more | The value of the element is the ID of an attribute available for the user. Each of the attribute's serialized values is interpreted as an entityID, as per the <Entity> element above. | |
<saml2:Attribute> | 0 or more | Supplies a set of attribute and value filters to include in any queries | |
0 or 1 | Supplies a dedicated MetadataProvider to use in place of the application-defined source. | ||
0 or 1 | Supplies a dedicated TrustEngine to use in place of the application-defined engine. | ||
0 or 1 | Supplies a dedicated AttributeExtractor to use in place of the application-defined extractor. |
Note that the <Entity>
and <EntityReference>
elements can be supplied in any order, and are processed in the order they appear, with a query attempt per entityID
obtained.
Example
SimpleAggregation Example
<!-- Uses eduPersonPrincipalName from IdP to query, and asks for eduPersonEntitlement. -->
<AttributeResolver type="SimpleAggregation" attributeId="eppn" format="urn:oid:1.3.6.1.4.1.5923.1.1.1.6">
<Entity>https://ieee.org/idp/shibboleth</Entity>
<EntityReference>External-Links</EntityReference>
<saml2:Attribute xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion" Name="urn:oid:1.3.6.1.4.1.5923.1.1.1.7" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="eduPersonEntitlement"/>
</AttributeResolver>