require directive

Purpose

The require directive affects which authenticated users can access a given directory with a given method.

Scope

This directive is only available within Limit sections.

Syntax

require entity en1 en2 ... enn

en are entity names, separated by spaces.

entity is one of the following:

user
Only the named users can access this directory with the given methods.
group
Only users in the named groups can access this directory with the given methods.
valid-user
All of the users defined in the AuthUserFile are allowed access upon providing a valid password.

Default

No default applies.

Example

<Limit GET PUT>
order deny,allow
deny from all
allow from .ncsa.uiuc.edu
require user ls
require group sdg
</Limit>

In this directory, the server evaluates the deny directive first. So, everyone is denied. It then evaluates the allow directive, and decides to allow clients from .ncsa.uiuc.edu. Now, it uses user authentication and only allows users who are named ls or are in the group sdg.

Return to access configuration overview

httpd@ncsa.uiuc.edu