{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Namespace:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"urn:mace:shibboleth:2.0:metadata","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"Schema:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"http://shibboleth.net/schema/idp/shibboleth-metadata.xsd","type":"text","marks":[{"type":"link","attrs":{"href":"http://shibboleth.net/schema/idp/shibboleth-metadata.xsd"}}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"07a0b37a-efed-45fc-a740-151f1a409777"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"d7d3c876-e71a-47e0-80c7-91db5b4c2aa4"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"ChainingMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" is a container for an ordered sequence of metadata providers of any type. When conducting a search, the metadata resolver consults each child provider in the order in which it is listed. See the parent topic for a detailed description of the ","type":"text"},{"text":"search ordering algorithm used by the metadata resolver.","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631635#MetadataConfiguration-SearchOrdering"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference","type":"text"}]},{"type":"expand","attrs":{"title":"XML Attributes"},"content":[{"type":"table","attrs":{"layout":"wide","localId":"3db13bc7-478f-4831-8856-47f7927c4db2"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[92.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[90.0]},"content":[{"type":"paragraph","content":[{"text":"Req?","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1237.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"paragraph","content":[{"text":"id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[92.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[90.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1237.0]},"content":[{"type":"paragraph","content":[{"text":"Identifier for logging, identification for command line reload, etc.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[133.0]},"content":[{"type":"paragraph","content":[{"text":"xsi:type","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[92.0]},"content":[{"type":"paragraph","content":[{"text":"String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[90.0]},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"Y","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1237.0]},"content":[{"type":"paragraph","content":[{"text":"Must be set to ","type":"text"},{"text":"\"ChainingMetadataProvider\"","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"expand","attrs":{"title":"XML Elements"},"content":[{"type":"table","attrs":{"layout":"full-width","localId":"8d9914e5-0c8b-4528-8fba-fc7e7ab3efc8"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[235.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"Cardinality","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1193.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[235.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"MetadataProvider","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631635#MetadataConfiguration-MetadataProvider"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[124.0]},"content":[{"type":"paragraph","content":[{"text":"0 or more","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1193.0]},"content":[{"type":"paragraph","content":[{"text":"An ordered sequence of metadata providers of any type (except the ","type":"text"},{"text":"ChainingMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" type)","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Here is a brief summary of the examples in this section:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example 1: A traditional configuration using ","type":"text"},{"text":"FilesystemMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" for local metadata and ","type":"text"},{"text":"FileBackedHTTPMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" for federation metadata","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example 2: A \"no touch\" configuration using ","type":"text"},{"text":"LocalDynamicMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" for local metadata and ","type":"text"},{"text":"FileBackedHTTPMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" for federation metadata","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Example 3: A completely dynamic configuration using ","type":"text"},{"text":"LocalDynamicMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" for local metadata and ","type":"text"},{"text":"DynamicHTTPMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" for federation metadata","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The following example illustrates one or more providers of type ","type":"text"},{"text":"FilesystemMetadataProvider","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631640"}}]},{"text":" followed by a single ","type":"text"},{"text":"FileBackedHTTPMetadataProvider","type":"text","marks":[{"type":"code"},{"type":"link","attrs":{"href":"/wiki/spaces/IDP4/pages/1265631639"}}]},{"text":":","type":"text"}]},{"type":"expand","attrs":{"title":"Example 1: A traditional configuration"},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\t\n\t\n \n\t\n\t\n\t\n\t\n \n\t\n ","type":"text"}]},{"type":"paragraph","content":[{"text":"In the above example, local metadata is loaded before externally resolved federation metadata. This prevents federation metadata from accidentally overriding local metadata sources.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example is similar to the previous example except that multiple providers of type ","type":"text"},{"text":"FilesystemMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" have been replaced with a single ","type":"text"},{"text":"LocalDynamicMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]}]},{"type":"expand","attrs":{"title":"Example 2: A \"no touch\" configuration"},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\t\n\t\n \n\t\n\n\t\n \n\n \n\t\n ","type":"text"}]},{"type":"paragraph","content":[{"text":"In the above example, all local metadata is handled by a single ","type":"text"},{"text":"LocalDynamicMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":". In this way, new local metadata may be added to the system without touching the configuration.","type":"text"}]},{"type":"paragraph","content":[{"text":"The following example is similar to the previous example except that the provider of type ","type":"text"},{"text":"FileBackedHTTPMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" has been replaced with a ","type":"text"},{"text":"DynamicHTTPMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]}]},{"type":"expand","attrs":{"title":"Example 3: A completely dynamic configuration"},"content":[{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\t\n\t\n \n\t\n\t\n\t\n\t\n \n\t\n ","type":"text"}]},{"type":"paragraph","content":[{"text":"In the above example, federation metadata is sourced as needed (i.e., dynamically). This avoids having to load a large metadata aggregate.","type":"text"}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Avoid redundant providers in the chain","type":"text"}]},{"type":"paragraph","content":[{"text":"Resolve federation metadata with either a ","type":"text"},{"text":"FileBackedHTTPMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" (Example #2) or a ","type":"text"},{"text":"DynamicHTTPMetadataProvider","type":"text","marks":[{"type":"code"}]},{"text":" (Example #3) but not both. Assuming the same set of entities are represented in each case, the two approaches are mutually exclusive.","type":"text"}]}]}],"version":1}