Apache is one of the most widely used and popular web servers in the world, so it is important to keep your websites private from unauthorized users. Apache authentication can be configured to require website visitors to log in with a user ID and password. There are many ways you can password protect directories under an Apache web server.
This article describes an easy way to password protect a web directory in Apache using an
Note: this tutorial is done on a Ubuntu server with Apache installed.
Installing the Apache Utilities Package
First, you need to install the
apache2-utils package which provides a utility called
htpasswd to create a password file.
You can install it by running the following command:
sudo apt-get install apache2-utils
Configure Apache to Allow .htaccess Authentication
By default, Apache doesn’t allow the use of an .htaccess file in Ubuntu 14.04. You will need to set up the Apache config file to allow .htacces- based authentication.
You can do this by editing the Apache config file:
sudo nano /etc/apache2/apache2.conf
Find the section that begins with the
Directory "/var/www/html" and change the line from
AllowOverride none to
Options Indexes FollowSymLinks AllowOverride AuthConfig Require all granted
Save and close the file.
Create the Password File
You can use the
htpasswd command line utility to create a password file that Apache can use to authenticate users. Now, create a hidden .htpasswd file in the “/etc/apache2” configuration directory.
sudo htpasswd -c /etc/apache2/.htpasswd authuser1
This will ask you to supply and confirm a password for authuser1.
If you want to add another user, then leave out the
-c argument with
Now, to create another authentication for a second user, authuser2:
sudo htpasswd /etc/apache2/.htpasswd authuser2
You can see the user name and the encrypted password for each record by running:
sudo cat /etc/apache2/.htpasswd
You need to grant permission to the “www-data” user to be able to read the .htpasswd file.
sudo chown www-data:www-data /etc/httpd/.htpasswd sudo chmod 0660 /etc/httpd/.htpasswd
Configure Apache Password Authentication
You need to create an “.htaccess” file in the web directory you wish to restrict. In this example I will create an “.htaccess” file in the “/var/www/html/” directory to restrict the entire document root.
sudo nano /var/www/html/.htaccess
Add the following content:
AuthType Basic AuthName "Restricted Content" AuthUserFile /etc/apache2/.htpasswd Require valid-user
Here is what the above code means:
- AuthType: This option defines the type of authentication.
- AuthName: This is content which displays on web page when prompted for user name and password.
- AuthUserFile: This option specifies the location of user credentials.
- require valid-user: This indicates that only successful authenticated requests may load the page.
Save and close the file, and restart Apache to make these changes take effect.
sudo /etc/init.d/apache2 restart
Testing Password Authentication
Now on a remote machine, access your website in a web browser. You will be prompted with a user name and password to access web page.
If you enter the correct user credentials, you will be allowed to access the content. If you enter the wrong user credentials or hit “Cancel,” you will see the Unauthorized error page.
You should now have enough knowledge to set up basic authentication for your Apache web server. Also remember that password protection should be combined with SSL encryption so that your credentials are not sent to the server in plain text.
Our latest tutorials delivered straight to your inbox