Oracle Application Server Portal Developer Kit (PDK)
Installing the PDK-URL Services Basic Authentication Sample Portlets

Last Updated: December 15, 2003
Status: Production
Version: PDK Release 9.0.4

Overview

Welcome to PDK-URL Services.  Now that you have successfully installed the PDK-Java Framework and samples, you may want to create URL-based portlets.  PDK-URL Services has extended the PDK-Java to support portlets created in any Web-based language.

Note: URL-based portlets enable you to expose content from external websites as portlets using a manual, XML file-based approach. However, if you are targeting your provider to be registered with OracleAS Portal 9.0.2 or later, the recommended approach to perform the same task is to use the Web Clipping Portlet. To find out about using Web Clipping or how to migrate your URL-based portlet to Web Clipping, go to the OmniPortlet and Web Clipping area of Portal Center.

This article describes how to install and configure the PDK-URL Services basic authentication sample.  There are two portlets in the PDK-URL Services basic authentication sample:

The PDK-URL services basic authentication sample provider is pre-configured within jpdk.ear, with a service ID of urn:urlbasicauth.

Minimum Requirements

  1. OracleAS Portal 3.0.8.9.8 or later.
  2. PDK-Java 9.0.4.

Assumptions

  1. You have already successfully installed the PDK-Java Framework and samples by following the Installing the PDK-Java Framework and Samples article. These samples use the PDK-Java Framework.
  2. You have an account on Oracle Metalink.  To register, go to http://metalink.oracle.com.

Configuring and Testing the Sample Provider

The PDK-URL Services basic authentication sample provider has been pre-configured within the jpdk.ear.  However, you may need to change the provider.xml file to specify the proxy server you use.  Open the provider.xml file for the sample (it should be located in the WEB-INF/providers/urlbasicauth directory) and provide appropriate replacement values for the following tags:

<proxyInfo class="oracle.portal.provider.v2.ProxyInformation">
    <httpProxyHost>www-proxy.us.oracle.com</httpProxyHost>
    <httpProxyPort>80</httpProxyPort>
</proxyInfo>

Next, you can test that the sample is properly configured with OC4J.

  1. Execute the basic authentication sample provider servlet from OC4J.
For example:  http://myserver.mydomain.com:port/jpdk/providers/urlbasicauth
  1. Review the content of the test page displayed. If you did not receive the test page, verify that you can execute standard servlets using OracleAS.

Registering Your Provider

Before registering your basic authentication provider with the portal, you must create an external application for the provider to map to.

  1. Log into OracleAS Portal as
    • SSO Administrator for portal 3.0.9, 9.0.2.X
    • Oracle Internet Directory super user (e.g. orcladmin) for Oracle Aplication Server Portal 10g
  2. On the Portal sub-tab of the Administer tab on the Builder page, click on Administer External Applications within the portlet called SSO Server Administration.
  3. Enter the appropriate information for Oracle Metalink.
    1. Application Name: Oracle Metalink
    2. Login URL: http://metalink.oracle.com/metalink/plsql/sit_main.showSitemap?p_showTitle=0
    3. User Name/ID Field Name: <blank>
    4. Password Field Name: <blank>
    5. Type of Authentication Used: BASIC AUTHENTICATION
  4. Click OK.

You must now register the basic authentication provider with OracleAS Portal.

  1. On the Portlets sub-tab of the Administer tab on the Builder page, click on Register a Provider within the portlet called Remote Providers.
  2. Enter Provider information for the Sample.
    1. Name: URL_Basic_Sample
    2. Display Name: PDK-URL Services Basic Auth Sample
    3. Timeout: 300
    4. Timeout Message: PDK-URL Services Basic Auth Sample Timed Out
    5. Implementation Style: Web
    6. URL: http://myhost.com:8888/jpdk/providers (if you're using Oracle9iAS Portal 3.0.9, append the service id, urlbasicauth, to the URL)
    7. Service Id: urn:urlbasicauth
  3. Select the option "The user's identity needs to be mapped to a different name in the Web provider's application, and/or the Web provider requires an external application login for establishment of a browser session".
  4. Populate the External Application ID field by browsing to the Oracle Metalink external application you registered above.
  5. Choose a Login Frequency of Once Per User Session.
  6. Click Finish.

Adding Your Portlet to a Page

Add the PDK-URL Services basic authentication portlets to a page. The portlets will be listed under the Provider called "PDK-URL Services Basic Auth Sample".  The first time you display the portlets as particular user, they will display a link requesting you to update the login information for the external application. This login information will be remembered for subsequent visits to the portlets.

You have now successfully installed and setup the PDK-URL Services basic authentication sample portlets.

Revision History:
Revision No Last Update Description
1.0 March, 2002 Created
1.1 August 10, 2003 Revised branding and applied PDK Stylesheet
1.2 December 15, 2003 Added Web Clipping note and corrected registration information
Oracle Corporation
World Headquarters
500 Oracle Parkway
Redwood Shores, CA 94065, USA
http://www.oracle.com/		 Worldwide Inquiries:
1-800-ORACLE1
Fax 650.506.7200		 Copyright and Corporate Info