Chapter 4 Getting Started

Sun™ Java System Federation Manager is installed with a number of samples that can be used to familiarize yourself with the product. This chapter contains general information on the samples. The README file included in each sample directory contains the procedures that describe how to run the sample.

This chapter contains the following topics:

• SAML Samples

• Liberty-based Samples

SAML Samples

The SAML samples are located in the /FederationManager-base/SUNWam/fm/samples/saml directory. They include:

• SAML Client Sample

• SAML Query Sample

• Single Sign On Using SAML

• SAML XMLSIG Sample

All samples are compiled and deployed during installation.

For general information about the SAML implementation (including definitions of the profile types and assertions), see Chapter 9, SAML Administration, in Sun Java System Access Manager 7 2005Q4 Federation and SAML Administration Guide.

SAML Client Sample

This sample illustrates how the SAML client API in the com.sun.identity.saml package can be used. Federation Manager is deployed on two machines. The AssertionArtifactSample servlet on machine #1 generates an assertion artifact which is received by the SAMLClientSample servlet on machine #2. This sample is located in the /FederationManager-base/SUNWam/fm/samples/saml/client directory.

SAML Query Sample

This sample illustrates how to use Federation Manager to form a query, to write an AttributeMapper, and to send and process a SOAP message using the SAML API. This sample is located in the /FederationManager-base/SUNWam/fm/samples/saml/query directory.

Single Sign On Using SAML

This sample illustrates how to achieve single sign on for a user between two instances of Federation Manager using either the Web Browser Artifact Profile or the Web Browser POST Profile. This sample is located in the /FederationManager-base/SUNWam/fm/samples/saml/sso directory.

SAML XMLSIG Sample

This sample illustrates how to use the com.sun.identity.saml.xmlsig API in a SAML interaction. This sample is located in the /FederationManager-base/SUNWam/fm/samples/saml/xmlsig directory.

Liberty-based Samples

The Liberty-based samples are located in the /FederationManager-base/SUNWam/fm/samples/liberty directory. They include:

• Federation SPI Sample

• Liberty Protocol Sample

• Web Service Sample

Federation SPI Sample

This sample illustrates how to Liberty-enable a password—protected application without changing the application code. It uses the federation SPI to achieve password playback within the sample application, and also makes use of a service provider and an identity provider. This sample is located in the /FederationManager-base/SUNWam/fm/samples/liberty/spi directory.

Liberty Protocol Sample

This sample highlights different Liberty—based protocol (such as Account Federation, SSO, Single Logout and Federation Termination) using the communication channel between a service provider and an identity provider. This sample is located in the /FederationManager-base/SUNWam/fm/samples/liberty/sso directory.

Web Service Sample

This sample describes the development of a simple web service using Federation Manager. This web service sends stock data based on a defined user type. The sample extracts authentication information from an authenticated SAML Assertion (SAML Bearer Token). It is located in the /FederationManager-base/SUNWam/fm/samples/liberty/webservices/stockticker directory.