Technical Note: Sun Java System SAML v2 Plug-in for Federation Services on Linux

Sun Java System SAML v2 Plug-in for Federation Services on Linux

The Sun Java™ System SAML v2 Plug-in for Federation Services is an auxiliary program that works with either Sun Java System Access Manager 7 2005Q4, Sun Java System Access Manager 7.1, or Sun Java System Federation Manager 7.0 2005Q4. It was released in February, 2006 for the SolarisTM operating system. The May, 2006 update expanded the plug-in to include the Linux application environment. This technical note describes the differences in the SAML v2 Plug-in for Federation Services when installed and used on an instance of Sun Java System Access Manager or Sun Java System Federation Manager deployed in a Linux application environment. It contains the following sections:

Overview of the SAML v2 Plug-in for Federation Services

The Sun Java System SAML v2 Plug-in for Federation Services incorporates a subset of features based on the Security Assertion Markup Language (SAML) version 2 specifications and, when installed on Sun Java System Access Manager or Sun Java System Federation Manager, allows support for interactions based on those specifications. The documentation originally released with the plug-in includes the following titles:

This technical note describes the differences when the Sun Java System SAML v2 Plug-in for Federation Services is installed as a program on the Linux application environment as opposed to the Solaris operating system for which the above titles were written.

Installation of the SAML v2 Plug-in for Federation Services on Linux

The SAML v2 Plug-in for Federation Services for Linux installs on Access Manager 7.1, Access Manager 7 2005Q4 or Federation Manager 7.0 2005Q4. This section describes the specific software requirements and install procedures. It contains the following sections:

SAML v2 Plug-in for Federation Services for Linux on Federation Manager

The Linux update for the SAML v2 Plug-in for Federation Services allows the plug-in to be deployed on an instance of Federation Manager. The plug-in runs on Red HatTM Enterprise Linux versions 2.1, 3.0, and 4.0. See Chapter 2, Installing the SAML v2 Plug-in for Federation Services, in Sun Java System SAML v2 Plug-in for Federation Services User’s Guide for the procedure. More information on Federation Manager can be found in the Sun Java System Federation Manager 7 2005Q4 documentation.

SAML v2 Plug-in for Federation Services for Linux on Access Manager

See the appropriate section for your installation:

Installing the SAML v2 Plug-in for Federation Services for Linux on Access Manager 7 2005Q4

The SAML v2 Plug-in for Federation Services for an instance of Access Manager 7 2005Q4 deployed in the Linux application environment has been available since the initial release. See Chapter 2, Installing the SAML v2 Plug-in for Federation Services, in Sun Java System SAML v2 Plug-in for Federation Services User’s Guide for the procedure. More information on Access Manager 7 2005Q4 can be found in the Sun Java System Access Manager 7 2005Q4 documentation.

Installing the SAML v2 Plug-in for Federation Services for Linux on Access Manager 7.1

To install the SAML v2 Plug-in for Federation Services for Linux on Access Manager 7.1, see SAML v2 Plug-in for Federation Services for Sun Java System Access Manager 7.1 in Sun Java System SAML v2 Plug-in for Federation Services Release Notes. More information on Access Manager 7.1 can be found in the Sun Java System Access Manager 7.1 documentation.

Patching the SAML v2 Plug-in for Federation Services for Linux

To install the plug-in and any related patches do the following:

  1. Install Access Manager or Federation Manager.

  2. Install the original SAML v2 Plug-in for Federation Services bits available at http://www.sun.com/download/products.xml?id=43e00414.

  3. Patch your working installation of the SAML v2 Plug-in for Federation Services with the appropriate patch.


    Note –

    For example, patch 122985-01 should be available at http://sunsolve.sun.com/. For more information, see the patch release note included with the bits.


Where to Get the SAML v2 Plug-in for Federation Services for Linux

The SAML v2 Plug-in for Federation Services can be downloaded from http://www.sun.com/download/products.xml?id=43e00414. Instructions for unzipping and installing the tarball can be found in Chapter 2, Installing the SAML v2 Plug-in for Federation Services, in Sun Java System SAML v2 Plug-in for Federation Services User’s Guide.

How to Use the SAML v2 Plug-in for Federation Services on Linux

The instructions and procedures in the documentation listed in Overview of the SAML v2 Plug-in for Federation Services work the same whether the plug-in is deployed on the Solaris operating system or the Linux application environment. When following the documentation, be sure to change the defined Solaris paths to paths that reflect the Linux installation. The following table lists the directory and path differences for the SAML v2 Plug-in for Federation Services.

Table 1 SAML v2 Plug-in for Federation Services Directory Paths

SAML v2 Plug-in for Federation Services 

Solaris 

Linux 

Default Base Directory 

/opt

/opt/sun

Product Directory 

/SUNWam/saml2

/identity/saml2