The Shibboleth IdP V4 software has reached its End of Life and is no longer supported. This documentation is available for historical purposes only. See the IDP5 wiki space for current documentation on the supported version.
ByReferenceFilter
Namespace: urn:mace:shibboleth:2.0:metadata
Schema: http://shibboleth.net/schema/idp/shibboleth-metadata.xsd
Overview
A filter of type ByReference
is a new syntax aid that allows MetadataFilterConfiguration to be defined outside of <MetadataProvider> elements and reference named providers "out of band", separating the declaration of general metadata source details from deployer-specific filtering rues.
There is nothing functionally different about using this approach; it's purely a configuration style issue.
The ByReference
syntax relies on a set of child elements named <MetadataFilters>
that contain a providerRef
XML attribute identifying the <MetadataProvider>Â to apply a set of filters to, and then the filters to apply are declared within, in the normal way.
Filter order is important!
This filter may or may not change the content of the metadata and so its use needs to be carefully coordinated with any inline filters. Out of band filters will run after any inline filters.
Reference
XML Elements
Name | Description |
---|---|
<MetadataFilters> | Each out of band declaration consists of a required XML attribute named |
Example
The examples shows a typical usage pattern via a separate Spring resource loaded into the metadata resolver service by adding it to the resource set in conf/services.xml (e.g., perhaps in a file named conf/metadata-filters.xml)
Â