[Rt-commit] rt branch, 4.0/mailgate-ssl-deps, updated. rt-4.0.4-112-g1046d51

[Kevin Falcone]

The branch, 4.0/mailgate-ssl-deps has been updated
       via  1046d51f406b67d70dc2c53c2f912ea98167e44a (commit)
      from  30754d74e44dde3d5e6e982336d5afae5775066d (commit)

Summary of changes:
 README             |    7 +++++++
 bin/rt-mailgate.in |    5 ++++-
 docs/security.pod  |    7 +++++--
 3 files changed, 16 insertions(+), 3 deletions(-)

- Log -----------------------------------------------------------------
commit 1046d51f406b67d70dc2c53c2f912ea98167e44a
Author: Kevin Falcone <falcone at bestpractical.com>
Date:   Mon Dec 12 12:53:23 2011 -0500

    Add some pointers to --enable-ssl-mailgate
    
    README, security and rt-mailgate seem to be the relevant places.
    We don't discuss SSL in web_deployment.pod so I haven't added a mention
    there.  We probably should discuss SSL and basic auth in that file in
    the future.

diff --git a/README b/README
index d14c91e..4fd4234 100644
--- a/README
+++ b/README
@@ -226,6 +226,13 @@ GENERAL INSTALLATION
 
            perldoc /opt/rt4/bin/rt-mailgate
 
+    If your webserver uses SSL, rt-mailgate will require several new
+    Perl libraries. RT can detect and install these for you automatically
+    if you include --enable-ssl-mailgate when running configure and then
+    run make fixdeps as described in step 4.  It is safe to rerun configure
+    and make fixdeps after you have installed RT, you should be sure to include
+    all the arguments you used in step 2 plus --enable-ssl-mailgate.
+
 
 GETTING HELP
 ------------
diff --git a/bin/rt-mailgate.in b/bin/rt-mailgate.in
index 2d5402f..ab5e5b6 100755
--- a/bin/rt-mailgate.in
+++ b/bin/rt-mailgate.in
@@ -349,8 +349,11 @@ is found.
 =item C<--url>
 
 This flag tells the mail gateway where it can find your RT server. You should 
-probably use the same URL that users use to log into RT.
+probably use the same URL that users use to log into RT.  
 
+If your RT server uses SSL, you will need to install additional Perl
+libraries. RT will detect and install these dependencies if you pass the
+C<--enable-ssl-mailgate> flag to configure as documented in RT's README.
 
 =item C<--extension> OPTIONAL
 
diff --git a/docs/security.pod b/docs/security.pod
index 8bf12bd..6c0599d 100644
--- a/docs/security.pod
+++ b/docs/security.pod
@@ -17,8 +17,11 @@ More information is available at L<http://bestpractical.com/security/>.
 
 Protect your RT installation by making it only accessible via SSL.  This
 will protect against users' passwords being sniffed as they go over the
-wire, as well as helping prevent phishing attacks.
-
+wire, as well as helping prevent phishing attacks.  If you use SSL, you
+will need to install some additional Perl libraries so that C<rt-mailgate>
+can connect.  You can use the C<--enable-ssl-mailgate> command to
+configure to automate the installation of these dependencies.  This is
+documented further in step 10 of the README.
 
 =item *
 

-----------------------------------------------------------------------