Now errors in blockip related subcommands are ignored.
[toast/tdyndns.git] / doc / apache2.txt
1 # Add a virtual host similar than that (for apache 2.4):
2 # (e.g. in /etc/apache2/sites-available/example.com.conf)
3 #
4 # Note that apache has to do authentication/authorization
5 # as well if needed (which will normally be the case).
6 # Normally, AuthBasic is used by DYNDNS systems.
7 # See: http://wiki.apache.org/httpd/PasswordBasicAuth
8
9 <VirtualHost *:80>
10   ServerName dyndns.example.com
11   ServerAdmin webmaster@example.com
12
13   ErrorLog /var/log/apache2/error.log
14   CustomLog /var/log/apache2/access.log combined
15
16   DocumentRoot /var/www/tdyndns
17
18   <Directory /var/www/tdyndns>
19       DirectoryIndex tdyndns.py
20       SetHandler cgi-script
21       Options ExecCGI FollowSymLinks
22
23       AuthType Basic
24       AuthName "tdyndns authorization"
25       AuthUserFile "/etc/tdyndns/.htpasswd"
26       Require valid-user
27   </Directory>
28
29 </VirtualHost>
30
31
32
33 # Hint: For clients that do not support AuthBasic (if there should be any),
34 # the "AuthBasicFake" parameter might be an option to overcome this.
35
36
37
38
39 As an example for an non-standard authorization method, we provided the script
40 tdyndns_auth_simplepwd that just checks whether the user is present in the
41 system and whether a certain password is given (supplied via "AuthExternalContext"
42 below):
43
44 <VirtualHost *:80>
45   ServerName dyndns.example.com
46   ServerAdmin webmaster@example.com
47
48   ErrorLog /var/log/apache2/error.log
49   CustomLog /var/log/apache2/access.log combined
50
51   DocumentRoot /var/www/tdyndns
52
53   DefineExternalAuth tdyndnsauth environment /usr/local/bin/tdyndns_auth_simplepwd
54
55   <Directory /var/www/tdyndns>
56       DirectoryIndex tdyndns.py
57       SetHandler cgi-script
58       Options ExecCGI FollowSymLinks
59
60       AuthType Basic
61       AuthBasicProvider external
62       AuthExternal tdyndnsauth
63       AuthExternalContext hygCithOrs5
64       AuthName "tdyndns authorization"
65       Require valid-user
66   </Directory>
67
68 </VirtualHost>