content/xdocs/Configure Java Qpid to use a SSL connection..html


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64

<html>
    <head>
        <title>Apache Qpid : Configure Java Qpid to use a SSL connection.</title>
	    <link rel="stylesheet" href="styles/site.css" type="text/css" />
        <META http-equiv="Content-Type" content="text/html; charset=UTF-8">	    
    </head>

    <body>
	    <table class="pagecontent" border="0" cellpadding="0" cellspacing="0" width="100%" bgcolor="#ffffff">
		    <tr>
			    <td valign="top" class="pagebody">
				    <div class="pageheader">
					    <span class="pagetitle">
                            Apache Qpid : Configure Java Qpid to use a SSL connection.
                                                    </span>
				    </div>
				    <div class="pagesubheading">
					    This page last changed on Dec 05, 2007 by <font color="#0050B2">ritchiem</font>.
				    </div>

				    <h2><a name="ConfigureJavaQpidtouseaSSLconnection.-UsingSSLconnectionwithQpidJava."></a>Using SSL connection with Qpid Java.</h2>

<p>This section will show how to use SSL to enable secure connections between a Java client and broker.</p>


<h2><a name="ConfigureJavaQpidtouseaSSLconnection.-Setup"></a>Setup</h2>

<h3><a name="ConfigureJavaQpidtouseaSSLconnection.-BrokerSetup"></a>Broker Setup</h3>

<p>The broker configuration file (config.xml) needs to be updated to include the SSL keystore location details.</p>
<div class="code" style="border-style: solid; "><div class="codeHeader" style="border-bottom-style: solid; "><b>Additions required to Connector Section</b></div><div class="codeContent">
<pre class="code-java">&lt;ssl&gt;
    &lt;enabled&gt;<span class="code-keyword">true</span>&lt;/enabled&gt;
    &lt;sslOnly&gt;<span class="code-keyword">true</span>&lt;/sslOnly&gt;
    &lt;keystorePath&gt;/path/to/keystore.ks&lt;/keystorePath&gt;
    &lt;keystorePassword&gt;keystorepass&lt;/keystorePassword&gt;
&lt;/ssl&gt;</pre>
</div></div>

<p>The sslOnly option is included here for completeness however this will disable the unencrypted port and leave only the SSL port listening for connections.</p>


<h3><a name="ConfigureJavaQpidtouseaSSLconnection.-ClientSetup"></a>Client Setup</h3>

<p>The best place to start looking is class <em>SSLConfiguration</em> this is provided to the connection during creation however there is currently no example that demonstrates its use.</p>

<h2><a name="ConfigureJavaQpidtouseaSSLconnection.-Performingtheconnection."></a>Performing the connection.</h2>


                    			    </td>
		    </tr>
	    </table>
	    <table border="0" cellpadding="0" cellspacing="0" width="100%">
			<tr>
				<td height="12" background="border/border_bottom.gif"><img src="border/spacer.gif" width="1" height="1" border="0"/></td>
			</tr>
		    <tr>
			    <td align="center"><font color="grey">Document generated by Confluence on Apr 22, 2008 02:47</font></td>
		    </tr>
	    </table>
    </body>
</html>