From 353e6ad7ddcf6cff7a3eda584661d5177b842f4d Mon Sep 17 00:00:00 2001
From: Rich Bowen <rbowen@apache.org>
Date: Thu, 4 Nov 2010 15:21:24 +0000
Subject: [PATCH] Adds an example of how to set up SSL to the SSL howto. Seems
 like an obvious omission.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1031028 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/ssl/ssl_howto.html.en | 21 ++++++++++++++++++++-
 docs/manual/ssl/ssl_howto.xml     | 18 ++++++++++++++++++
 2 files changed, 38 insertions(+), 1 deletion(-)

diff --git a/docs/manual/ssl/ssl_howto.html.en b/docs/manual/ssl/ssl_howto.html.en
index 773f6fd991..ad15f9ed5d 100644
--- a/docs/manual/ssl/ssl_howto.html.en
+++ b/docs/manual/ssl/ssl_howto.html.en
@@ -37,12 +37,31 @@ step to find out the final solution, but always try to understand the
 stuff before you use it. Nothing is worse than using a security solution
 without knowing its restrictions and how it interacts with other systems.</p>
 </div>
-<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#ciphersuites">Cipher Suites and Enforcing Strong Security</a></li>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#configexample">Basic Configuration Example</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#ciphersuites">Cipher Suites and Enforcing Strong Security</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#accesscontrol">Client Authentication and Access Control</a></li>
 <li><img alt="" src="../images/down.gif" /> <a href="#logging">Logging</a></li>
 </ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
+<h2><a name="configexample" id="configexample">Basic Configuration Example</a></h2>
+
+
+<p>Your SSL configuration will need to contain, at a minumum, the
+following directives.</p>
+
+<div class="example"><p><code>
+   Listen 443
+   &lt;VirtualHost _default_:443&gt;<br />
+        ServerName www.domain.com<br />
+        SSLEngine on<br />
+        SSLCertificateFile /path/to/www.comain.com.cert<br />
+        SSLCertificateKeyFile /path/to/www.domain.com.key<br />
+   &lt;/VirtualHost&gt;
+</code></p></div>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
 <h2><a name="ciphersuites" id="ciphersuites">Cipher Suites and Enforcing Strong Security</a></h2>
 
 <ul>
diff --git a/docs/manual/ssl/ssl_howto.xml b/docs/manual/ssl/ssl_howto.xml
index 512622a5b0..bc8bd38743 100644
--- a/docs/manual/ssl/ssl_howto.xml
+++ b/docs/manual/ssl/ssl_howto.xml
@@ -42,6 +42,24 @@ stuff before you use it. Nothing is worse than using a security solution
 without knowing its restrictions and how it interacts with other systems.</p>
 </summary>
 
+<section id="configexample">
+<title>Basic Configuration Example</title>
+
+<p>Your SSL configuration will need to contain, at a minumum, the
+following directives.</p>
+
+<example>
+   Listen 443
+   &lt;VirtualHost _default_:443&gt;<br />
+        ServerName www.domain.com<br />
+        SSLEngine on<br />
+        SSLCertificateFile /path/to/www.comain.com.cert<br />
+        SSLCertificateKeyFile /path/to/www.domain.com.key<br />
+   &lt;/VirtualHost&gt;
+</example>
+
+</section>
+
 <section id="ciphersuites">
 <title>Cipher Suites and Enforcing Strong Security</title>
 <ul>
-- 
2.50.1