Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The InEntityGroup type is a PolicyRule that returns true if the Name of any of the EntitiesDescriptors that the entity surrounding <EntitiesDescriptor> metadata of the requester is in matches the supplied parameter. This replaces the (deprecated) saml:AttributeRequesterInEntityGroup type from V2

As of V3.4, this is extended to include a matching <AffiliationDescriptor> membership.

Note

Membership in a InEntityGroup is rarely an effective way of making policy decisions. In general, base your attribute release policy on the characteristics of entity metadata only: SP entityID, entity attributes, and registration info. Avoid policy based on the characteristics of the aggregate itself.

...

If you do rely on groups, use the <AffiliationDescriptor> mechanism, supported in V3.4 and up.

Schema Type and Location

The InEntityGroup  type is defined by defined in the urn:mace:shibboleth:2.0:afp schema, afp namespace, the schema for which can be located at http://shibboleth.net/schema/idp/shibboleth-afp.xsd.Prior to release 3.2.0 the 

The deprecated saml:InEntityGroup  type is defined by defined in the urn:mace:shibboleth:2.0:afp:mf:saml  namespace, the schema , for which can be located at http://shibboleth.net/schema/idp/shibboleth-afp-mf-saml.xsd.

Use of that namespace is deprecated, but is supported.

Attributes

One attribute must be specified

  • groupID : a required attribute that specifies the EntitiesDescriptor Name to match against.

Reference

Attributes

NameTypeReq?DefaultDescription
groupID                   StringY
The<EntitiesDescriptor> Name to match against (or in V3.4+, a matching <AffiliationDescriptor>)
checkAffiliations 3.4Boolean
falseWhether to check metadata for <AffiliationDescriptor>-based matches

Child Elements

None

Example

Apply this rule if the entity for the SP is included in an <EntitiesDescriptor> or <AffiliationDescriptor> named urn:mace:example.org

Code Block
languagexml
<PolicyRequirementRule xsi:type="InEntityGroup" groupID="urn:mace:example.org" checkAffiliatons="true"/>

 

...