Contents


About This Guide

What You Are Expected to Know
Documentation Conventions Used in This Manual

Typographic Conventions
Terminology

Related Information

Chapter 1 Read This First

Uses of Policy Agent for Application Server

Examples

Supported Servers

Chapter 2 Policy Agent for WebLogic 6.1 SP2

Overview
Guidelines
Installing the Agent

Pre-installation Tasks
Launching the Installation Program on Solaris 8
Launching the Installation Program on Windows 2000
Launching the Installation Program on HP-UX 11
Installing the Agent Using GUI

WebLogic Server Configuration

Installing the Agent Realm
Troubleshooting the Installation

Application Configuration

Installing the Agent Filter Component in an Application
Creating Role-to-Principal Mappings
Application Specific Agent Configuration
Special Case: Default Web Application
Global Agent Configuration
Not-Enforced List Usage Considerations

Agent Configuration

Common Configuration
Audit Configuration
Realm Configuration
Global Filter Configuration
Application Filter Configuration
Debug Engine Configuration

Uninstalling the Agent

Uninstalling the Agent Using GUI
Troubleshooting Uninstallation Problems

Chapter 3 Policy Agent for IBM WebSphere 4.0.3 AE

Overview
Guidelines
Limitations
Software Requirements
Installing the Agent

Pre-Installation Tasks
Launching the Installation Program
Installing the Agent Using GUI
Installing the Agent Using Command-Line

WebSphere Application Server Configuration
Application Configuration

Creating Role-to-Principal Mappings
Application Specific Agent Configuration
Providing Application-Specific Not-Enforced List
Special Case: Default Web Application
Global Agent Configuration
Not-Enforced List Usage Considerations

Agent Configuration

Common Configuration
Audit Configuration
Realm Configuration
Global Interceptor Configuration
Application Interceptor Configuration
Debug Engine Configuration

SSL Configuration
Uninstalling the Agent

Launching the Uninstallation Program
Uninstalling the Agent Using GUI
Uninstalling the Agent Using Command Line
Removing Realm Administrator From AdminRole

Troubleshooting Information

Installation Problems
Uninstallation Problems

Known Problems

Chapter 4 Policy Agent for Sun ONE Application Server 7.0

Overview
Limitations
Installing the Agent

Pre-installation Tasks
Installing the Agent Using GUI
Installing the Agent Using Command-Line
Silent Installation

Application Configuration

Installing the Agent Filter Component in an Application
Creating Role-to-Principal Mapping
Application-Specific Agent Configuration
Special Case: Default Web Application

Agent Configuration

Common Configuration
Audit Configuration
Global Filter Configuration
Application Filter Configuration
Debug Engine Configuration

Uninstalling the Agent

Uninstalling the Agent Using GUI
Uninstalling the Agent Using Command-Line

Chapter 5 Policy Agent for PeopleSoft 8.3

PeopleSoft Agent Architecture

Deployment Options

Operating System and Software Required
Installing the Agent

Pre-Installation Tasks
Overview of Installation and Configuration Tasks
Setting Up PeopleSoft for SSO
Launching the Agent Installation Program
Installing from the Command Line
Installing Sun ONE Web Server 4.1 for Proxy Solution

Configuring Sun ONE Identity Server
Verifying a Successful Installation
Agent Configuration

Agent Core Configuration
Audit Configuration
Debug Engine Configuration

Troubleshooting Information
Uninstalling the Agent

Launching the Uninstallation Program on Solaris 8
Launching the Uninstallation Program on HP-UX 11
Uninstalling the Agent Using GUI
Uninstalling from the Command Line

Appendix A Configuration Tasks Performed by Installer

WebLogic 6.1 SP2

WebLogic Server Startup Script Modifications
Adding Parameters to Java Virtual Machine
Installation of JCE 1.2.1 and JSSE 1.0.2 Extensions

WebSphere 4.0.3 AE

Modifications to WebSphere Command-Line Setup Script
Modifications to WebSphere Server Startup Script
Modifications to Admin Server Configuration File
Modifications to trustedserver.properties
Configurations Through Administrative Console

Sun ONE Application Server 7.0

Application Server Config Files

PeopleSoft 8.3

When PeopleSoft Application Server is installed locally
When WebLogic 5.1 Server installed locally
Configuration Tasks when Deploying Agent on PeopleSoft Provided WebLogic 5.1 Server
JCE/JSSE

Appendix B Using the Agent Debug Engine

Appendix C Sample Scenarios for Role-to-Principal Mapping

WebLogic 6.1 SP2 Application Server

Declarative Security
Programmatic Security

WebSphere 4.0.3 AE Application Server

Web Authorization
EJB Authorization

Sun ONE Application Server 7.0

Declarative Security
Programmatic Security