Skip Headers
Oracle® Fusion Middleware Federated Portals Guide for Oracle WebLogic Portal
10
g
Release 3 (10.3.4)
Part Number E14235-05
Home
Contact Us
Next
View PDF
Contents
List of Examples
List of Figures
List of Tables
Title and Copyright Information
Preface
Audience
Documentation Accessibility
Related Documents
Conventions
Part I Architecture
1
Introduction
1.1
Support for WSRP 2.0
1.2
Federation in the Portal Life Cycle
1.2.1
Architecture
1.2.2
Development
1.2.3
Staging
1.2.4
Production
1.3
Getting Started
1.3.1
Prerequisites
1.3.2
Related Guides
1.3.3
Using this Guide
2
What are Federated Portals?
2.1
Overview
2.2
Basic Terminology
2.3
Traditional Portals: Before Federation
2.4
Federated Portals: A New Paradigm
2.5
Advantages of Federation
2.5.1
Overview
2.5.2
Reducing the Cost of Portal Deployment
2.5.3
Plug and Play SOA
2.5.4
Increasing the Flexibility of Release Schedules
2.5.5
Reducing the Cost of Testing Your Portal
2.5.6
Decreasing Dependencies Among Software Components
2.5.7
Promoting Reuse of Portal Components
2.5.8
Interoperability
3
Federated Portal Architecture
3.1
Key Actors in a Federated Portal
3.2
Federating Books and Pages
3.3
What is WSRP?
3.4
Understanding Producers and Consumers
3.4.1
Overview
3.4.2
WebLogic Portal Producers
3.4.2.1
Simple Producers
3.4.2.2
Complex Producers
3.4.2.3
Summary of Complex and Simple Producers
3.4.3
WebLogic Portal Consumers
3.4.4
Cookie Handling
3.5
Life Cycle of a Remote Portlet
3.5.1
Rendering a Remote Portlet
3.5.1.1
Initial Steps on the Consumer
3.5.1.2
Initial Steps on the Producer
3.5.1.3
Final Steps on the Consumer
3.5.2
Interacting With a Remote Portlet
3.5.2.1
Initial Steps on the Consumer
3.5.2.2
Initial Steps on the Producer
3.5.2.3
Final Consumer Steps
3.5.3
Rendering Versus Interaction
3.5.4
Interportlet Communication with Events
3.5.5
Retrieving Render Dependencies
3.6
Summary of Federated Portal Architecture
3.7
For More Technical Details
Part II Development
4
Creating Remote Portlets, Pages, and Books
4.1
Introduction
4.2
What Types of Portlets Can Be Remote?
4.3
Creating a Remote Portlet
4.3.1
Overview
4.3.2
Setting Up the Example
4.3.3
Locating and Consuming a Portlet
4.3.4
Viewing the Portlet
4.3.5
Summary
4.4
Creating Remote Pages and Books
4.4.1
Basic Procedure
5
Configuring Remote Portlets
5.1
Applying a Look and Feel to a Remote Portlet
5.2
Modifying Modes and States in a Remote Portlet
5.2.1
What are Modes and States?
5.2.2
Modes and States in Remote Portlets
5.2.3
Changing Modes and States in Remote Portlets
5.3
Handling Errors in Remote Portlets
5.3.1
Configuring an Error Page in Oracle Enterprise Pack for Eclipse
5.3.2
Configuring an Error Page in the .portlet File
5.4
Setting Preferences on a Remote Portlet
5.4.1
What is a Portlet Preference?
5.4.2
Portlet Preferences and Remote Portlets
5.4.2.1
Viewing and Modifying Preferences
5.4.2.2
Working with Preferences Programatically
5.4.2.3
Additional Usage Notes and Restrictions
5.4.3
Managing Portlet Instances through Registration
5.5
Using Backing Files with Remote Portlets
5.6
Setting a Timeout Value on a Remote Portlet
5.6.1
Overview
5.6.2
Setting Default Timeout Values
5.6.3
Setting Timeouts for Individual Remote Portlets
5.7
Modifying WSRP Markup and Messages
5.8
Remote Portlet Properties
5.8.1
Proxy Portlet Properties
5.8.2
Other Portlet Properties
6
Offering Books, Pages, and Portlets to Consumers
6.1
Introduction
6.2
Offering Portlets on a Producer
6.3
Offering Books and Pages on a Producer
6.3.1
Setting Up the Example
6.3.2
Creating a Remoteable Page (or Book)
6.3.3
Summary
6.4
Rules for Creating Remoteable Books and Pages
7
Interportlet Communication with Remote Portlets
7.1
Introduction
7.2
Firing and Handling a Minimize Event
7.2.1
Setting Up Your Environment
7.2.2
Creating the Portlets on the Producer
7.2.2.1
Create the JSP Files and Portlets
7.2.2.2
Create the Backing File
7.2.2.3
Attach the Backing File
7.2.2.4
Add the Event Handler to bPortlet
7.2.2.5
Test the Application
7.2.2.6
Summary
7.2.3
Creating the Consumer Portlets
7.2.3.1
Setting Up the Exercise
7.2.3.2
Creating the Remote Portlet
7.2.3.3
Summary
7.2.4
Testing the Application
7.2.4.1
Build the Portal
7.2.4.2
Test the Portal
7.3
Inside the Remote Portlet File
7.4
Data Transfer with Custom Events
7.4.1
Retrieving the Event on the Producer
7.4.2
Firing the Event in the Consumer
7.5
Event Payloads Over WSRP
7.5.1
Overview
7.5.2
How WLP Packages Event Payloads in XML Format
7.5.3
How WLP Converts an Event Payload to a Java Object
7.6
Using Shared Parameters
7.7
Adding Event Aliases
8
Configuring a WebLogic Server Producer
8.1
Introduction
8.2
Using WSRP in a Basic WebLogic Server Domain
8.2.1
Create a WebLogic Server Domain
8.2.2
Extend the WebLogic Server Domain
8.3
Configuring a Web Project
8.3.1
Create a Web Project
8.4
Testing the Producer Configuration
8.4.1
Create a Server on the Producer
8.4.2
Test for a Producer WSDL
8.4.3
Create a Portlet in the Producer Web Application
8.4.4
Consuming a Producer Portlet
8.4.5
Summary
8.5
Disabling a WSRP Producer
9
The Interceptor Framework
9.1
Introduction
9.2
Use Cases
9.3
Basic Steps
9.4
Designing Interceptors
9.5
Interceptor Interfaces
9.5.1
Context Objects
9.5.2
Interfaces
9.5.3
Interface Methods
9.5.4
Interceptor Method Return Values
9.6
Configuring Interceptors
9.7
Order of Method Execution
9.7.1
Overview
9.7.2
Basic Order Of Execution in a Group
9.7.3
How Return Status Affects Execution Order
9.7.4
Instance Creation and Reuse
9.7.5
Example Chains
9.8
Implementing an Error-Handling Interceptor
9.8.1
Modifying an Error Message
9.8.2
Including an Error JSP Page
9.9
Using Resource Proxy Interceptors
9.9.1
What is the ResourceProxyServlet
9.9.2
The IResourceServletInterceptor
9.9.3
Configuring the Resource Proxy Interceptors
9.9.4
Default Interceptors
9.9.5
More Information
10
Federating User Profiles
10.1
Introduction
10.1.1
What are User Profiles?
10.1.2
User Profiles in Federated Portals
10.1.3
Platform for Privacy Preferences (P3P)
10.2
When to Use this Feature
10.3
Configuring the Producer
10.3.1
Configuring Java Portlets
10.3.1.1
Configuring the Deployment Descriptor (portlet.xml)
10.3.1.2
Retrieving User Information in a Java Portlet
10.3.1.3
Creating Default User Property Sets
10.3.1.4
Mapping User Properties
10.3.2
Configuring Non-Java Portlets
10.3.2.1
Configuring the Deployment Descriptor File
10.3.2.2
Handling User Property Extensions
10.3.2.3
Mapping User Information on the Consumer
10.4
Configuring the Consumer
10.4.1
Using a Mapping File
10.4.2
Using a Mapping Class
10.4.2.1
Writing the Mapping Class
10.4.2.2
Configuring the Mapping Class
10.4.3
Mapping Constants
10.5
P3P Examples
10.5.1
Example: portlet.xml file with P3P Attributes
10.5.2
Example: Retrieving P3P User Information in a Java Portlet
10.5.3
Example: Retrieving User Information in Other Portlets
11
Consumer Entitlement
11.1
Introduction
11.2
Configuring a Producer
11.2.1
Creating an Application Property Set
11.2.2
Editing the Producer Configuration File
11.2.3
Defining Consumer Entitlements
11.3
Registering a Consumer
11.4
Modifying Registration Properties
12
Transferring Custom Data
12.1
What is Custom Data Transfer?
12.2
Custom Data Transfer Interfaces
12.3
Performing Custom Data Transfer
12.3.1
Custom Data Transfer with a Complex Producer
12.3.1.1
Example Overview
12.3.1.2
Setting Up the Example
12.3.1.3
Creating the Producer JSP and Portlet
12.3.1.4
Federating zipTest.portlet to the Consumer
12.3.1.5
Creating a Backing File
12.3.1.6
Testing the Consumer Application
12.3.2
Custom Data Transfer in a Simple Producer
12.4
Transferring XML Data
12.5
Deploying Your Own Interface Implementations
12.5.1
General Guidelines
12.5.2
Implementation Rules
13
WSRP Interoperability with Oracle WebCenter Portal and Oracle Portal
13.1
Consuming WLP Portlets in WebCenter Portal Applications and Oracle Portal Applications
13.1.1
Understanding the Cause of User Authentication Errors
13.1.2
Preventing User Authentication Errors
13.2
Consuming WebCenter Portal Portlets in WebLogic Portal
13.2.1
Avoiding Cookie Collisions
13.2.2
Configuring Portlets That Use ADF Faces Rich Client Components
13.2.2.1
Using iframe_unwrapped
13.2.2.2
Disabling html-amp-entity in WEB-INF/wlp-framework-common-config.xml
13.2.2.3
Using CSS Styling (Optional)
13.2.2.4
Setting a Fixed Height on the Portlet's Contents (Optional)
13.3
Configuring Security
13.4
Interoperation of Navigational Parameters
13.4.1
Configuring the WLP Producer
13.4.2
Configuring the WebCenter Portal Producer
13.4.3
Consuming the WLP Portlets in WebCenter Portal: Framework Application
13.4.4
Consuming a WebCenter Portal Portlet that requires Shared Navigational Parameters With an Initial Value
13.5
Special Considerations
13.5.1
Interportlet Communication Considerations
13.5.2
Consuming Oracle ADF Faces Rich Client Component Portlets
14
Other Topics and Best Practices
14.1
Decouple Rendering from Interaction
14.2
Avoid Interportlet Dependencies
14.3
Avoid Portal Layout Dependencies
14.4
Avoid Coupling by URL
14.5
Avoid Accessing Request Parameters in Rendering Code
14.6
Avoid Moving Producers
14.7
WebLogic Server Producers
14.8
Security for Remote Portlets
14.9
Error Handling
14.9.1
On the Producer
14.9.2
On the Consumer
14.9.3
Interceptors
14.10
Portlet Programming Guidelines and Best Practices
14.11
Designing for Performance
14.11.1
Performance Guidelines for Producers
14.11.1.1
Reorder Authentication Providers
14.11.1.2
Enable Attachment Support
14.11.1.3
Other Techniques
14.11.2
Performance Guidelines for Consumers
14.12
Using Local Proxy Mode
14.12.1
Why Use Local Proxy Mode?
14.12.2
Deployment Configuration
14.12.3
How Local Proxy Mode Works
14.12.4
When to Use and Not Use
14.13
Monitoring and Logging
14.13.1
Using the Monitor Servlet
14.13.2
Creating Custom Logs
14.14
Managing Delivery of Headers and Cookies to the Browser
14.14.1
Best Practice for Setting Cookies and Headers
14.14.2
Configuring Client Attribute Preferences on the Producer
14.14.3
Handling Cookies that Contain the Producer's Domain
14.14.4
URL/Path Rewriting of the Cookie Path
14.14.5
Using Secure Cookies
14.14.6
Managing Security Between Consumer and Producer
14.15
Configuring Session Cookies
14.15.1
Using Different Cookie Names
14.15.2
Using a System Property
14.15.3
Blocking Cookies
14.16
User Sessions on CWEB Applications
14.17
Using Multiple Views with Remote Portlets
14.18
Handling User Identity Changes
14.19
Storing Registration Properties
14.19.1
Why Store Registration Properties?
14.19.2
Using the Administration Console
14.19.3
Using Oracle Enterprise Pack for Eclipse
14.20
Editing the WSRP WSDL Template File
14.21
Configuring a Custom JAX-RPC Handler
14.21.1
Configuring a Handler on the Consumer
14.21.2
Configuring a Handler on the Producer
Part III Staging
15
Establishing WSRP Security with SAML
15.1
SAML Security Between WebLogic Portal Domains
15.1.1
Overview
15.1.2
Setting Up the SAML Configuration Example
15.1.3
Configuring the Consumer
15.1.3.1
Generate a Key
15.1.3.2
Export the Key
15.1.3.3
Modify the Consumer's Security Realm
15.1.4
Configuring the Producer
15.1.4.1
Import the Certificate
15.1.4.2
Configure the Asserting Party Properties
15.1.5
Testing the Configuration
15.2
SAML Security Between WebLogic Portal 8.1x and 9.2 or Later Versions
15.2.1
SAML Security Between 9.2 or Later Version Consumers and 8.1x Producers
15.2.1.1
Configuring the Consumer
15.2.1.2
Change the Consumer's Name
15.2.1.3
Modify the Consumer's Security Realm
15.2.1.4
Configure the WebLogic Portal 8.1x Producer
15.2.1.5
Summary
15.2.2
SAML Security Between 8.1x Consumers and 9.2 or Later Version Producers
15.2.2.1
Configure the 8.1x Consumer
15.2.2.2
Configure the 9.2 or Later Version Producer
15.2.2.3
Testing the Configuration
15.3
Using SAML Security with a Name Mapper
15.3.1
Writing a Name Mapper Class
15.3.1.1
Implementing SAMLCredentialNameMapper on the Consumer
15.3.1.2
Implementing SAMLIdentityAssertionNameMapper on the Producer
15.3.2
Deploying the Mapper Classes
15.3.3
Configuring the Mapper Classes
15.3.3.1
Adding a Mapper Class to the Producer
15.3.3.2
Adding a Mapper Class to the Consumer
15.4
Allowing Virtual Users
16
Configuring User Name Token Security
16.1
Configuring the Consumer
16.2
Configuring the Producer
16.2.1
Set Up Authentication
16.2.2
Modify the WSDL Templates in the Producer Web-App
16.2.3
Summary
17
Configuring WSRP Security Between WLP and a WebCenter Portal: Framework Application
17.1
Introduction
17.2
SAML Security Between a WebCenter Portal: Framework Application Consumer and a WebLogic Portal Producer
17.2.1
Configuring the Consumer
17.2.1.1
Generate a Key Pair
17.2.1.2
Export the Public Key Certificate
17.2.2
Configuring the Producer
17.2.2.1
Import the Public Key Certificate Into The Producer Domain's Trust Key Store
17.2.2.2
Modify the WSDL Templates in the Producer Web-App
17.2.2.3
Modify the Web Services Policy Configuration in the Producer Web-App
17.2.2.4
Add a New Asserting Party to the SAML Identity Asserter
17.2.2.5
Register the WebLogic Portal Producer with the WebCenter Portal: Framework Application Consumer
17.2.2.6
Test the Configuration
17.3
SAML Security Between a WebLogic Portal Consumer and a WebCenter Portal: Framework Application Producer
17.3.1
Register the WebCenter Portal: Framework Application Producer with the WebLogic Portal Consumer
17.3.2
Add an Authentication Mechanism To Your Portal
17.3.3
Configuring the WebLogic Portal Consumer
17.3.3.1
Generate a Key Pair
17.3.3.2
Export the Public Key Certificate
17.3.3.3
Import the Public Key Certificate Into The Consumer Domain's Trust Key Store
17.3.3.4
Add a New Policy to the Consumer Web-App
17.3.3.5
Update the Producer's Security Policy on the Consumer
17.3.3.6
Modify the Consumer's SAMLCredentialMapper
17.3.3.7
Configure the Consumer's PKI Credential Mapping Provider
17.3.3.8
Create a New PKI Credential Mapping to the Consumer
17.3.4
Configuring the WebCenter Portal: Framework Application Producer
17.4
(Optional) Additional Configuration for a WebLogic Portal Consumer
17.4.1
Register the WebLogic Portal producer with the WebLogic Portal Consumer
17.4.2
Update the Producer's Security Policy on the Consumer
17.4.3
Create a New PKI Credential Mapping to the Consumer
18
Adding Remote Resources to the Library
18.1
Introduction
18.2
Adding a Producer
18.3
Adding a Remote Portlet to the Portal Library
18.4
Adding a Remote Page to the Portal Library
18.5
Adding a Remote Book to the Portal Library
19
Configuring Two-Way SSL
19.1
Creating the WSDL and SOAP Interceptors
19.1.1
Creating a Java Project
19.1.2
Creating a Java Package
19.1.3
Creating a Java Class
19.1.4
Creating a JAR File
19.2
Configuring Producers to Use SSL for All Ports
19.3
Configuring WebLogic Portal to Use Interceptors
19.4
Configuring Oracle Enterprise Pack for Eclipse to use Interceptors
19.4.1
Creating a Fragment Project
19.4.2
Importing the JAR file into the Fragment Project
19.4.3
Exporting the Fragment Project
19.4.4
Importing the WLS Demo Certificates into the JVM's cacerts File
19.4.5
Adding System Properties to the eclipse.ini File
Part IV Production
20
Managing Federated Portals
20.1
Modifying the Consumer Security Configuration
20.1.1
Changing the Web Application
20.1.2
Modifying Global Credentials
20.1.3
Modifying Producer Credentials
20.2
Modifying Producer Registration Properties