| |

Introduction

Ruddi comes with a default SOAP transport layer and can also be configured to use Apache Axis 1.0. The default SOAP transport layer and the Axis one are merely equivalent in the specific context of UDDI registry access. However, the default SOAP transport layer will be more efficient when the UDDI registry replies are accessed as streams instead of as Ruddi response objects.

Working with the Ruddi default SOAP transport

No particular setting is required. The default SOAP transport provided with Ruddi will be used whenever the "inspireit.uddi.transport" property of the UDDIProfile defining the execution context has not been explicitly set.

Working with the Apache Axis 1.0 SOAP transport

In order to enable Apache Axis 1.0-support for Ruddi, the "inspireit.uddi.transport" property of the UDDIProfile defining the execution context has to be set to the "inspireit.uddi.transport.Axis10Transport" value.

Configuring proxy support

Proxy support requires the following java.lang.System properties to be set:

• http.proxyHost
  The hostname of HTTP proxy server.
• http.proxyPort
  The port number of the HTTP proxy server.

If the proxy server requires authentication, the following additional java.lang.System properties can be used:

• http.proxyUserName
  The username of the username/password combination used to authenticate to the proxy server.
• http.proxyPassword
  The password of the username/password combination used to authenticate to the proxy server.

When accessing HTTPS servers through a web proxy, you must also set the "https.proxyHost" and "https.proxyPort" java.lang.System properties to the correct host name and port number of the web proxy:

• https.proxyHost
  The hostname of the HTTPS proxy server.
• https.proxyPort
  The port number of the HTTPS proxy server.

Configuring SSL support

The UDDI specification recommends the use of SSL V3 as the security mechanism to access the publishing functions of an UDDI registry. Ruddi uses JSSE, the Java Secure Socket Extension, to enable HTTP over SSL.

JSSE is an optional security component of the Java 2 platform. It builds on the security architecture in the core Java 2 platform. The Reference Implementation (RI) can be downloaded for free from Javasoft's Web site. It is also included in the J2SE 1.4 release of Java.

Provided Javasoft's JSSE is properly installed and made available to your Ruddi application via proper CLASSPATH setting, adding the following lines of code to your applications will enable HTTP over SSL:

System.setProperty("java.protocol.handler.pkgs", "com.sun.net.ssl.internal.www.protocol");

java.security.Security.addProvider(new com.sun.net.ssl.internal.ssl.Provider());