IncludeMetadataFilter

The Include MetadataFilter, identified by type="Include", deletes metadata for any entity not matched inside the plugin's configuration.

The original name of this filter type prior to V3.2 was "Whitelist", support for which will be removed in a future release.

Attributes

One attribute may be specified: matcher specifies an EntityMatcher plugin to use to identify the entities to include, allowing more flexible matching. Additional content will be included based on the type of plugin (see associated documentation).

Child Elements

Zero or more <Include> elements may be specified.  Each element's context  is matched against each entityID found in the source metadata to identify entities to keep.

Examples

Simple Whitelist
<MetadataFilter type="Include">
    <Include>https://idp.goodguy.com/shibboleth</Include>
</MetadataFilter>
Extended Example
<MetadataFilter type="Include" matcher="EntityAttributes">
    <saml:Attribute Name="http://macedir.org/entity-category-support" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri">
        <saml:AttributeValue>http://refeds.org/category/research-and-scholarship</saml:AttributeValue>
    </saml:Attribute>
</MetadataFilter>