conf/upsset.conf.sample

   1 # Network UPS Tools - upsset.conf sample file
   2 #
   3 # This file is provided to ensure that you do not expose your upsd server
   4 # to the world upon installing the CGI programs.  Specifically, it keeps
   5 # the upsset.cgi program from running until you have assured it that you
   6 # have secured your web server's CGI directory.
   7 #
   8 # NOTE: Contents of this file should be pure ASCII (character codes
   9 # not in range would be ignored with a warning message).
  10 #
  11 # By default, your web server will probably let anyone access upsset.cgi
  12 # once it is installed.  This means that anyone could attempt to crack
  13 # upsd logins since they would appear to be coming from your web server,
  14 # rather than the outside world, slipping through any ACL/ACCESS definitions.
  15 #
  16 # For this reason, you *MUST* first secure your CGI programs before
  17 # enabling upsset in this configuration file.  If you can't do this in
  18 # your web server, then you should *not* run this program.
  19 #
  20 # For Apache, the .htaccess file can be used in the directory with the
  21 # programs.  You'll need something like this for older versions:
  22 #
  23 #   <Files upsset.cgi>
  24 #       deny from all
  25 #       allow from your.network.addresses
  26 #   </Files>
  27 #
  28 # You will probably have to set "AllowOverride Limit" for this directory in
  29 # your server-level configuration file as well.
  30 #
  31 # Modern Apache enjoys a more detailed syntax, like this:
  32 #
  33 #   ScriptAlias /upsstats.cgi /usr/share/nut/cgi/upsstats.cgi
  34 #   ScriptAlias /upsset.cgi /usr/share/nut/cgi/upsset.cgi
  35 #
  36 #   <Directory "/usr/share/nut/cgi">
  37 #         Options +Includes +ExecCGI
  38 #         AllowOverride Limit
  39 #         <RequireAny>
  40 #             Require local
  41 #             Require ip aa.bb.cc.dd/nn
  42 #         </RequireAny>
  43 #   </Directory>
  44 #
  45 # If this doesn't make sense, then stop reading and leave this program alone.
  46 #
  47 # Assuming you have all this done (and it works), then you may uncomment
  48 # the line below and start using upsset.cgi through your web browser.
  49 #
  50
  51 ###
  52 ### I_HAVE_SECURED_MY_CGI_DIRECTORY
  53 ###