home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / ONLINE / SREFV12J / CONFIGS.ZIP / addpurl.cnf < prev    next >
Text File  |  1997-03-01  |  5KB  |  130 lines
  1.  
  2. <h1>  Add a Public Area Identifier</h1>
  3.  
  4. <b>PUBLIC Area Identifiers</b>  can be used to allow free access
  5. to selected areas of your web site.  For these areas,
  6. <EM>logon </EM>and <EM>access</EM> controls are suspended.
  7.  
  8.  
  9. <p>
  10. <FORM ACTION="/srefconf" METHOD="GET">
  11. <input type="hidden" name="SET" value="add_publicurl">
  12. Define a<STRONG> Public Area Identifier</STRONG>
  13. <em>(request selectors are compared to Public Area Identifiers): </em>
  14. <INPUT TYPE="text" NAME="url"
  15.  VALUE=""  SIZE=40 MAXLENGTH=80>
  16. <p><strong>Options</strong><br>
  17. For a client request that matches this <STRONG>PUBLIC Area Identifier</STRONG>:
  18. <ul>
  19. <LI> <INPUT TYPE="CHECKBOX" NAME="literal" VALUE="1"  CHECKED> 
  20. Suppress <em>server side includes, redirection, virtual directories and default document lookup</em>
  21. <LI> <INPUT TYPE="CHECKBOX" NAME="norecord" VALUE="1"  CHECKED>
  22. Suppress  <em>common-log auditing and SRE-Filter's recording of this request</em>
  23. </ul>
  24.  
  25. <BR><INPUT TYPE="submit" VALUE="Add this Entry">
  26.  
  27.  
  28. </FORM>
  29.  
  30. $CANCEL
  31.  
  32. <hr>
  33.  
  34. <h2>Notes</h2>
  35. The basic idea is that before <EM>logon </EM>or <EM>access_controls</EM>
  36. are checked, SRE-Filter checks if the <EM>request selector</EM>
  37. points to one of the  <b>PUBLIC Area Identifiers</b>.
  38. If so, <STRONG>no</STRONG> <EM>logon </EM>or <EM>access controls</em>
  39. are attempted.
  40. <P>
  41. Specifically, when a <b>Public Area Identifier</b> matches
  42. the client's <EM>request selector</EM>:
  43. <ul>
  44.    <LI> logon checking does NOT occur
  45.     <LI> SEL-specific access controls are <b>not</b> examined
  46. (but SEL-specific permissions will be obtained)
  47.     <LI> ~ substitution, redirection,
  48.       and virtual directory lookup <b>will</b> occur (but see below
  49. for an exception to this rule).
  50. </ul>
  51. <blockquote>In a sense, the areas are
  52. <STRONG>purposely placed outside</STRONG> of the protection of 
  53. SRE-Filter's various access controls.</blockquote>
  54.  
  55.  
  56. <h3>More Notes </h3>
  57. <ul>
  58. <LI> The * can be used as a <em>wildcard character </em>
  59. in the <b>Public Area Identifier</b> field
  60. <blockquote> Exact matches are always used if they exist.
  61. If there is no exact match, and 
  62. if multiple wildcard matches occur,
  63.      the <EM>best </EM>match is used; where <EM>best </EM>
  64.       is defined as the match with
  65.      the most characters before the * (the wildcard) character (and in the
  66.      event of ties, the most after). </blockquote>
  67.  
  68. <LI> On multiple host systems, generic (non-host specific) <b>PUBLIC
  69. Areas Identifiers</b> will <strong>not</strong> be used with requests to
  70. a specific host.
  71. <BR>
  72.  
  73. <LI> The two <b>suppression</b> fields can be used to expedite
  74. throughput.
  75. <UL>
  76. <LI>If you suppress <em>server side includes, redirection, virtual directories and default document lookup</em>,
  77. SRE-Filter assumes that the requested file is relative to the GoServe data
  78. directory.  Furthermore,
  79. server side includes will <b>not</b> be attempted on HTML documents.
  80.  
  81. <LI>If you suppress <em> SRE-Filter's recording of this request</em>, the
  82. request will <b>not</b> be logged in the SRE-Filter transaction recorder.
  83. It <b>will</b> be recorded in GoServe's GOAUDIT.80 audit file.</ul>
  84. One good use of these two suppression options is for .GIF files that
  85. are sent as in-line images (since you probably don't care to track
  86. how many times they've been requested).
  87.  
  88. <LI> The current GoServe data directory is: $datadir
  89. <LI> <b>PUBLIC Area Identifiers</b> are stored in: $initfilt_file
  90. (note that SRE-Filter's documentation usually refers to these <b>Public
  91. Area Identifiers</b>. as <var>PUBLIC_URLS.</var>)
  92.  
  93. </ul>
  94.  
  95. <h3>Examples</h3>
  96.  
  97. <dl>
  98. <DT><STRONG>INDEX.HTM</STRONG>
  99. <dd> INDEX.HTM, in the GoServe data directory will be available to
  100. all clients.
  101.  
  102. <Dt><STRONG>MAPS/* </STRONG>
  103. <dd>    This gives access to everything in (and below)
  104.   the MAPS/ directory --
  105. where MAPS/ is relative to the GoServe data directory, or signifies
  106. a virtual directory. 
  107.  
  108. <dt><STRONG>STORE/AD1.HTM</STRONG>, with
  109.  the <em>supress redirection, etc.</em> option selected.
  110. <dd>AD1.HTM in the STORE/ directory (relative to the GoServe data directory,
  111. with <b>no</b> virtual directory checking) will be transferred as is;
  112. server side includes will <b>not</b> be attempted.
  113.  
  114. <dt><STRONG>STORE/*.GIF</STRONG>, with
  115. the <em>supress recording</em> option selected.
  116. <dd>    All .GIF files in STORE/ will be available to all clients,
  117.         with no recording of these transfers
  118. </dl>
  119.  
  120.  
  121.  
  122. <h3>A Caution</h3>
  123. When using  <b>PUBLIC Area Identifiers</b>, URL resolution by the client's
  124. browser may have unexpected consequences. See the discussion of
  125. <U>local  vs remote redirection</U> in 
  126. <A HREF="/samples/initfilt.doc">INITFILT.DOC </A> for details!
  127.  
  128. <p>
  129.  
  130.