A Oracle Secure Enterprise Search Secure Portlet

This appendix describes the tasks to register an Oracle SES WSRP portlet (or, secure portlet). OracleAS Portal customers can use this portlet from their Portal pages. This secure portlet requires Oracle Application Server Portal 10.1.4.

This contains the following topics:

• Oracle SES Tasks to Register a Secure Portlet

• OracleAS Portal Tasks to Register a Secure Portlet

Oracle SES Tasks to Register a Secure Portlet

This section lists the tasks necessary on the Oracle SES (provider) side.

Note:

The same commands can be used if Oracle SES is installed in Windows if you use "\" in place of "/" for the directory path.

In this section, $ORACLE_HOME represents the path where Oracle SES is installed. On Windows, the equivalent is %ORACLE_HOME%.

1. Edit portlet.xml:

   From the $ORACLE_HOME/oc4j/j2ee/OC4J_SEARCH/applications/search_portlet/search_portlet_war/WEB-INF directory, edit the portlet.xml file to change the following <init-param> element values:

   • endPointURL: Change this value to http://<host-name>:<port-number>/search/query/OracleSearch where <host-name> and <port-number> are the host name and port number of the Oracle SES instance.

   • absUrlPrefix: Change this value to http://<host-name>:<port-number>/ where <host-name> and <port-number> are the host name and port number of the Oracle SES instance.

   • secureContentSearch: Set this value to true to enable secure search.

   • secureMode: Change this value to 3 if the end user authentication for secure search has been changed to "Require login for public and secure content" on the Global Settings - Query Configuration page.

   • appID: Set this value to one of the keys that is configured as a federated trusted entity. This is necessary to enable secure search.

   • appPWD: Change this value to the password of the configured federated trusted entity. This is necessary to enable secure search.

   Note:

   Set up federated trusted entities on the Global Settings - Federation Trusted Entities page in Oracle SES. Enter an entity name and password, then click Add. The entry will be added to the Trusted Entities table.

2. Restart the Oracle SES OC4J instance to enable the changes made to portlet.xml.

   From the $ORACLE_HOME/bin directory, run the following command:

   ./ searchctl restart
   

   On Windows, run the following command:

   searchctl restart
   

The portlet is up and now can be registered with OracleAS Portal.

OracleAS Portal Tasks to Register a Secure Portlet

This section lists the tasks necessary on the OracleAS Portal 10.1.4 (consumer) side.

1. Register Portlet Provider:

   1. Log in to OracleAS Portal.

   2. Click the Navigator link.

   3. Click the Providers tab.

   4. Click the Registered Providers link.

   5. Click the Register New… Provider link.

   6. Enter a name for the provider and select WSRP from the Implementation Style box. Click Next.

   7. Enter the Oracle SES portlet WSDL URL http://<host-name>:<port-number>/sesPortlet/portlets/WSRPBaseService?WSDL in the text box, where <host-name> and <port-number> are the host name and port number of the Oracle SES instance. Click Next.

   8. Click Finish.

   9. Click OK to complete registration of portlet provider.

2. Create a Portlet Page:

   1. Click the Page groups tab.

   2. Click the Create New… Page Group link.

   3. Enter a display name. Click Create.

   4. Click Add Portlet.

   5. Click Portlet Staging Area.

   6. Click the link that shows the provider name, which was registered in Step 1.

   7. Click the SESPortlet link. Click OK.

   The portlet is now added to the portal page.

   Note:

   The following error can occur when registering the WSRP portlet:

   HTTP transport error : java.lang.NullPointerException
   

   Workaround: Confirm that the WSRP portlet WSDL URL (provided when registering) is correct. Also, check the version of the Oracle Database used by the Oracle Portal 10.1.4. If the Oracle Database version is 10.2, then install the Portal patch 5009567.