"HTTPd Configuration5

HFRD Hypertext Services - Technical Overview

p [next] [previous][contents]

4 - HTTPd Configuration




E HFRD's HTTPd configuration is a subset based on the CERN HTTPd. By =default, the system-table logical name HTTPD$CONFIG Mlocates a common configuration file, unless an individual configuration file Jis specified using a job-table logical name. Simple editing of this file Lchanges the configuration. Comment lines may be included by prefixing them Fwith the hash ``#'' character. Configuration file directives are not Mcase-sensitive. Any changes to the configuration file can only be enabled byOrestarting the HTTPd process using the following command on the server system: 

  $ HTTPD /DO=RESTART


K The reader is also refered to the CERN HTTPd documentation for background 4information on HTTP daemon configuration. Also see W5 - HTTPd Mapping Rules for mapping rule configuration. 

4.1 - Authentication



I The HFRD VMS HTTPd provides little in the way of authorization and path Oaccess control. It does have a scheme providing user name authentication from Dthe host's VMS authorization database (SYSUAF.DAT). This is not Frecommended for Internet, WAN or insecure LAN use. Passwords are Ntransmitted encoded but unencrypted from client to server, and so on anything Bbut a carefully secured LAN poses a distinct and real security Dthreat. Even on an internal LAN a privileged account should Knever, ever be authenticated in this fashion. Hence, by default, this +facility is disabled. You have be warned! 

I The author acknowleges this to be a significant deficiency and would be 2willing to remedy it if appropriate demand exists. !

4.2 - Current Directives



