Versions Compared

Key

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

...

SuffixDescription
nameA human-readable but brief name
descA longer, human-readable description
urlA URL for more information or documentation
postenableA message to display to a deployer that enables the module
postdisableA message to display to a deployer that disables the module
n.srcClasspath or HTTP/HTTPS resource location for resource N managed by the module
n.destFilesystem location relative to idp.home for resource N to be placed when enabled
n.replaceA true/false value indicating whether a resource should directly overwrite an existing copy of itself. Default is false.

...

n.optionalA true/false value indicating whether the absence of a resource should influence whether the module is enabled or not. Default is false. This is useful to allow deployers to remove a file without the module thinking it's then disabled.
n.execA true/false value indicating whether a file should be marked executable on POSIX systems. Default is false.

The final 5 properties are a repeating pair (src/dest) for each resource managed by the module, with replace the others being optional. Resources are numbered starting at 1 and increasing atomically up to the last resource managed (no gaps allowed). Sources are generally classpath-based and should be absolute to ensure proper lookup. Destinations are filesystem paths relative to the IdP's install tree.

...

Modules packaged within plugins produced by the Shibboleth Project should implement them based on the PluginIdPModule implementation class, a special case of depending on an implementation class in a separate module. This is strictly to "hide" the class from third parties. This allows the module "url" property to be relative to the proper wiki space (TBD initiallyIDPPLUGINS).