...
All plugin manipulation (except trust store maintenance) is done via the plugin
command. Operations fall into 2 broad categories.
Plugin Discovery and automated installation.
Information about plugins is always kept separate from the plugin itself. This same information can be used to discover which plugins are available at a given URL. The -L
will list them. This defaults to using the URL which is shared by all plugins developed by the Shibboleth Team (and documented here). The --updateURL
allows other locations to be used.
Given the ID of a plugin (from the -L
qualifier) it can be installed with the -I
qualifier.
Manual Install, Update, and Uninstall
Installation (specified by the -
i i
or --
input qualifierinput
qualifier, immediately followed by the file name or URL) either installs a plugin or updates/downgrades it to a provided version.
...
Short | Long | Parameter | Description |
---|---|---|---|
-i | --install | File Or URL | Install the provided qualifier |
-u | --update | List installed plugins | |
-r | --remove | PluginId | Remove the installed plugin |
-l | --list | Enumerate all installed plugins | |
-fl | --full-list | Give full version details for all installed plugins | |
-cl | --contents-list | PluginId | List all files installed by the specified plugin |
-L 4.2 | --list-available | List available plugins (i.e discover plugins which can be downloaded and installed) | |
-I 4.2 | --install-ID | PluginId | Install plugin from its ID. The plugin should be available at the default endpoint (or that specified by --updateURL) |
--noCheck | Do not check for compatibility with the current IdP Version | ||
--updateURL | Specify the update URL (for -L, -I or to override the plugin provided value) | ||
--license | PluginId | Output the license information for the specified plugin |
...
Code Block | ||
---|---|---|
| ||
/idp/bin$ ./plugin.sh -fl Plugin: net.shibboleth.idp.plugin.rhino Current Version: 0.1.4 Versions 0.1.3: Min=4.1.0 Max=5.0.0 Support level: Withdrawn |
Discover and automated install
Code Block | ||
---|---|---|
| ||
rdw@DELL10:~/idp/bin$ ./plugin.sh -L
Plugin net.shibboleth.idp.plugin.rhino: version 1.1.0 available for install
Plugin net.shibboleth.idp.plugin.authn.duo.sdk: version 1.1.1 available for install
Plugin net.shibboleth.idp.plugin.authn.totp: version 1.0.0 available for install
Plugin net.shibboleth.idp.plugin.oidc.op: version 3.0.1 available for install
Plugin net.shibboleth.idp.plugin.metadatagen: version 0.1.1 available for install
Plugin net.shibboleth.idp.plugin.authn.duo.nimbus: version 1.1.1 available for install
Plugin net.shibboleth.idp.plugin.nashorn: Installed version 1.1.0: No update available
Plugin net.shibboleth.oidc.common: version 1.1.0 available for install
rdw@DELL10:~/idp/bin$ ./plugin.sh -I net.shibboleth.idp.plugin.authn.totp
.....
rdw@DELL10:~/idp/bin$ ./plugin.sh -l
Plugin: net.shibboleth.idp.plugin.nashorn Current Version: 1.1.0
Plugin: net.shibboleth.idp.plugin.authn.totp Current Version: 1.0.0 |