{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"d6782f89-3192-4435-9a51-d6fc738ad3f6"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"d5d1109d-917e-4da6-b1f4-ad88a4a8ed51"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Identified by ","type":"text"},{"text":"type=\"XML\"","type":"text","marks":[{"type":"code"}]},{"text":", this ","type":"text"},{"text":"MetadataProvider","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2060616124"}}]},{"text":" ","type":"text"},{"text":"batch loads","type":"text","marks":[{"type":"em"}]},{"text":" metadata from a single source. Remote metadata is almost always intended to be signed and should expire regularly in accordance with the ","type":"text"},{"text":"TrustManagement","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/CONCEPT/pages/928645130"}}]},{"text":" model of the software, and use of the ","type":"text"},{"text":"SignatureMetadataFilter","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063696211"}}]},{"text":" and ","type":"text"},{"text":"RequireValidUntilMetadataFilter","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063696214"}}]},{"text":" is generally assumed.","type":"text"}]},{"type":"paragraph","content":[{"text":"This metadata plugin type is implemented as a ","type":"text"},{"text":"reloadable XML resource","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063695928"}}]},{"text":", which means that the metadata can be supplied inline, in a local file, or a remote file, and can be monitored for changes and reloaded on the fly. The root of the XML in all cases ","type":"text"},{"text":"MUST","type":"text","marks":[{"type":"strong"}]},{"text":" be either an ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" or, more commonly with batches, ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" element.","type":"text"}]},{"type":"paragraph","content":[{"text":"This is historically the most common way to configure metadata, but for large metadata sources the on-demand types (","type":"text"},{"text":"MDQ","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"Dynamic","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"LocalDynamic","type":"text","marks":[{"type":"code"}]},{"text":") will be increasingly used instead.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference","type":"text"}]},{"type":"expand","attrs":{"title":"Common XML Attributes"},"content":[{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"type=\"XML\"","type":"text","marks":[{"type":"code"}]},{"text":" attribute ","type":"text"},{"text":"must","type":"text","marks":[{"type":"em"}]},{"text":" be present.","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"MetadataProviderCommonAttributes"}},"macroMetadata":{"macroId":{"value":"3d03cb72-5729-4be3-9fe2-96bcaefd3f3e"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"5ae964d8-647e-4aea-821c-84349aa3288e"}}]},{"type":"expand","attrs":{"title":"Common Reloadable Configuration Resource XML Attributes"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"ReloadableConfigurationAttributes"}},"macroMetadata":{"macroId":{"value":"9226bd38-7a81-4560-bfdc-11645d50137c"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"a54365a7-b965-408e-be96-a6372810deb6"}}]},{"type":"expand","attrs":{"title":"Specific XML Attributes"},"content":[{"type":"paragraph","content":[{"text":"In addition, the following attributes specific to this plugin type are supported:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"020059dd-481c-43be-af40-3624b1b2b0eb"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[668.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"discoveryFeed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"true","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[668.0]},"content":[{"type":"paragraph","content":[{"text":"When true, a JSON feed of IdP information will be produced and cached in memory for use by the ","type":"text"},{"text":"DiscoveryFeed","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]},{"text":" handler. Can be disabled to save processing and memory.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"minRefreshDelay","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"time in seconds","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"600","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[668.0]},"content":[{"type":"paragraph","content":[{"text":"Determines the minimum refresh interval when polling a remote resource for changes","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"refreshDelayFactor","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"decimal between 0 and 1, non-inclusive","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"0.75","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[668.0]},"content":[{"type":"paragraph","content":[{"text":"Factor applied to the metadata's own validity or caching period to determine the reload interval to use. Once applied, the result is bounded by the minRefreshDelay and maxRefreshDelay settings to determine the time of the next attempt. If reload attempts fail, the interval will increase in linear fashion to limit failed attempts.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"dropDOM","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"true","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[668.0]},"content":[{"type":"paragraph","content":[{"text":"When true, the underlying XML DOM structure is dropped after processing a new metadata instance. Set to false to maintain the DOM in memory if there are supplemental options being used that operate more efficiently with the DOM maintained.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[155.0]},"content":[{"type":"paragraph","content":[{"text":"tagsInFeed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[131.0]},"content":[{"type":"paragraph","content":[{"text":"boolean","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[75.0]},"content":[{"type":"paragraph","content":[{"text":"false","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[668.0]},"content":[{"type":"paragraph","content":[{"text":"When true, adds extension attribute values (simple-valued only) to the ","type":"text"},{"text":"discovery feed","type":"text","marks":[{"type":"link","attrs":{"href":"#"}}]}]}]}]}]}]},{"type":"expand","attrs":{"title":"Common XML Child Elements"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"MetadataProviderChildElements"}},"macroMetadata":{"macroId":{"value":"ccb98f48-9910-4ecf-b2a2-ed0ffb5214ac"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"e81cde3b-9571-408e-8837-99c203a0fed2"}}]},{"type":"expand","attrs":{"title":"Common Reloadable Configuration Resource XML Child Elements"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"ReloadableConfigurationElements"}},"macroMetadata":{"macroId":{"value":"3a66a17958fbaf514d7c77a35dc646f4"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"d2c3ad60-3f64-46d2-b774-1efbac91fc49"}}]},{"type":"expand","attrs":{"title":"Specific XML Child Elements"},"content":[{"type":"paragraph","content":[{"text":"In addition, the following child element specific to this plugin type is supported:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","localId":"91ba204a-3961-4856-ae84-b3b263b2b901"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"Cardinality","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[783.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[150.0]},"content":[{"type":"paragraph","content":[{"text":"<","type":"text"},{"text":"DiscoveryFilter","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2063696181"}}]},{"text":">","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[96.0]},"content":[{"type":"paragraph","content":[{"text":"0 or more","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[783.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies an inclusion or exclusion filter to apply to the entities in the metadata for purposes of the JSON ","type":"text"},{"text":"discovery feed","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/SP3/pages/2065334877"}}]},{"text":". Any entities excluded are still included in all other uses of the metadata.","type":"text"}]}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Locally-Stored Metadata File","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Remote Metadata Source","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n\t\n\t\n","type":"text"}]},{"type":"paragraph"}],"version":1}

Browser not supported