summaryrefslogtreecommitdiffhomepage
path: root/debian/README.Debian
diff options
context:
space:
mode:
Diffstat (limited to 'debian/README.Debian')
-rw-r--r--debian/README.Debian42
1 files changed, 41 insertions, 1 deletions
diff --git a/debian/README.Debian b/debian/README.Debian
index 65db4e4..f24b3b8 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -56,6 +56,36 @@ WEBBOX_NAME
Title of the webbox. Will be written on top of the Web UI.
+Authentication
+--------------
+
+There is currently no separate authentication implemented in webbox.
+Instead, the web browser's authentication can be used, e.g.
+
+ <Directory "/usr/lib/webbox">
+
+ # ...
+
+ AuthType Basic
+ AuthName "Webbox"
+ AuthUserFile "/etc/apache2/sites-available/mysite.htpasswd"
+ Require valid-user
+ </Directory>
+
+ <Directory "/var/www/webbox">
+ AuthType Basic
+ AuthName "Webbox"
+ AuthUserFile "/etc/apache2/sites-available/mysite.htpasswd"
+ Require valid-user
+ </Directory>
+
+Add a login/password pair to the password file:
+
+# htpasswd -c /etc/apache2/sites-available/mysite.htpasswd username
+
+Remember to secure both the static web server path and the fastcgi application
+paths in the browser, i.e. /usr/lib/webbox and /var/www/webbox
+
Example configuration for Apache
--------------------------------
@@ -66,6 +96,12 @@ VirtualHost configuration:
# Define the URL of the webbox served by the Apache server:
# http://<servername>/testbox
Alias /testbox /var/www/webbox
+ <Directory "/var/www/webbox">
+ AuthType Basic
+ AuthName "Webbox"
+ AuthUserFile "/etc/apache2/sites-available/mysite.htpasswd"
+ Require valid-user
+ </Directory>
# Actual location of files to be served
FcgidInitialEnv WEBBOX_PATH /home/testbox
@@ -90,9 +126,13 @@ VirtualHost configuration:
# Order allow,deny
# Allow from all
Require all granted
+
+ AuthType Basic
+ AuthName "Webbox"
+ AuthUserFile "/etc/apache2/sites-available/mysite.htpasswd"
+ Require valid-user
</Directory>
-
Contact
-------