web2ldap - standalone.py
Author: Michael Ströder <michael@stroeder.com>
Description: web2ldap: The configuration module for stand-alone mode
Keywords: LDAP LDAPv2 LDAPv3 subschema gateway Python python-ldap Directory userCertificate PKI LDIF DSML

This module contains configuration options solely needed if running as stand-alone web server.

[access_allowed] [access_log] [base_url] [bind_address] [debug_log] [dir_listing_allowed] [document_root] [error_log] [mime_types] [pid_file] [reverse_lookups] [run_username] [server_admin] [server_signature]

## Misc. options

bind_address
  A HTTP server can either listen for connections to every IP address of the server machine, or just one IP address of the server machine. If the argument to this directive is 0.0.0.0, then the server will listen for connections on every IP address. Otherwise, the server can listen to only a specific IP-address or a fully-qualified Internet domain-name. Make sure to align with value of parameter access_allowed.

  Examples:

  listen on port 1760 solely on the loopback interface, set `bind_address = '127.0.0.1:1760'`
  listen on port 8080 on every interface in the system, set `bind_address = '0.0.0.0:8080'`
access_allowed
  List of accepted address/net mask strings of accepted client addresses. Make sure to align with value of parameter bind_address.

  Example for accepting all client IP addresses:

  `access_allowed = ['0.0.0.0/0.0.0.0']`

  Example for accepting only clients from loopback network:

  `access_allowed = ['127.0.0.1/255.0.0.0']`
reverse_lookups
  Try to determine client's host name by doing DNS reverse lookup. Set to 0 to disable, set 1 to enable the directory listings.
run_username
  User account name to setuid after being started as root. This options might be overriden by command-line option -u.
server_admin
  Contact mail address of the server admin when running stand-alone.
server_signature
  This is the server's signature which can be appended to every HTML page. You can use a dictionary string-formatting of all environment vars.

  Example:

  `server_signature = """<ADDRESS>%(SERVER_SOFTWARE)s at <a href="mailto:%(SERVER_ADMIN)s">%(SERVER_NAME)s</a> Port %(SERVER_PORT)s</ADDRESS> """`

## Path names

Path names of needed files and directories.

pid_file
  Path name for file the PID of the main thread is written to.
access_log
  Path name of access log file.
error_log
  Path name of error log file.
debug_log
  Path name of debug log file. stdout and stderr are redirected to this file for redirecting debug messages of underlying modules.
document_root
  Where the static documents reside.
mime_types
  Path name of IANA mime.types file.
dir_listing_allowed
  Allow listing of directories. Set to 0 to disable, set 1 to enable the directory listings.
base_url
  Set a base URL of the application which comes handy for running via reverse proxy. Set to None for letting web2ldap determine the base URL automatically from CGI-BIN environment variable SCRIPT_NAME.