svn commit: r220310 - /httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml

[ma...@apache.org]

Author: martin
Date: Fri Jul 22 05:36:25 2005
New Revision: 220310

URL: http://svn.apache.org/viewcvs?rev=220310&view=rev
Log:
Describe the new syntax:
  SetenvIf OID("2.16.840.1.113730.1.13") "(.*)" NetscapeComment=$1

Ehhmm.... How do I make html from this again?

Modified:
    httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml

Modified: httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml?rev=220310&r1=220309&r2=220310&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_setenvif.xml Fri Jul 22 05:36:25 2005
@@ -135,7 +135,7 @@
 <usage>
     <p>The <directive>SetEnvIf</directive> directive defines
     environment variables based on attributes of the request. The
-    <em>attribute</em> specified in the first argument can be one of three
+    <em>attribute</em> specified in the first argument can be one of four
     things:</p>
 
 <ol>
@@ -182,6 +182,15 @@
 Environment variables will be considered only if there was no match
 among request characteristics and a regular expression was not
 used for the <em>attribute</em>.</li>
+
+<li>
+ A reference to an extension of an SSL client certificate, located by
+ its object id <em>oid</em>.
+ If a non-SSL request, or in absense of the configured <em>oid</em>,
+ no variable will be set. If the <em>oid</em> is found multiple times,
+ the individual strings will be concatenated, separated by a comma <code>','</code>.
+ The <em>oid</em> should reference a string-valued extension.
+</li>
 </ol>
 
 <p>The second argument (<em>regex</em>) is a <a
@@ -220,6 +229,8 @@
         :<br />
    SetEnvIf object_is_image xbm XBIT_PROCESSING=1<br />
         :<br />
+   SetEnvIf OID("2.16.840.1.113730.1.13") "(.*)" NetscapeComment=$1<br />
+        :<br />
    SetEnvIf ^TS*  ^[a-z].*  HAVE_TS<br />
 </example>
 
@@ -228,6 +239,10 @@
     file, and the fourth sets <code>intra_site_referral</code> if
     the referring page was somewhere on the
     <code>www.mydomain.com</code> Web site.</p>
+
+    <p>The sixth example will set the <code>NetscapeComment</code>
+    environment variable to the string found in the corresponding
+    SSL client certificate field (if found).</p>
 
     <p>The last example will set environment variable
     <code>HAVE_TS</code> if the request contains any headers that