B Note that all boolean directives are disabled (OFF)Iby default. This is done so that there can be no confusion about what isIenabled and disabled by default. To use directive controlled facility it"must be explicitly enabled.

    *
  1. Accept host/domain name(default: all)

    H One or more (comma-separated if on the same line) internet host/domain Anames, with ``*'' wildcarding for host/subdomain matching, to be Iexplicitly allowed access. Also see the Reject directive. Reject Mdirectives have precedence over Accept directives. The Accept directive may =be used multiple times. Also see DNSLookup directive.

    Examples: "

      Accept *.remote.dsto.gov.au  Accept *.hfrd.dsto.gov.au
    4
  2. AddType .suffix representation:encoding script-name description (no default) 

    M Binds a file suffix (extension, type) to a mime content type and encoding. [The script name is used to auto-script (see Auto-Scripting) Ea specified file type. The description is used as documentation for directory listings. 
    
    Examples:N

      AddType  .html  text/html   8bit      -       HyperText Markup Language:  AddType  .txt   text/plain  8bit      -       plain text;  AddType  .gif   image/gif   binary    -       image (GIF)@  AddType  .hlb   text/x-script 7bit    /Conan  VMS Help libraryO  AddType  .decw$book   text/x-script   8bit    /HyperReader    Bookreader book
    0
  3. AddIcon icon-URL ALT-text template (no default) 

    F Specifies a directory listing icon and alternative text for the mime 'content type specified in the template.
    
    Examples: 3

      AddIcon  /icon/-/doc.xbm    [HTM]  text/html/  AddIcon  /icon/-/text.xbm   [TXT]  text/plain.  AddIcon  /icon/-/image.xbm  [IMG]  image/gif
    (
  4. AddBlankIcon icon-URL6
    AddDirIcon icon-URL ALT-text9
    AddParentIcon icon-URL ALT-text:
    AddUnknownIcon icon-URL ALT-text(no defaults) 
    
    KSpecifies a directory listing icon for these non-content-type parts of the listing.
    
    Examples:(
      AddBlankIcon    /icon/-/blank.xbm,  AddDirIcon      /icon/-/dir.xbm      [DIR]F  AddParentIcon   /icon/-/back.xbm     [non-content-type parts of the -  AddUnknownIcon  /icon/-/unknown.xbm  [???] 
    

    (

  5. AuthLocal ON | OFF (default: OFF) 

    ; Enables or disables SYSUAF user name authentication. See 44.1 - Authentication.

    

  6. Busy integer(default: 10)

    > The maximum number of concurrent client connections before a A``server too busy right now ... try again shortly'' error is returned to the client. 

    ,

  7. CommentedInfo ON | OFF (default: OFF) 

    K Includes, commented at the beginning of any HTML document, the software IDGof the server and any relevant VMS file specification for the document.

    !

  8. DirAccess ON | OFF | )SELECTIVE (default: OFF) 

    @ Controls directory listings. SELECTIVE allows access ,only to those directories containing a file :.WWW_BROWSABLE. The HFRD HTTPd directory access <facility always ignores directories containing a file named 6.WWW_HIDDEN. Also see the DirWildcard directive.

    #

  9. DirLayout string (default: I__L__R__S__D) 

    H Allows specification of the directory listing layout. This is a short Mstring that specifies the included fields, relative placement and optionally Othe width of the fields in a directory listing. Each field is controlled by a Nsingle letter and optional leading decimal number specifying its width. If a Nwidth is not specified an appropriate default applies. An underscore is used Oto indicate a single space and is used to separate the fields (two consecutive works well). 

    

    

    * As illustrated in the following examples:#

      DirLayout       I__15L__S__D  DirLayout       15L__9R__S  DirLayout       15N_9C_9R_S
    (
  10. DirOwner ON | OFF (default: OFF) 

    D Allows specification and display of the RMS file owner information.

    $

  11. DirReadme TOP | BOTTOM |#OFF (default: OFF) 

    G If any of the files provided using the DirReadMeFile directive Oare located in the directory the contents are included at the top or bottom of Nthe listing (or not at all). Plain-text are included as plain-text, HTML are 6included as HTML allowing markup tags to be employed. 

    .

  12. DirReadMeFile file.suffix(no default) 

    C Specifies the names and order in which a directory is checked for Aread-me files. This can be enabled or disabled using the JDirReadme directive. Plain-text are included as plain-text, HTML :are included as HTML allowing markup tags to be employed. 

    

    Examples:

      DirReadMeFile readme.html  DirReadMeFile readme.htm  DirReadMeFile readme.  DirReadMeFile readme.txt  DirReadMeFile readme.1st
    

    )

  13. DirWildcard OFF | ON(default: OFF)

    B This enables the facility to force the server to provide aNdirectory listing by providing a wildcard file specification, even if there isMa home (welcome) document in the directory. This should not be confused withGthe DirAccess directive which controls directory listing itself.

    '

  14. DNSLookup ON | OFF(default: OFF) 

    D Enables or disables connection request host name resolution. This Jfunctionality may be expensive (in terms of processing overhead) and make Lserving granularity coarser if DNS is involved. If not enabled and logging Nis, the entry is logged against the numeric internet address. If not enabled Bany accept or reject directive must be expressed as numeric addresses. 

    '

  15. InputTimeout integer(default: 2) 

    K Number of minutes to allow a connection request to be in progress without <submitting a complete request header before terminating it. 

    %

  16. Logging ON | OFF(default: OFF) 

    & Enables or disables the activity log.

    (

  17. OutputTimeout integer(default: 10) 

    I Number of minutes to allow a request to be output before terminating it.

    

  18. Port integer(default: 80) 

    & IP port number for server to bind to.

    '

  19. Recommend ON | OFF(default: OFF) 

    J Provides a short message recommending action when reporting an error to a?client. For example, if a document cannot be found it may say:8

      (document, or bookmark, requires revision)
    

    *

  20. Reject host/domain name(default: none)

    H One or more (comma-separated if on the same line) internet host/domain Anames, with ``*'' wildcarding for host/subdomain matching, to be Iexplicitly denied access. Also see the Accept directive. Reject Ndirectives have precedence of Accept directives. The Reject directive may be :used multiple times. Also see DNSLookup directive.

    Example: 5

      Reject *.remote.dsto.gov.au,*.hfrd.dsto.gov.au
    
  21. Search path(no default) 

    @ Specifies the physical path to the default query-string keyword search script.

    Examples: #

      Search /ht_root/script/query
    #
  22. sHTML ON | OFF(default: OFF) 

    ) Enables or disables HTML pre-processing.

    +

  23. sHTMLaccesses ON | OFF(default: OFF) 

    = Enables or disables HTML pre-processing file access counter.

    '

  24. sHTMLexec ON | OFF(default: OFF) 

    E Enables or disables HTML pre-processing DCL execution functionality.

    &

  25. Welcome file.suffix(no default) 

    M Specifies the names and order in which a directory is checked for home page Bfiles. If no home page is found a directory listing is generated.

    

    Examples: 

      Welcome  home.html  Welcome  home.htm  Welcome  home.menu  Welcome  home.mnu
    


The exampleKconfiguration file for the HFRD HTTPd server can be viewed.




p [next] [previous][contents]