Preface

The Sun Java System Federation Manager 7.0 User's Guide provides information and procedures concerning this initial release of Sun™ Java System Federation Manager. The User's Guide includes installation instructions, administrative procedures, developer material, technical notes, and other relevant information.

Who Should Use This Book

The Sun Java System Federation Manager 7.0 User's Guide is intended for use by IT professionals, network administrators and software developers who implement a standards based service provider platform using Sun Java System server software. It is recommended that administrators understand the following technologies:

Lightweight Directory Access Protocol (LDAP)
Java™ 2 Platform, Enterprise Edition (J2EE™ platform) web containers and corresponding deployment tools
JavaServer Pages™
HyperText Transfer Protocol (HTTP)
HyperText Markup Language (HTML)
eXtensible Markup Language (XML)
Web Services Description Language (WSDL)
Security Assertion Markup Language (SAML)
SOAP
Liberty Alliance Project Specifications for Federation and Web Services

In addition, administrators should have a clear knowledge of the legal aspects of identity federation (including privacy laws) and corporate policies.

Before You Read This Book

Federation Manager can be installed to work with Sun Java System Access Manager. Access Manager is a component of the Sun Java Enterprise System suite of products.

Because Federation Manager can be configured to work with Access Manager, you should be familiar with the Sun Java System Access Manager documentation. Specifically, the Sun Java System Access Manager 7 2005Q4 Federation and SAML Administration Guide might be helpful if you have not yet worked with a Liberty-based deployment.
Because Sun Java System Directory Server can be used as a data store in a Federation Manager deployment, you should be familiar with the Sun Java System Directory Server 5 2005Q4 documentation set.
Because Federation Manager contains features based on the Liberty Alliance Project specifications, you should be familiar with the Liberty Alliance Project specifications.
Because Federation Manager can work in tandem with many of the products developed as part of the Sun Java Enterprise System suite, you should be familiar with the Sun Java Enterprise System documentation.

How This Book Is Organized

Sun Java System Federation Manager 7.0 User's Guide contains instructional and conceptual material regarding the use of Sun Java System Federation Manager. The book is organized into the chapters described in the following table.

Table P–1 Chapters in the Federation Manager User's Guide


Chapter	Description
1 Introducing Federation Manager	An overview of Federation Manager.
2 Installing and Deploying Federation Manager	Contains the installation procedure for Federation Manager and related deployment information.
3 Customizing Federation Manager	Contains information on how to customize your Federation Manager installation. It includes procedures on how to change the default data store, enable Secure Sockets Layer (SSL), and work with Sun Java System Policy Agents.
4 Getting Started	Contains the procedures for changing default data stores and introductory material on the samples included with Federation Manager.
5 System Administration	Contains information on how to configure your Federation Manager server and the non-Liberty Authentication Service.
6 Authentication	Contains information on how to configure your Federation Manager server for authentication.
7 Federation, Authentication Domains and Entities	Contains administrative information about federations, entities and providers.
8 SAML Administration	Contains information about the SAML component.
9 Web Services	Provides information regarding the Liberty-based web services.

Related Books

The following sections describe the documentation for Federation Manager and Sun Java System products:

Federation Manager Core Documentation

The Federation Manager documentation set contains the following titles:

The Sun Java System Federation Manager 7 Release Notes will be available online after the product is released. It gathers an assortment of last-minute information, including a description of what is new in this current release, known problems and limitations, installation notes, and how to report issues with the software or the documentation.
The Sun Java System Federation Manager 7 User's Guide (this guide) is the core manual for Federation Manager. It includes instructions on how to install Federation Manager and information on how to use the console and manage the meta data. It also includes some basic deployment information and describes the samples included with Federation Manager.
The Sun Java System Federation Manager 7 Java API Reference are generated from Java code using the JavaDoc tool. The pages provide information on the implementation of the Java packages in Federation Manager.

Note –

The Sun Java System Access Manager 7 2005Q4 Federation and SAML Administration Guide provides information about the features in Access Manager that are based on the Liberty Alliance Project and SAML specifications. Because Access Manager is also based on these specifications and might be used with Federation Manager, this guide provides useful information for a Federation Manager deployment.

Updates to the Release Notes and links to modifications of the core documentation can be found on the Federation Manager documentation page. Updated documents will be marked with a revision date.

Sun Java System Product Documentation

Useful information can be found in the documentation for the following Sun Java System products:

Contacting Sun Technical Support

If you have technical questions about this product that are not answered in the product documentation, contact Sun Support Services.

Related Third-Party Web Site References

Third-party URLs are referenced in this documentation set and provide additional, related information. Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

Sun Welcomes Your Feedback

Sun Microsystems is interested in improving its documentation and welcomes your comments and suggestions. To share your thoughts, go to http://docs.sun.com and click the Send Comments link at the top of the page. In the online form provided, include the document title and part number. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the title of this book is Sun Java System Federation Manager 7 User's Guide, and the part number is 819–2357.

Accessing Sun Documentation Online

The docs.sun.com^SM web site enables you to access Sun technical documentation online. You can browse the docs.sun.com archive or search for a specific book title or subject. The URL is http://docs.sun.com.

Ordering Sun Documentation

Sun Microsystems offers select product documentation in print. For a list of documents and how to order them, see “Buy printed documentation” at http://docs.sun.com.

Typographic Conventions

The following table describes the typographic changes that are used in this book.

Table P–2 Typographic Conventions


Typeface or Symbol	Meaning	Example
`AaBbCc123`	The names of commands, files, and directories, and onscreen computer output	Edit your `.login` file. Use `ls -a` to list all files. `machine_name% you have mail.`
`AaBbCc123`	What you type, contrasted with onscreen computer output	`machine_name%` `su` `Password:`
`AaBbCc123`	Command-line placeholder: replace with a real name or value	The command to remove a file is `rm` `filename`.
AaBbCc123	Book titles, new terms, and terms to be emphasized	Read Chapter 6 in the User's Guide. Perform a patch analysis. Do not save the file. [Note that some emphasized items appear bold online.]

Shell Prompts in Command Examples

The following table shows the default system prompt and superuser prompt for the C shell, Bourne shell, and Korn shell.

Table P–3 Shell Prompts


Shell	Prompt
C shell prompt	`machine_name%`
C shell superuser prompt	`machine_name#`
Bourne shell and Korn shell prompt	`$`
Bourne shell and Korn shell superuser prompt	`#`

Additional Sun Resources

For product downloads, professional services, patches, support, and additional developer information, go to the following locations:

If you have technical questions about any Sun products, contact Sun Support and Services.