Chapter 13 Configuring Proxylet

This chapter describes configuring Proxylet from the Sun Java System Portal Server administration console.

This chapter contains the following sections:

• Configuring the Proxylet Attributes

• Configuring Applications to the Portal Desktop

• Launching Proxylet in Java Web Start or Applet Mode

Configuring the Proxylet Attributes

Proxylet can be configured to launch automatically when the user logs in by checking the Download Proxylet Applet Automatically checkbox under Deployment options. When the Download Proxylet Automatically checkbox is not selected, users can get Proxylet on-demand by clicking the Launch the Proxylet link in the Proxylet channel on the standard Portal Desktop.

To Configure the Proxylet Attributes

1. Log into Portal Server administration console as administrator.

2. Select the Secure Remote Access tab, and select the Proxylet tab.

3. Select an appropriate DN from the Select DN list box or add an existing DN for a specific user or an organization.

4. Under the Proxylet page, do the following:

   Attribute Name	Description
   COS Priority	Select the class of service for Proxylet traffic from a list of options.
   Download Proxylet Applet Automatically	Click Yes to automatically download the Proxylet applet to the client machine. The following are the basic requirements to download the Proxylet applet:
   	Client machine can run a server application
   	Client machine Java version is 1.4 and above
   	The browser is IE 6.0 sp2 or Firefox 2.0
   	Correct browser permissions
   Refresh Portal via Proxylet	Click Yes if you want to refresh your Portal desktop after the Proxylet is launched, and make the traffic to go through the Proxylet. "App Urls" won't be functional if both "Refresh portal after Proxylet Launch" and "Download Proxylet Applet Automatically" are enabled.
   Launch Mode	Select Java Web Start or Applet.
   Default Proxylet Applet Bind IP	Type the IP address where Proxylet binds and listens for requests from the browser.
   Default Proxylet Applet Port	Type the port number where Proxylet listens for requests from a browser.
   Automatic Proxy Configuration File Location	Type the location of the configuration file that contains proxy settings from the Proxy Auto Configuration (PAC) file or from the proxy configuration list.

5. In the Proxylet Rules option, do the following:

   1. Specify the rules for the application to be launched through the Proxylet service.

   2. Click Add.

   3. Enter the domain name, for example, www.google.com in the Domain field.

   4. Enter the host and corresponding port number for domain for Proxylet to process. This ensures that the Proxylet resolves the HTTP requests and the requests are not routed through the gateway.

6. Click Save to complete.

Configuring Applications to the Portal Desktop

Requests such as HTTP, FTP, and so on go through the Proxylet service. Proxylet rules allow the administrator to specify mappings based on protocol, host, or port to domains. With Proxylet rules your can specify the domain and proxy settings in the Proxy Auto Configuration (PAC) file. For example, you can create a rule so that all FTP traffic is routed through Netlet and all HTTP traffic is routed through Proxylet. You can configure predefined applications that need to be rendered through the Proxylet service. This can be done based on the user or organization preferences. Once the applications are added for Proxylet to process, the users desktop is easier to manage and provides better performance.

To Configure an Application to the Portal Desktop

Before You Begin

• Ensure that the Proxylet option is enabled. For more information on enabling Proxylet, see the Gateway Profiles chapter.

1. Log into Portal Server administration console as administrator.

2. Select the Portal tab, and select the portal instance to modify.

   The Desktop page is displayed.

3. Select an appropriate DN from the Select DN list box or add an existing DN for a specific user or an organization.

4. Click the Manage Containers and Channels link.

   The Manage Containers and Channels page is displayed.

5. From the left pane, select Proxylet.

6. From the right pane, select the Appurls link.

7. In the Properties wizard, enter the application name and the value. Modify the properties of the application as required. For example, enter an appropriate name for the application, and http://www.example.com.

8. Click Close to complete.

   The user or at the organization level can now view the application link on the Portal Desktop.

Launching Proxylet in Java Web Start or Applet Mode

You can start Proxylet either in the Java Web Start or Applet mode from the Portal Desktop.

To Launch Proxylet in Java Web Start or Applet Mode

1. Log onto the Portal Desktop as the proxylet user.

2. In the Front Page, go to the Proxylet channel and click the Edit icon.

3. From the Launch Mode list box, select the Java Web Start or Applet option.

4. Click Finished.

   To invoke Proxylet, select the application from the Proxylet Channel. This launches the application in the Java Web Start or Applet mode.

   • If the Download Automatically is selected, click the application under the Proxylet channel.

   • Based on the user preferences, the Proxylet console is displayed depending on the selection of Java Web Start or Applet mode. Accept all certificates and continue to work on the application.