Attribute In Metadata Matching Rule
This matching rule evaluates to true if the attribute requester's metadata contains a
<RequestedAttribute> element matching a designated attribute (since v2.4).
This filter requires that the metadata for the attribute requester is loaded and available. It looks for an
<AttributeConsumingService> element in the SP's metadata that corresponds to the authentication request (either by default or by explicit reference via an
AttributeConsumingServiceIndex attribute in the request message). Matching then proceeds based on the contents of that element.
Limited support is provided for value matching. Using simple
<AttributeValue> elements in metadata works to filter specific values of matched attributes.
Define the Rule
This matching rule cannot be used in a policy requirement rule, only in attribute rules.
This rule is defined by the element
<PermitValueRule xsi:type="saml:AttributeInMetadata">, for permit value rules, with the following optional attributes:
- onlyIfRequired - match only if the requested attribute is flagged in the metadata as
isRequired, defaults to true
- matchIfMetadataSilent - match if the metadata contains no
<AttributeConsumingService>element at all, defaults to false.
- attributeName - match if an attribute with the given name is listed in SP metadata (version 2.4.3 and later)
- attributeNameFormat - match if an attribute with the given format is listed in SP metadata (version 2.4.3 and later)
In version 2.4.3 and later, you can also include
attributeNameFormat attributes that specify a SAML Attribute to match on that is not the same as the one that is derived by examining the encoders configured for the attribute you're trying to release. In other words, in the above example, you could add
attributeName="https://example.com/customAttribute" to release
eduPersonPrincipalName if a custom attribute name is requested in metadata. In the following example, the
eduPersonTargetedID attribute is released if the
eduPersonPrincipalName attribute (urn:oid:188.8.131.52.4.1.59184.108.40.206.6) is listed in SP metadata:
More complete examples are found elsewhere in this wiki.