From 361dcd147840274b3a605cb29d6647dc37889fbf Mon Sep 17 00:00:00 2001
From: Nick Kew <niq@apache.org>
Date: Tue, 29 Jun 2004 06:59:11 +0000
Subject: [PATCH] Document mod_proxy updates incl. new directives for
 reverse-proxied cookies

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@104071 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_proxy.xml | 38 +++++++++++++++++++++++++++++++++--
 docs/manual/urlmapping.xml    | 16 ++++++++++++---
 2 files changed, 49 insertions(+), 5 deletions(-)

diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index 33ad24e405e..6be58404202 100644
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0"?>
 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
 <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
-<!-- $Revision: 1.29 $ -->
+<!-- $Revision: 1.30 $ -->
 
 <!--
  Copyright 2002-2004 The Apache Software Foundation
@@ -600,7 +600,7 @@ proxied server</description>
     This means that if the proxied content contains absolute URL
     references, they will by-pass the proxy.  A third-party module
     that will look inside the HTML and rewrite URL references is Nick
-    Kew's <a href="http://www.webthing.com/software/mod_proxy_html/"
+    Kew's <a href="http://apache.webthing.com/software/mod_proxy_html/"
     >mod_proxy_html</a>.</p>
 
     <p><var>path</var> is the name of a local virtual path. <var>url</var> is a
@@ -613,6 +613,8 @@ proxied server</description>
     <example>
       ProxyPass         /mirror/foo/ http://backend.example.com/<br />
       ProxyPassReverse  /mirror/foo/ http://backend.example.com/
+      ProxyPassReverseCookieDomain  backend.example.com  public.example.com
+      ProxyPassReverseCookiePath  /  /mirror/foo/
     </example>
 
     <p>will not only cause a local request for the
@@ -640,6 +642,38 @@ proxied server</description>
 </usage>
 </directivesynopsis>
 
+<directivesynopsis>
+<name>ProxyPassReverseCookieDomain</name>
+<description>Adjusts the Domain string in Set-Cookie headers from a reverse-
+proxied server</description>
+<syntax>ProxyPassReverseCookieDomain <var>internal-domain</var> <var>public-domain</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context>
+</contextlist>
+<usage>
+<p>Usage is basically similar to
+<directive module="mod_proxy">ProxyPassReverse</directive>, but instead of
+rewriting headers that are a URL, this rewrites the <code>domain</code>
+string in <code>Set-Cookie</code> headers.</p>
+</usage>
+</directivesynopsis>
+<directivesynopsis>
+<name>ProxyPassReverseCookiePath</name>
+<description>Adjusts the Path string in Set-Cookie headers from a reverse-
+proxied server</description>
+<syntax>ProxyPassReverseCookiePath <var>internal-path</var> <var>public-path</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context>
+</contextlist>
+<usage>
+<p>Usage is basically similar to
+<directive module="mod_proxy">ProxyPassReverse</directive>, but instead of
+rewriting headers that are a URL, this rewrites the <code>path</code>
+string in <code>Set-Cookie</code> headers.</p>
+</usage>
+</directivesynopsis>
+
+
 <directivesynopsis>
 <name>AllowCONNECT</name>
 <description>Ports that are allowed to <code>CONNECT</code> through the
diff --git a/docs/manual/urlmapping.xml b/docs/manual/urlmapping.xml
index 683272d3647..6a7e58f1efd 100644
--- a/docs/manual/urlmapping.xml
+++ b/docs/manual/urlmapping.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
 <?xml-stylesheet type="text/xsl" href="./style/manual.en.xsl"?>
-<!-- $Revision: 1.12 $ -->
+<!-- $Revision: 1.13 $ -->
 
 <!--
  Copyright 2002-2004 The Apache Software Foundation
@@ -49,6 +49,8 @@
 <directive module="core">Options</directive>
 <directive module="mod_proxy">ProxyPass</directive>
 <directive module="mod_proxy">ProxyPassReverse</directive>
+<directive module="mod_proxy">ProxyPassReverseCookieDomain</directive>
+<directive module="mod_proxy">ProxyPassReverseCookiePath</directive>
 <directive module="mod_alias">Redirect</directive>
 <directive module="mod_alias">RedirectMatch</directive>
 <directive module="mod_rewrite">RewriteCond</directive>
@@ -223,6 +225,8 @@ server.</p>
 <example>
 ProxyPass /foo/ http://internal.example.com/bar/<br />
 ProxyPassReverse /foo/ http://internal.example.com/bar/
+ProxyPassReverseCookieDomain internal.example.com public.example.com
+ProxyPassReverseCookiePath /foo/ /bar/
 </example>
 
 <p>The <directive module="mod_proxy">ProxyPass</directive> configures
@@ -230,11 +234,17 @@ the server to fetch the appropriate documents, while the
 <directive module="mod_proxy">ProxyPassReverse</directive>
 directive rewrites redirects originating at
 <code>internal.example.com</code> so that they target the appropriate
-directory on the local server.  It is important to note, however, that
+directory on the local server.  Similarly, the
+<directive module="mod_proxy">ProxyPassReverseCookieDomain</directive>
+and <directive module="mod_proxy">ProxyPassReverseCookieDomain</directive>
+rewrite cookies set by the backend server.</p>
+<p>It is important to note, however, that
 links inside the documents will not be rewritten.  So any absolute
 links on <code>internal.example.com</code> will result in the client
 breaking out of the proxy server and requesting directly from
-<code>internal.example.com</code>.</p>
+<code>internal.example.com</code>.  A third-party module
+<a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a>
+is available to rewrite links in HTML and XHTML.</p>
 </section>
 
 <section id="rewrite"><title>Rewriting Engine</title>
-- 
2.47.2