backgroundcolor = red#faa|

We have a budding feature to require login to individual webapps<div style="border: 1px solid #A3B1BF; padding: .8em 1em; background-color: #E6F2FF; margin: 0px 1em;">'''NOTE:''' The one-click [https://www.amahi.org/apps/web-apps Web Apps] will provide this capability in Amahi 7 or greater.</div>

Would you like to control which HDA users can access certain web applications? This can be easily done in Amahi 6. To use this function, select the web apps section in the apps tab. Expand the desired app and select the '''Require login''' check box. If selected, this settings makes it such that the application will ask for a user name and a password. The perform the steps below to create the <code>htpasswd</code> file.

We have decided to make these '''NOTE:''' This is a global settingat the moment, i.e. the users and password are all the same to all the apps that require have '''Require login''' selected. This feature <u>IS NOT</u> compatible with [[Secure_App_Access|Access Web Apps over SSL]].

*Option 1: Navigate to [http://www.webmaster-toolkithtaccesstools.com/htaccesshtpasswd-generator.shtml .htaccess / htpasswd Generator].

*Enter desired Username, Password, and Path (physical location where <code>.htpasswd</code> will be stored). For example, Username '''''amahi''''', Password '''''amahi''''', and Path '''''/var/hda/web-apps/linfo'''''.

*Copy the text from ''"And this is what your .htpasswd file should look like..."'' box and paste it into the <code>.htpasswd</code> file in then web application directory (i.e. /var/hda/web-apps). It should look similar to this: {{Text|<pre>amahi:amb24e1pXrqFY}}</pre>*Proceed to the '''Copy and Set the File Permissions''' section to complete.

*Option 2: [[Open_Terminal_as_root|Open Terminal as root user]]

*Perform Create the following steps [[Open_Terminal_as_root|as root user]] <code>htpasswd</code> file (change username and password):{{Code|<pre>htpasswd -c -b .htpasswd username password}}</pre>*Proceed to the '''Copy and Set File Permissions''' section to complete.</blockquote> ==== User Maintenance (Add/Delete) ====*Add additional users, repeat the previous step (('''NOTE:''' the -c option is only needed the first time you create the file for that web application):{{Code| htpasswd -b ./var/hda/web-apps/htpasswd username password}}

{{Code|htpasswd -D ./var/hda/web-apps/htpasswd username}} ==== Copy and Set File permissions: ====

{{Code| cp .htpasswd /var/hda/web-apps/htpasswd}}* Next, set the permissions. ==== Set File permissions: ====

{{Code| chmod 600 /var/hda/web-apps/htpasswd chown apache:apache /var/hda/web-apps/htpasswd}} == If you have webmin installed ==

*After logging into Webmin select “Others” on the left-hand side, click on “Protected Web Directories” and then select “Add protection for a new directory”.*In “Directory path” ''"Directory path"'' browse to/or enter the path to the ‘html’ <code>html</code> web directory you wish to protect, in ''“Authentication realm” '' enter something like for example ''“Authentication required” '' (this will show up on the popup login box) and then click on create.*Now you need to setup users to allow login by clicking on ''“Add a new user”'' in ''“Associated users and groups”'', when users have been created you should be good to go.

Note'''NOTE: ''' After you have completed this process using webmin Webmin you can then select ''"un-protect selected directory" '' and use the HDA-Dashboard to enable/disable password protection.