[1/2] git commit: Describe 2nd remap rule 'requirement' for authproxy plugin

[ml...@apache.org]

Repository: trafficserver
Updated Branches:
  refs/heads/master 7606146af -> b9cd6e371


Describe 2nd remap rule 'requirement' for authproxy plugin


Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/b9cd6e37
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/b9cd6e37
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/b9cd6e37

Branch: refs/heads/master
Commit: b9cd6e3718392672038ea844cf29b6a899402f31
Parents: 585b17e
Author: Miles Libbey <ml...@apache.org>
Authored: Tue Aug 26 15:04:42 2014 -0700
Committer: Miles Libbey <ml...@apache.org>
Committed: Tue Aug 26 15:04:56 2014 -0700

----------------------------------------------------------------------
 doc/reference/plugins/authproxy.en.rst | 13 +++++++++++++
 1 file changed, 13 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/b9cd6e37/doc/reference/plugins/authproxy.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/plugins/authproxy.en.rst b/doc/reference/plugins/authproxy.en.rst
index e2241a1..d979506 100644
--- a/doc/reference/plugins/authproxy.en.rst
+++ b/doc/reference/plugins/authproxy.en.rst
@@ -35,6 +35,13 @@ plugin. you can disable this behavior by setting
 :ts:cv:`proxy.config.http.doc_in_cache_skip_dns` to ``0`` in
 :file:`records.config`.
 
+Note that the authorization request will need to match a remap rule 
+(which, as a standalone remap rule, does not need to call the 
+AuthProxy plugin). If a second remap rule is required, by default,
+the authorization request will not have the same Host header as 
+the request from the client. It could be added using the 
+``header_rewrite`` plugin (set-header Host "pristine_host.example.com").
+
 Plugin Options
 --------------
 
@@ -84,8 +91,14 @@ HTTP request to a `HEAD` request and sending that to the origin server
   map http://cache.example.com http://origin.internal.com/ \
     @plugin=authproxy.so @pparam=--auth-transform=head
 
+  map http://origin.internal.com http://origin.internal.com/ 
+
+
 In this example, the request is directed to a local authentication server
 that authorizes the request based on internal policy rules::
 
   map http://cache.example.com http://origin.internal.com/ \
     @plugin=authproxy.so @pparam=--auth-transform=redirect @pparam=--auth-host=127.0.0.1 @pparam=--auth-port=9000
+
+  map http://origin.internal.com/ http://origin.internal.com/ \
+    @plugin=authproxy.so @pparam=--auth-transform=redirect @pparam=--auth-host=127.0.0.1 @pparam=--auth-port=9000    

[2/2] git commit: Describe the plugins in the index page.

[ml...@apache.org]

Describe the plugins in the index page.


Project: http://git-wip-us.apache.org/repos/asf/trafficserver/repo
Commit: http://git-wip-us.apache.org/repos/asf/trafficserver/commit/585b17ec
Tree: http://git-wip-us.apache.org/repos/asf/trafficserver/tree/585b17ec
Diff: http://git-wip-us.apache.org/repos/asf/trafficserver/diff/585b17ec

Branch: refs/heads/master
Commit: 585b17ece49bccdce4bf42a01455be8b89d3e2ba
Parents: 7606146
Author: Miles Libbey <ml...@apache.org>
Authored: Tue Aug 26 14:53:46 2014 -0700
Committer: Miles Libbey <ml...@apache.org>
Committed: Tue Aug 26 15:04:56 2014 -0700

----------------------------------------------------------------------
 doc/reference/plugins/index.en.rst | 45 ++++++++++++++++-----------------
 1 file changed, 22 insertions(+), 23 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/trafficserver/blob/585b17ec/doc/reference/plugins/index.en.rst
----------------------------------------------------------------------
diff --git a/doc/reference/plugins/index.en.rst b/doc/reference/plugins/index.en.rst
index 3687025..831dbf4 100644
--- a/doc/reference/plugins/index.en.rst
+++ b/doc/reference/plugins/index.en.rst
@@ -40,13 +40,13 @@ Apache Traffic Server releases.
 .. toctree::
   :maxdepth: 1
 
-  cacheurl.en
-  conf_remap.en
-  gzip.en
-  header_rewrite.en
-  regex_remap.en
-  stats_over_http.en
-  tcpinfo.en
+  CacheURL Plugin: allows you to change the key that is used for caching a request by using any portion of the url via regex <cacheurl.en>
+  conf_remap Plugin: allows you to override configuration directives dependent on actual remapping rules <conf_remap.en>
+  gzip / deflate Plugin: gzips or deflates responses <gzip.en>
+  Header Rewrite Plugin: allows you to modify various headers based on defined rules (operations) on a request or response <header_rewrite.en>
+  Regex Remap Plugin: allows you to configure mapping rules based on regular expressions <regex_remap.en>
+  Stats over HTTP Plugin: implements an HTTP interface to all Traffic Server statistics <stats_over_http.en>
+  TCPInfo Plugin: logs TCP metrics at various points in the HTTP processing pipeline <tcpinfo.en>
 
 Experimental plugins
 ====================
@@ -63,20 +63,19 @@ directory of the Apache Traffic Server source tree. Exmperimental plugins can be
 .. toctree::
   :maxdepth: 1
 
-  authproxy.en
-  background_fetch.en
-  balancer.en
-  buffer_upload.en
-  combo_handler.en
-  epic.en
-  esi.en
-  geoip_acl.en
-  hipes.en
-  metalink.en
-  mysql_remap.en
-  s3_auth.en
-  sslheaders.en
-  stale_while_revalidate.en
-  ts_lua.en
-  xdebug.en
+  AuthProxy Plugin: delegates the authorization decision of a request to an external HTTP service <authproxy.en>
+  Background Fetch Plugin: allows you to proactively fetch content from Origin in a way that it will fill the object into cache <background_fetch.en>
+  Balancer Plugin: balances requests across multiple origin servers <balancer.en>
+  Buffer Upload Plugin: buffers POST data before connecting to the Origin server <buffer_upload.en>
+  Combohandler Plugin: provides an intelligent way to combine multiple URLs into a single URL, and have Apache Traffic Server combine the components into one response <combo_handler.en>
+  Epic Plugin: emits Traffic Server metrics in a format that is consumed tby the Epic Network Monitoring System <epic.en>
+  ESI Plugin: implements the ESI specification <esi.en>
+  GeoIP ACLs Plugin: denying (or allowing) requests based on the source IP geo-location <geoip_acl.en>
+  hipes.en 
+  Metalink Plugin: implements the Metalink download description format in order to try not to download the same file twice. <metalink.en>
+  MySQL Remap Plugin: allows dynamic “remaps” from a database <mysql_remap.en>
+  AWS S3 Authentication plugin: provides support for the Amazon S3 authentication features <s3_auth.en>
+  stale_while_revalidate.en 
+  ts-lua Plugin: allows plugins to be written in Lua instead of C code <ts_lua.en>
+  XDebug Plugin: allows HTTP clients to debug the operation of the Traffic Server cache using the X-Debug header <xdebug.en>