About Linux FAQ

Browse More FAQs:

Set Apache Password Protected Directories With .htaccess File

Posted by Vivek Gite [Last updated: March 19, 2008]

Q. How do I protecting a directory in Apache on linux?

A. There are many ways you can password protect directories under Apache web server. This is important to keep your file privates from both unauthorized users and search engines (when you do not want to get your data indexed). Here you will see the basics of password protecting a directory on your server. You can use any one of the following method:

  1. Putting authentication directives in a <Directory> section, in your main server configuration httpd.conf file, is the preferred way to implement this kind of authentication.
  2. If you do not have access to Apache httpd.conf file (for example shared hosting) then with the help of file called .htaccess you can create password protect directories. .htaccess file provide a way to make configuration changes on a per-directory basis.

In order to create apache password protected directories you need:

  • Password file
  • And Directory name which you would like to password protect (/var/www/docs)

Step # 1: Make sure Apache is configured to use .htaccess file

You need to have AllowOverride AuthConfig directive in httpd.conf file in order for these directives to have any effect. Look for DocumentRoot Directory entry. In this example, our DocumentRoot directory is set to /var/www. Therefore, my entry in httpd.conf looks like as follows:

<Directory /var/www>
Options Indexes Includes FollowSymLinks MultiViews
AllowOverride AuthConfig
Order allow,deny
Allow from all
</Directory>

Save the file and restart Apache
If you are using Red Hat /Fedora Linux:

# service httpd restart

If you are using Debian Linux:

# /etc/init.d/apache-perl restart

Step # 2: Create a password file with htpasswd

htpasswd command is used to create and update the flat-files (text file) used to store usernames and password for basic authentication of Apache users. General syntax:
htpasswd -c password-file username

Where,

  • -c : Create the password-file. If password-file already exists, it is rewritten and truncated.
  • username : The username to create or update in password-file. If username does not exist in this file, an entry is added. If it does exist, the password is changed.

Create directory outside apache document root, so that only Apache can access password file. The password-file should be placed somewhere not accessible from the web. This is so that people cannot download the password file:

# mkdir -p /home/secure/

Add new user called vivek

# htpasswd -c /home/secure/apasswords vivek

Make sure /home/secure/apasswords file is readable by Apache web server. If Apache cannot read your password file, it will not authenticate you. You need to setup a correct permission using chown command. Usually apache use www-data user. Use the following command to find out Apache username. If you are using Debian Linux use pache2.conf, type the following command:
# grep -e '^User' /etc/apache2/apache2.conf

Output: 

www-data

Now allow apache user www-data to read our password file:
# chown www-data:www-data /home/secure/apasswords
# chmod 0660 /home/secure/apasswords

If you are using RedHat and Fedora core, type the following commands :
# grep -e '^User' /etc/httpd/conf/httpd.conf

Output: 

apache

Now allow apache user apache to read our password file:
# chown apache:apache /home/secure/apasswords
# chmod 0660 /home/secure/apasswords

Now our user vivek is added but you need to configure the Apache web server to request a password and tell the server which users are allowed access. Let us assume you have directory called /var/www/docs and you would like to protect it with a password.

Create a directory /var/www/docs if it does not exist:
# mkdir -p /var/www/docs

Create .htaccess file using text editor:
# cd /var/www/docs
# vi .htaccess

Add following text:

AuthType Basic
AuthName "Restricted Access"
AuthUserFile /home/secure/apasswords
Require user vivek

Save file and exit to shell prompt.

Step # 3: Test your configuration

Fire your browser type url http://yourdomain.com/docs/ or http://localhost/docs/ or http://ip-address/docs


When prompted for username and password please supply username vivek and password. You can add following lines to any file <Diretory> entry in httpd.conf file:

AuthType Basic
AuthName "Restricted Access"
AuthUserFile /home/secure/apasswords
Require user vivek

To change or setup new user use htpasswd command again.

Troubleshooting

If password is not accepted or if you want to troubleshoot authentication related problems, open and see apache access.log/error.log files:

Fedora Core/CentOS/RHEL Linux log file location:
# tail -f /var/log/httpd/access_log
# tail -f /var/log/httpd/error_log

Debian Linux Apache 2 log file location:
# tailf -f /var/log/apache2/access.log
# tailf -f /var/log/apache2/error.log

See also:

E-mail this to a friend      Printable version

Related Other Helpful FAQs:

Discussion on This FAQ

  1. Anonymous Says:
    August 13th, 2006 at 9:19 pm

    is there any similar resource for setting this up on windows?

  2. nixcraft Says:
    August 14th, 2006 at 3:09 am

    Do you want information for Apache or IIS server?

  3. alka Says:
    March 22nd, 2007 at 6:21 am

    When i provide the username & password, it works fine. But when i try to again access something from the same location in the same browser , it does not promt fot the username & password.
    How can i do that?

  4. nixcraft Says:
    March 22nd, 2007 at 8:43 am

    alka,

    Browser remembers your password/username for current running session. If you close browser it will again prompt for the same.

    HTH

  5. Jo Says:
    June 30th, 2007 at 10:27 pm

    I want use the Password Protect Directories for add user in automaticly whit a simple FORM PHP … Tanks for your good services :P

  6. MrGroove Says:
    August 28th, 2007 at 4:26 am

    Nice write-up. From the windows server standpoint running apache, check out http://www.groovypost.com/howto/apache/password-protect-apache-website/

  7. jason Says:
    December 29th, 2007 at 6:19 pm

    Thank you for great tips.
    I did as said in here and it works great.
    But, I have a question.
    The password length that works is only max 8 char.
    In other words, all I have to enter is the first 8 char for the password. After 8 ch, the characters are ignored.
    Is there any way to increase the password length?

    Thank you very much

  8. vivek Says:
    December 30th, 2007 at 11:41 am

    jason,

    You need to change password backend to mysql or ldap.

  9. Mikhail Says:
    February 29th, 2008 at 3:17 am

    Have the same problem with 8-char password, but didn’t found the solution. Is there any way to fix it, please, explain more detailed.

  10. Joshua K Says:
    August 17th, 2008 at 4:04 pm

    I’ve gone through these steps on Ubuntu Hardy twice and it still doesn’t work for me. Is there something I’m missing?

  11. Marian Vlad Says:
    October 9th, 2008 (1 week ago) at 5:58 pm

    try htpasswd -m … ;) (and man htpasswd for more)

Leave a Reply

We encourage your comments, and suggestions. But please stay on topic, be polite, and avoid spam. Thank you very much for stopping by our site!

XHTML: You can use these tags: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong>

*
To prove you're a person (not a spam script), type the security word shown in the picture. Click on the picture to hear an audio file of the word.
Click to hear an audio file of the anti-spam word

Tags: , , , , , , , , , , , ,

Copyright © 2006-2008 nixCraft. All rights reserved - TOS/Disclaimer - Privacy policy - Sitemap - Powered by Open source software.