System Properties for Proxy Server

The portal supports working through a network proxy server to control and limit access to resources outside the company domain.

This section describes how to define a proxy for the portal by setting the system properties for the proxy server.

Note Note

URL iViews that employ the server-side fetch method (see Fetch Method property in URL iView Properties) use the proxy settings defined on the portal server, as described below. URL iViews that employ the client-side fetch method rely instead on the proxy settings defined in the browser of each portal user.

End of the note.

Note Note

In addition to the procedure described here, it is possible to define proxy setting using XML script. For more information, see XML Content and Actions.

End of the note.

Prerequisites

The existence of a server to be used a proxy server for the portal

Procedure

In the portal, navigate to System Administration System Configuration Service Configuration .
In the Portal Catalog, navigate to Applications com.sap.portal.ivs.httpservice Services proxy .
Right-click proxy and choose Configure. The Property Editor appears displaying all available service properties.
For information on working with the property Editor, see Property Editor.
Specify the proxy server property values, as described below, in the fields provided for each value.
Click Save.
Close the editor of the proxy service.
Restart the services in the com.sap.portal.ivs.httpservice application as follows:
1. Right-click com.sap.portal.ivs.httpservice and choose Administrate. The application details are displayed.
2. Click Restart for the following services:
  - com.sap.portal.ivs.httpservice|http
  - com.sap.portal.ivs.httpservice|proxy
3. Next to Action, click Restart.
Close the editor of the com.sap.portal.ivs.httpservice application.

Note Note

The portal proxy service settings may also be configured by uploading an XML script using the XML Content and Actions tool.

End of the note.

Proxy Properties

The values set here are for the system settings of the Java Virtual Machine (JVM). Proxy settings consist of defining values for a set of four identical properties for three separate protocols: FTP, HTTP, and HTTPS.

The properties to set for each protocol are: (the table refers to the HTTP protocol only; use the relevant properties for HTTPS and FTP):

`HTTP - Enable Proxy Setting`*	To work through a proxy, enter `true`.
`HTTP Proxy Host`*	IP address or name of the proxy server.
`HTTP Proxy Port`*	Port number of the proxy server
`HTTP - Bypass Proxy Servers`*	Hosts which should be connected to directly and not through the proxy server. The value can be a list of hosts, each separated with any of the following four symbols: `space` `pipe (\|)` `semi-colon (;)` `comma (,)` You may use a wildcard character (``) for matching. Example: `.goofy.sap.com\|.mickey.sap.com;.donald.sap.com`
`HTTP - Reset JVM Settings`	If you configured proxy server properties directly to the AS Java JVM, set this property to `false` to avoid ovewriting them at startup, or restart of the service. The default setting is `true`.

*The properties in the table refer to the HTTP protocol only. For HTTPS and FTP, use the relevant properties; for example, HTTPS - Enable Proxy Setting and FTP - Bypass Proxy Servers.

Authentication Properties

The following properties also appear in the Property Editor for basic authentication:

Sets user name for proxy basic authentication
Sets password for proxy basic authentication

Firewall Properties

Also available for selection in the properties list are the following properties, which you configure in the event that a firewall is part of your network configuration:

Firewall Proxy Host
Firewall Proxy Port
Firewall - Enable Proxy Setting (for which you enter true to activate)

Note Note

Properties for which no values are entered are ignored and do not override existing values.

End of the note.