The Shibboleth V2 IdP and SP software have reached End of Life and are no longer supported. This documentation is available for historical purposes only. See the IDP v4 and SP v3 wiki spaces for current documentation on the supported versions.

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

Installing the Discovery Service

This section describes the Centralized Discovery Service which is primarily aimed at providing a backstop service for Federation and other metadata aggregating and distributing agences. Outside this scope it is very limited. Service Providers are recommended to install the Embedded Discovery Service.

Before You Begin

The first question you should ask is whether you need to install the DiscoveryService. If you're working in a non-Java environment, you may find it easier to build a selection page in a more native fashion.  The SP also supports the Embedded Discovery Service which is usually a better choice for SPs which need to implement discovery.

If you do decide to install it, you'll primarily need to collect the metadata sources that will contain the IdPs that users will select from. If you're planning to use SAML 2.0 or other protocols not supported by the old WAYF model, you may also need to provide metadata about your SP(s) to enable the DS to safely interact with the SP.

Which protocol?

The Discovery Service will automatically select between "WAYF-Mode" (in which it intercepts and handles a legacy Shibboleth AuthnRequest message) and the full Discovery Service Protocol.

No explicit configuration to select the right protocol is needed.

Performing the Install

The Shibboleth Discovery Service, version 1.2.1, is a standard Java web application.

  1. Download and decompress the Discovery Service package from the Shibboleth Download site
  2. Change into the newly created distribution directory.
  3. Endorse Xerces and Xalan by copying the contents of the endorsed directory to the appropriate place on the web Server (for tomcat this is $TOMCAT_ROOT\common\endorsed).
  4. Run either install.sh (on Unix systems) or install.bat (on Windows systems) as a suitably authorized user user. This user must have the ability to create the Discovery Service home directory identified in the previous step.
  5. Configure the Discovery Service to point to the metadata sources you identified above as described here.
  6. Deploy the Discovery Service WAR file, located in the Discovery Service's Home directory.
  7. Further Configuration is described here.
  • No labels