From 97c8b7f21b8aeeda56f68deee8349f381d60eb96 Mon Sep 17 00:00:00 2001
From: Roland Stigge <stigge@antcom.de>
Date: Tue, 9 Jan 2018 22:20:32 +0100
Subject: Fix mobile view, add password config

---
 debian/README.Debian | 42 +++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 41 insertions(+), 1 deletion(-)

(limited to 'debian')

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
 -------
 
-- 
cgit v1.2.3