Oracle9iAS Portal Developer Kit
Installing the PDK-URL Services Basic Authentication Portlets (V2)

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.  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.

REQUIREMENTS

  1. Oracle9iAS Portal 3.0.8.9.8 or later.  Most features of the PDK-URL Services work with older versions, but is only certified against this version of Oracle9iAS Portal. Certain features such as authenticated portlets will not work on older versions of Oracle9iAS Portal.
  2. PDK-Java 9.0.2.

ASSUMPTIONS

  1. You have already successfully installed the PDK-Java Framework and samples by following the Installing the PDK-Java Framework and Samples (V2) 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

  2. Review the content of the test page displayed.

    If you did not receive the test page, verify that you can execute standard servlets using Oracle9iAS.

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. On the Administer tab of the Portal Design-Time Pages root page, click on Administer External Applications within the portlet called SSO Server Administration.
  2. 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
  3. Click OK.
  4. Click on the external application link for Oracle Metalink and supply your username and password for Metalink.  Leave the box checked to save credentials.

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

  1. On the Build tab of the Portal Design-Time Pages root page, click on Register a Portlet Provider within the portlet called Provider.
  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
    8. Login Frequency: Once Per User Session
  3. 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".  You have now successfully installed and setup the PDK-URL Services basic authentication sample portlets.

Revision History:

·         March 2002.