{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Shibboleth makes heavy use of the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"extension","type":"text","marks":[{"type":"link","attrs":{"href":"https://wiki.oasis-open.org/security/SAML2MetadataAttr"}}]},{"text":" in SAML metadata to attach \"tags\" to metadata either directly or via ","type":"text"},{"text":"metadata filter","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP5/pages/3199507147"}}]},{"text":" and use the tags to drive ","type":"text"},{"text":"configuration","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP5/pages/3199508127"}}]},{"text":" or many other use cases within the software. It is potentially useful to extend this approach to many local use cases that are outside the direct scope of the software. For example, one might wish to use tags to attach other pieces of information to SP metadata in order to perform access control functions or customize the user interface in unexpected ways.","type":"text"}]},{"type":"paragraph","content":[{"text":"This example deals with how to conveniently access custom tags for more “unanticipated” purposes, rather than any of the usual features of the software that already know how to operate based on tags. Two obvious cases are using them in view templates or in scripts.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that all of these examples assume the use of URI-based naming; that is, they assume the underlying SAML ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"NameFormat","type":"text","marks":[{"type":"code"}]},{"text":" value is set to ","type":"text"},{"text":"urn:oasis:names:tc:SAML:2.0:attrname-format:URI","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Notably, none of this is strictly required if you can utilize the Attribute Resolver for your use case (and you almost always can do that). There’s an ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP5/pages/3255074817"}},{"text":"now that can automate this process.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Foundational Beans","type":"text"}]},{"type":"paragraph","content":[{"text":"The basis of both use cases is to define a Spring bean (or beans) to pull the tags desired out of the metadata and expose them. There are already classes able to do this as part of the implementation of the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP5/pages/3199508127"}},{"text":" feature and there are parent beans defined to make use of them to insulate the deployer from those classes.","type":"text"}]},{"type":"paragraph","content":[{"text":"There are different classes defined to handle different data types. By far the most likely need is for String data, or multiple String values in a Set or List. Pick the parent bean needed based on the data type you wish to expose from the tag. The hyperlinks reference the underlying class documentation describing the options supported. These parent beans expose a single String, Boolean, Integer, Long, Double, or Duration:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupString","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.StringConfigurationLookupStrategy"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupBoolean","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.BooleanConfigurationLookupStrategy"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupInteger","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.IntegerConfigurationLookupStrategy"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupLong","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.LongConfigurationLookupStrategy"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupDouble","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.DoubleConfigurationLookupStrategy"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupDuration","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.DurationConfigurationLookupStrategy"}}]}]}]}]},{"type":"paragraph","content":[{"text":"These two beans expose a type-safe collection (either a List or Set) of a primtive type:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupList","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.ListConfigurationLookupStrategy"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupSet","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.SetConfigurationLookupStrategy"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Finally, this special bean allows the value of the tag to actually reference the ID of a Spring Bean in the configuration.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"shibboleth.TagLookupBean","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://shibboleth.net/cgi-bin/java-attribute.cgi/net.shibboleth.idp.attribute.config.BeanConfigurationLookupStrategy"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"To access an ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" tag named ","type":"text"},{"text":"https://example.org/tags/custom1","type":"text","marks":[{"type":"code"}]},{"text":" as a single String value, create the following bean definition (in ","type":"text"},{"text":"global.xml","type":"text","marks":[{"type":"em"}]},{"text":" or some other directly applicable file):","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"explicitPropertyName","type":"text","marks":[{"type":"code"}]},{"text":" setting is necessary to allow reuse of these classes without triggering their built-in behavior that looks for tags using special prefixes for the ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://shibboleth.atlassian.net/wiki/spaces/IDP5/pages/3199508127"}},{"text":" feature. Turning off caching is usually advisable because that feature was designed to optimize multiple lookups of the same tag as would be common when accessing configuration settings. For most one-off use cases, the caching isn’t needed and probably costs more in time than it’s worth, but it could be used.","type":"text"}]},{"type":"paragraph","content":[{"text":"The same example, but handling multiple ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" elements in the metadata and exposing them all as a Set:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Views","type":"text"}]},{"type":"paragraph","content":[{"text":"Using these lookup beans in a view template just requires wiring it into the ","type":"text"},{"text":"shibboleth.CustomViewContext","type":"text","marks":[{"type":"strong"}]},{"text":" bean in ","type":"text"},{"text":"global.xml","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"Obviously you can add this to any existing map content or add multiple lookup beans with appropriate names for clarity.","type":"text"}]},{"type":"paragraph","content":[{"text":"To call a lookup bean from a Velocity view, just do:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"plaintext"},"content":[{"text":"$custom[\"tagLookup\"].apply($profileRequestContext)","type":"text"}]},{"type":"paragraph","content":[{"text":"The result of the expression will be the value of the tag or null.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Scripts","type":"text"}]},{"type":"paragraph","content":[{"text":"Using these lookup beans in a scripted function, condition, etc. just requires injecting the bean via the customObjectRef hook common to such cases:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"The above is a pathological example since the script just returns the same thing as directly calling the function but illustrates how to make use of the tag in a more general case.","type":"text"}]}],"version":1}