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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>9. How to use SSL with CherryPy</title>
<META NAME="description" CONTENT="9. How to use SSL with CherryPy">
<META NAME="keywords" CONTENT="howto">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="STYLESHEET" href="howto.css" type='text/css'>
<link rel="first" href="howto.html">
<link rel="contents" href="contents.html" title="Contents">
<LINK REL="next" HREF="node11.html">
<LINK REL="previous" HREF="node9.html">
<LINK REL="up" HREF="howto.html">
<LINK REL="next" HREF="node11.html">
<meta name='aesop' content='information'>
</head>
<body>
<DIV CLASS="navigation">
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><A HREF="node9.html"><img src="../icons/previous.gif"
border="0" height="32"
alt="Previous Page" width="32"></A></td>
<td><A HREF="howto.html"><img src="../icons/up.gif"
border="0" height="32"
alt="Up One Level" width="32"></A></td>
<td><A HREF="node11.html"><img src="../icons/next.gif"
border="0" height="32"
alt="Next Page" width="32"></A></td>
<td align="center" width="100%">CherryPy HowTo</td>
<td><A HREF="node1.html"><img src="../icons/contents.gif"
border="0" height="32"
alt="Contents" width="32"></A></td>
<td><img src="../icons/blank.gif"
border="0" height="32"
alt="" width="32"></td>
<td><img src="../icons/blank.gif"
border="0" height="32"
alt="" width="32"></td>
</tr></table>
<b class="navlabel">Previous:</b> <a class="sectref" HREF="node9.html">8. How can webdesigners</A>
<b class="navlabel">Up:</b> <a class="sectref" HREF="howto.html">CherryPy HowTo</A>
<b class="navlabel">Next:</b> <a class="sectref" HREF="node11.html">10. How to use</A>
<br><hr>
</DIV>
<!--End of Navigation Panel-->
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>
<UL CLASS="ChildLinks">
<LI><A href="node10.html#SECTION0010100000000000000000">9.1 Introduction</a>
<LI><A href="node10.html#SECTION0010200000000000000000">9.2 Prerequisite</a>
<LI><A href="node10.html#SECTION0010300000000000000000">9.3 Configuring the CherryPy server</a>
</ul>
<!--End of Table of Child-Links-->
<HR>
<H1><A NAME="SECTION0010000000000000000000">
9. How to use SSL with CherryPy</A>
</H1>
<P>
<H1><A NAME="SECTION0010100000000000000000">
9.1 Introduction</A>
</H1>
There are several ways to make an SSL CherryPy website:
<UL>
<LI>Either by running the CherryPy server behind Apache and by configuring Apache to handle SSL
</LI>
<LI>Or by running the CherryPy server directly and by configuring CherryPy to handle SSL
</LI>
</UL>
Only the second option is covered in this HowTo.
<P>
<H1><A NAME="SECTION0010200000000000000000">
9.2 Prerequisite</A>
</H1>
CherryPy's SSL support is based on the PyOpenSSL package. You can get it at <a class="url" href="http://pyopenssl.sourceforge.net">http://pyopenssl.sourceforge.net</a>.
I recommend using version 0.5.1 or higher of PyOpenSSL. Problems have been reported with earlier versions on some platforms.
<P>
You can test your installation by firing up the Python interpreter and typing:
<div class="verbatim"><pre>
>>> import OpenSSL
>>>
</pre></div>
If this doesn't work for you, then PyOpenSSL is not correctly installed on your system.
<P>
<H1><A NAME="SECTION0010300000000000000000">
9.3 Configuring the CherryPy server</A>
</H1>
Once you have PyOpenSSL installed, all you have to do is add 2 lines in your CherryPy config file, in the <var>server</var> section:
<div class="verbatim"><pre>
sslKeyFile=/path/to/ssl/key/file
sslCertificateFile=/path/to/ssl/certificate/file
</pre></div>
<P>
And that's it !
<P>
A "real-world" sample config file for an SSL site might be:
<div class="verbatim"><pre>
[server]
socketPort=443
sslKeyFile=server.pkey
sslCertificateFile=server.cert
</pre></div>
<P>
<DIV CLASS="navigation">
<p><hr>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><A HREF="node9.html"><img src="../icons/previous.gif"
border="0" height="32"
alt="Previous Page" width="32"></A></td>
<td><A HREF="howto.html"><img src="../icons/up.gif"
border="0" height="32"
alt="Up One Level" width="32"></A></td>
<td><A HREF="node11.html"><img src="../icons/next.gif"
border="0" height="32"
alt="Next Page" width="32"></A></td>
<td align="center" width="100%">CherryPy HowTo</td>
<td><A HREF="node1.html"><img src="../icons/contents.gif"
border="0" height="32"
alt="Contents" width="32"></A></td>
<td><img src="../icons/blank.gif"
border="0" height="32"
alt="" width="32"></td>
<td><img src="../icons/blank.gif"
border="0" height="32"
alt="" width="32"></td>
</tr></table>
<b class="navlabel">Previous:</b> <a class="sectref" HREF="node9.html">8. How can webdesigners</A>
<b class="navlabel">Up:</b> <a class="sectref" HREF="howto.html">CherryPy HowTo</A>
<b class="navlabel">Next:</b> <a class="sectref" HREF="node11.html">10. How to use</A>
<hr>
<span class="release-info">Release 0.10, documentation updated on 19 March 2004.</span>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>
|
