summaryrefslogtreecommitdiff
path: root/doc/httpauthd.8
blob: 80c70bc10b6ec9bf1709600292171de2c10c8533 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
.\" 
.\" Copyright (c) 2004, Nate Nielsen
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without 
.\" modification, are permitted provided that the following conditions 
.\" are met:
.\" 
.\"     * Redistributions of source code must retain the above 
.\"       copyright notice, this list of conditions and the 
.\"       following disclaimer.
.\"     * Redistributions in binary form must reproduce the 
.\"       above copyright notice, this list of conditions and 
.\"       the following disclaimer in the documentation and/or 
.\"       other materials provided with the distribution.
.\"     * The names of contributors to this software may not be 
.\"       used to endorse or promote products derived from this 
.\"       software without specific prior written permission.
.\" 
.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 
.\" "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 
.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS 
.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE 
.\" COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, 
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, 
.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS 
.\" OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED 
.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF 
.\" THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 
.\" DAMAGE.
.\" 
.\"
.\" CONTRIBUTORS
.\"  Nate Nielsen <nielsen@memberwebs.com>
.\"
.Dd April, 2004
.Dt httpauthd 8
.Os httpauth 
.Sh NAME
.Nm httpauthd
.Nd a daemon which performs HTTP authentication
.Sh DESCRIPTION
.Xr httpauthd 8
is a daemon that performs HTTP authentication for a variety of HTTP servers.
Callers send it HTTP headers, which it then processes and returns responses
destined for the client.
.Pp
It listens on unix or IP sockets, allowing for centralization of HTTP
authentication and an extra layer security if necessary. 
.Pp
.Nm httpauthd 
can perform a variety of different types of authentication, and is built
in an extensible manner so more can be added in the future. Currently it 
can perform Basic and Digest authentation against files, LDAP, MYSQL and 
PostgreSQL. It can also perform Basic and NTLM authentication against a 
Windows server.
.El
.Sh OPTIONS
The options are as follows:
.Bl -tag -width Fl
.It Fl d 
Don't detach from the console and run as a daemon. In addition the 
.Ar level
argument specifies what level of error messages to display. 0 being 
the least, 4 the most.
.It Fl f
Specify an alternate location for the configuration file.
.It Fl X
Process stdin and stdout instead of listening for connections on a 
socket. Useful for troubleshooting problems.
.El
.Sh SEE ALSO
.Xr httpauth.conf 5
.Sh AUTHOR
.An Nate Nielsen Aq nielsen@memberwebs.com