Author: ron.sigal(a)jboss.com
Date: 2012-07-18 22:33:24 -0400 (Wed, 18 Jul 2012)
New Revision: 6455
Modified:
remoting2/branches/2.2/docs/guide/en/chap5.xml
Log:
JBREM-1306: Add discussion of new parameter "useDefaultSslSocketFactory".
Modified: remoting2/branches/2.2/docs/guide/en/chap5.xml
===================================================================
--- remoting2/branches/2.2/docs/guide/en/chap5.xml 2012-07-19 02:24:31 UTC (rev 6454)
+++ remoting2/branches/2.2/docs/guide/en/chap5.xml 2012-07-19 02:33:24 UTC (rev 6455)
@@ -2,7 +2,7 @@
<chapter id="chapter-configuration" xreflabel="Configuration">
<title>Configuration</title>
- <para>This covers the configuration for JBoss Remoting discovery,
+ <para>This chapter covers the configuration for JBoss Remoting discovery,
connectors, marshallers, and transports. All the configuration properties
specified can be set either via calls to the object itself, including via
JMX (so can be done via the JMX or Web console), or via a JBoss AS service
@@ -1486,7 +1486,6 @@
Invoker uses an <classname>SSLServerSocket</classname> by default,
created by an <classname>SSLServerSocketFactory</classname>. See
section
<xref linkend="section-socket-factories" /> for more
information.</para>
- </section>
<section>
<title>HTTP(S) Client Invoker - proxy and basic authentication</title>
@@ -1609,7 +1608,23 @@
<classname>SocketFactory</classname> configuration.
</para>
-
+ </section>
+
+ <section>
+ <title>HTTPS client socket factory configuration</title>
+
+ <para>If a socket factory is not passed into the HTTPS client invoker, it
will use
+ <classname>org.jboss.remoting.security.SSLSocketBuilder</classname>
to create one.
+ However, it might be desirable to allow it to fall back to a default socket
factory
+ passed into HttpsURLConnection. As of release 2.5.4.SP4, a configuration
parameter is
+ available to allow that to happen.
+ </para>
+
+ <para><emphasis
role="bold">useDefaultSslSocketFactory</emphasis> - If the parameter
is
+ set to "true",
<methodname>HTTPSClientInvoker.createSocketFactory()</methodname>
+ will call
<methodname>HttpsURLConnection.getDefaultSSLSocketFactory()</methodname>
+ instead of trying to build a socket factory.</para>
+ </section>
</section>
<section>
@@ -6846,6 +6861,11 @@
used by the http client invoker. The value should be the fully qualified
classname of class that implements javax.net.ssl.HostnameVerifier and has
a void constructor.</para>
+
+ <para><emphasis
role="bold">USE_DEFAULT_SSL_SOCKET_FACTORY</emphasis> (actual value is
+ 'useDefaultSslSocketFactory') - if set to true, then
HTTPSClientInvoker.createSocketFactory()
+ will call HttpsURLConnection.getDefaultSSLSocketFactory() instead of trying to build
a SocketFactory.
+ </para>
<para></para>
Show replies by date