Installing the Sample Service Provider Software

The Liberty SP software should only be installed on compatible hardware (see Liberty Identity Provider Requirements ). If you are installing your SP on a different machine from your Liberty IDP, you must have JVM 1.4 or later and a servlet engine (for example, Tomcat 4.1.18) already installed on the machine where you are installing the SP.

Before you install and configure an SP, you should verify that your installation of the Liberty IDP was successful. (For Liberty IDP installation information, see Installing the Liberty Identity Provider .) You can make this verification by viewing your IDP's URL, which is located at your domain name/nidp. Viewing this URL will take you to the login page, which should show you a "Welcome to" home page. If you do not see this page, your install did not complete, and you will need to completely remove the Liberty IDP software from your machine and then re-install.

Like the IDP installation, the SP installation is divided into four sections: an installation introduction, a pre-installation summary, the Liberty SP installation, and a completion record. At any given point of the installation process, you can follow the progress of your installation by referring to the left-hand side of the install dialog. (See Figure 23).

To install the sample Liberty SP:

  1. At the Web download site, click the Web download link to automatically download the Liberty SP executable.

  2. Run the executable.

    InstallAnywhere will guide you through the installation process.

  3. After you have read the introductory screen, click Next.

    Figure 23
    Liberty Service Provider Introduction

  4. If you accept the License Agreement, select the accept button, then click Next.

    Figure 24
    License Agreement

  5. The Liberty SP is provided as example code. You must accept this stipulation in order to proceed with the installation. If you accept the stipulation, select the accept button, then click Next.

    Figure 25
    Example Code Stipulation

  6. The Liberty SP installation creates a fictitious SP called World Financial. Read the information about the SP, note the URL, and then click Next.

    Figure 26
    World Financial Information

  7. In order for single sign-on to work seamlessly between the IDP and the SP when more than one IDP exists, you must enable Introductions on your IDP. Enter the Common Domain that Introductions will use.

    NOTE:  You should make sure the Common Domain you enter at this page matches the Common Domain you entered for your IDP.

    Figure 27
    Common Domain

  8. Click Next.

  9. Enter a user name and password for your test user, then click Next.

    Figure 28
    Service Provider Test User

  10. Set up your keystore information by entering a Keystore File Name, Keypair Alias, Keypair Password, and Keystore Password. (This information does not have to match the keystore information you entered for the IDP.)

    For more information about digital signing and keys, see the Key and Certificate Management Tool documentation.

    Figure 29
    Signing Certificate Information: Keystore

  11. Click Next.

  12. Review the Pre-Installation Summary. If you need to make changes to your configuration, click Previous to go back to previous screens. If you accept the configuration, click Install.

  13. Restart Tomcat and Apache.

When the installation has completed, configure your SP by following the instructions in Configuring Your Service Provider .