/Webserver ODB tree: Difference between revisions

From MidasWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 81: Line 81:
* '''Default:''' y  
* '''Default:''' y  
</div>  
</div>  
This key in the [[#top|/Webserver tree]] tells mhttpd whether to bind to a port on localhost. The port to bind to is specified by the ''[[#Localhost port|Localhost port]]'' key.
This key in the [[#top|/Webserver tree]] tells mhttpd whether to bind to a port on localhost. The port to bind to is specified by the ''[[#localhost port|localhost port]]'' key.


=== <span style="color: purple;">''Localhost port ''</span>  ===
=== <span style="color: purple;">''localhost port ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Type:''' INT
Line 89: Line 89:
</div>  
</div>  
This key in the [[#top|/Webserver tree]] tells mhttpd which port to bind to on localhost (if ''[[#Enable localhost port|Enable localhost port]]'' is true). If there are multiple experiments running on the same machine, each experiment should specify a different port.
This key in the [[#top|/Webserver tree]] tells mhttpd which port to bind to on localhost (if ''[[#Enable localhost port|Enable localhost port]]'' is true). If there are multiple experiments running on the same machine, each experiment should specify a different port.
=== <span style="color: purple;">''localhost port passwords ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' BOOL
* '''Default:''' n
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd whether localhost connections require a password. See [[mhttpd#Create_a_password_file|Create a password file]] in the mhttpd documentation for details on how to define the usernames/passwords.
=== <span style="color: purple;">''Enable insecure port ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' BOOL
* '''Default:''' n
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd whether to allow http connections from other machines. The port to bind to is specified by the ''[[#insecure port|insecure port]]'' key.
=== <span style="color: purple;">''insecure port ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Default:''' 8081
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd which port to allow http connections on (if ''[[#Enable insecure port|Enable insecure port]]'' is true). If there are multiple experiments running on the same machine, each experiment should specify a different port.
=== <span style="color: purple;">''insecure port passwords ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' BOOL
* '''Default:''' y
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd whether http connections require a password. See [[mhttpd#Create_a_password_file|Create a password file]] in the mhttpd documentation for details on how to define the usernames/passwords.
=== <span style="color: purple;">''insecure port host list ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' BOOL
* '''Default:''' y
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd whether to only allow http connections from certain machines. The list of allowed machines is specified by the ''[[#Host list|Host list]]'' key. Setting this to ''n'' allows http connections from any machine.
=== <span style="color: purple;">''Enable https port ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' BOOL
* '''Default:''' n
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd whether to allow https connections from other machines. The port to bind to is specified by the ''[[#https port|https port]]'' key.
=== <span style="color: purple;">''https port ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' INT
* '''Default:''' 8443
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd which port to allow https connections on (if ''[[#Enable https port|Enable https port]]'' is true). If there are multiple experiments running on the same machine, each experiment should specify a different port.
=== <span style="color: purple;">''https port passwords ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' BOOL
* '''Default:''' y
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd whether https connections require a password. See [[mhttpd#Create_a_password_file|Create a password file]] in the mhttpd documentation for details on how to define the usernames/passwords.
=== <span style="color: purple;">''insecure port host list ''</span>  ===
<div style="column-count:3;-moz-column-count:3;-webkit-column-count:3">
* '''Type:''' BOOL
* '''Default:''' n
</div>
This key in the [[#top|/Webserver tree]] tells mhttpd whether to only allow https connections from certain machines. The list of allowed machines is specified by the ''[[#Host list|Host list]]'' key. Setting this to ''n'' allows https connections from any machine.

Revision as of 15:28, 31 March 2020


Links

Creating the /Webserver tree

The /Webserver ODB tree is created automatically when the mhttpd program is first run.

Purpose

The /Webserver ODB tree configures the behaviour and security features of mhttpd.


Examples

When initially created, the /Webserver tree contains the following keys:

[local:dev_expt:S]/WebServer>ls -lrt
Key name                        Type    #Val  Size  Last Opn Mode Value
---------------------------------------------------------------------------
WebServer                       DIR
   Enable localhost port       BOOL    1     4     12m  0   RWD  y
   localhost port              INT     1     4     12m  0   RWD  8080
   localhost port passwords    BOOL    1     4     12m  0   RWD  n
   Enable insecure port        BOOL    1     4     12m  0   RWD  n
   insecure port               INT     1     4     12m  0   RWD  8081
   insecure port passwords     BOOL    1     4     12m  0   RWD  y
   insecure port host list     BOOL    1     4     12m  0   RWD  y
   Enable https port           BOOL    1     4     12m  0   RWD  n
   https port                  INT     1     4     12m  0   RWD  8443
   https port passwords        BOOL    1     4     12m  0   RWD  y
   https port host list        BOOL    1     4     12m  0   RWD  n
   Host list                   STRING  10    32    12m  0   RWD
                                       [0]             localhost
                                       [1]
                                       [2]
                                       [3]
                                       [4]
                                       [5]
                                       [6]
                                       [7]
                                       [8]
                                       [9]
   Enable IPv6                 BOOL    1     4     12m  0   RWD  y
   Proxy                       DIR
       example                 STRING  1     23    12m  0   RWD  #http://localhost:8080
   mime.types                  DIR
       .HTML                   STRING  1     10    12m  0   RWD  text/html
       .HTM                    STRING  1     10    12m  0   RWD  text/html
       .CSS                    STRING  1     9     12m  0   RWD  text/css
       .TXT                    STRING  1     11    12m  0   RWD  text/plain
       .ASC                    STRING  1     11    12m  0   RWD  text/plain
       .ICO                    STRING  1     13    12m  0   RWD  image/x-icon
       .GIF                    STRING  1     10    12m  0   RWD  image/gif
       .JPG                    STRING  1     11    12m  0   RWD  image/jpeg
       .JPEG                   STRING  1     11    12m  0   RWD  image/jpeg
       .PNG                    STRING  1     10    12m  0   RWD  image/png
       .SVG                    STRING  1     14    12m  0   RWD  image/svg+xml
       .BMP                    STRING  1     10    12m  0   RWD  image/bmp
       .MP3                    STRING  1     11    12m  0   RWD  audio/mpeg
       .OGG                    STRING  1     10    12m  0   RWD  audio/ogg
       .MID                    STRING  1     11    12m  0   RWD  audio/midi
       .WAV                    STRING  1     10    12m  0   RWD  audio/wav
       .XML                    STRING  1     16    12m  0   RWD  application/xml
       .JS                     STRING  1     23    12m  0   RWD  application/javascript
       .JSON                   STRING  1     17    12m  0   RWD  application/json
       .PS                     STRING  1     23    12m  0   RWD  application/postscript
       .EPS                    STRING  1     23    12m  0   RWD  application/postscript
       .PDF                    STRING  1     16    12m  0   RWD  application/pdf
       .ZIP                    STRING  1     16    12m  0   RWD  application/zip
       .XLS                    STRING  1     22    12m  0   RWD  application/x-msexcel
       .DOC                    STRING  1     19    12m  0   RWD  application/msword

Keys in /Webserver tree

Enable localhost port

  • Type: BOOL
  • Default: y

This key in the /Webserver tree tells mhttpd whether to bind to a port on localhost. The port to bind to is specified by the localhost port key.

localhost port

  • Type: INT
  • Default: 8080

This key in the /Webserver tree tells mhttpd which port to bind to on localhost (if Enable localhost port is true). If there are multiple experiments running on the same machine, each experiment should specify a different port.

localhost port passwords

  • Type: BOOL
  • Default: n

This key in the /Webserver tree tells mhttpd whether localhost connections require a password. See Create a password file in the mhttpd documentation for details on how to define the usernames/passwords.


Enable insecure port

  • Type: BOOL
  • Default: n

This key in the /Webserver tree tells mhttpd whether to allow http connections from other machines. The port to bind to is specified by the insecure port key.

insecure port

  • Type: INT
  • Default: 8081

This key in the /Webserver tree tells mhttpd which port to allow http connections on (if Enable insecure port is true). If there are multiple experiments running on the same machine, each experiment should specify a different port.

insecure port passwords

  • Type: BOOL
  • Default: y

This key in the /Webserver tree tells mhttpd whether http connections require a password. See Create a password file in the mhttpd documentation for details on how to define the usernames/passwords.

insecure port host list

  • Type: BOOL
  • Default: y

This key in the /Webserver tree tells mhttpd whether to only allow http connections from certain machines. The list of allowed machines is specified by the Host list key. Setting this to n allows http connections from any machine.


Enable https port

  • Type: BOOL
  • Default: n

This key in the /Webserver tree tells mhttpd whether to allow https connections from other machines. The port to bind to is specified by the https port key.

https port

  • Type: INT
  • Default: 8443

This key in the /Webserver tree tells mhttpd which port to allow https connections on (if Enable https port is true). If there are multiple experiments running on the same machine, each experiment should specify a different port.

https port passwords

  • Type: BOOL
  • Default: y

This key in the /Webserver tree tells mhttpd whether https connections require a password. See Create a password file in the mhttpd documentation for details on how to define the usernames/passwords.

insecure port host list

  • Type: BOOL
  • Default: n

This key in the /Webserver tree tells mhttpd whether to only allow https connections from certain machines. The list of allowed machines is specified by the Host list key. Setting this to n allows https connections from any machine.