Installation

(TBD: We may explore packaging options in the future that deliver a bundled artifact containing the IdP and the necessary plugins in the future to simplify deployment…)

The Hub is implemented as plugins to the Shibboleth Identity Provider, rather than as a standalone piece of software. Complete documentation on plugin installation, upgrades, and management can be found at PluginInstallation.

A summary of the relevant commands for Hub installation and upgrades is below. The examples assume you are within the IdP’s home directory and are geared towards Linux. The commands are roughly the same on Windows save for the command extension.

As with all IdP plugins, installation will add various files to the installation which in general become solely yours to control and maintain once installed, and will not be modified by subsequent upgrades. After installation, GettingStarted will lead you through the initial steps in making the Hub operational and HubPlanning will help you understand some of the choices you need to think about and how they impact the configuration changes you’ll need to make.

Example Commands

Core Hub Plugin

Install:

bin/plugin.sh -I net.shibboleth.plugin.shibd

Upgrade:

bin/plugin.sh -u net.shibboleth.plugin.shibd

SAML 2.0 Support

Install:

bin/plugin.sh -I net.shibboleth.plugin.shibd.saml

Upgrade:

bin/plugin.sh -u net.shibboleth.plugin.shibd.saml

OpenID Connect Support

Install:

bin/plugin.sh -I net.shibboleth.plugin.shibd.oidc

Upgrade:

bin/plugin.sh -u net.shibboleth.plugin.shibd.oidc