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>