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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="modpython.css" type='text/css'>
<link rel="first" href="modpython.html" title='Mod_python Manual'>
<link rel='contents' href='contents.html' title="Contents">
<link rel='index' href='genindex.html' title='Index'>
<link rel='last' href='about.html' title='About this document...'>
<link rel='help' href='about.html' title='About this document...'>
<LINK REL="next" href="dir-handlers-auzh.html">
<LINK REL="prev" href="dir-handlers-ach.html">
<LINK REL="parent" href="dir-handlers.html">
<LINK REL="next" href="dir-handlers-auzh.html">
<meta name='aesop' content='information'>
<META NAME="description" CONTENT="PythonAuthenHandler">
<META NAME="keywords" CONTENT="modpython">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<title>5.1.7 PythonAuthenHandler</title>
</head>
<body>
<DIV CLASS="navigation">
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><a rel="prev" title="5.1.6 PythonAccessHandler"
href="dir-handlers-ach.html"><img src='previous.gif'
border='0' height='32' alt='Previous Page' width='32'></A></td>
<td><a rel="parent" title="5.1 Request Handlers"
href="dir-handlers.html"><img src='up.gif'
border='0' height='32' alt='Up One Level' width='32'></A></td>
<td><a rel="next" title="5.1.8 PythonAuthzHandler"
href="dir-handlers-auzh.html"><img src='next.gif'
border='0' height='32' alt='Next Page' width='32'></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td><a rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.gif'
border='0' height='32' alt='Contents' width='32'></A></td>
<td><img src='blank.gif'
border='0' height='32' alt='' width='32'></td>
<td><a rel="index" title="Index"
href="genindex.html"><img src='index.gif'
border='0' height='32' alt='Index' width='32'></A></td>
</tr></table>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="dir-handlers-ach.html">5.1.6 PythonAccessHandler</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="dir-handlers.html">5.1 Request Handlers</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="dir-handlers-auzh.html">5.1.8 PythonAuthzHandler</A>
<br><hr>
</DIV>
<!--End of Navigation Panel-->
<H2><A NAME="SECTION007170000000000000000"> </A>
<a name="l2h-251"> </a>
<BR>
5.1.7 PythonAuthenHandler
</H2>
<P>
<b><em class="citetitle"><a
href="http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Syntax"
title="Syntax:"
>Syntax:</a></em></b>
<i>Python*Handler Syntax</i>
<BR><em class="citetitle"><a
href="http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Context"
title="Context:"
>Context:</a></em>
server config, virtual host, directory, htaccess
<BR><em class="citetitle"><a
href="http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Override"
title="Override:"
>Override:</a></em>
not None
<BR><em class="citetitle"><a
href="http://httpd.apache.org/docs-2.0/mod/directive-dict.html#Module"
title="Module:"
>Module:</a></em>
mod_python.c
<P>
This routine is called to check the authentication information sent
with the request (such as looking up the user in a database and
verifying that the [encrypted] password sent matches the one in the
database).
<P>
To obtain the username, use <code>req.user</code>. To obtain the password
entered by the user, use the <code>req.get_basic_auth_pw()</code> function.
<P>
A return of <code>apache.OK</code> means the authentication succeeded. A
return of <code>apache.HTTP_UNAUTHORIZED</code> with most browser will bring
up the password dialog box again. A return of
<code>apache.HTTP_FORBIDDEN</code> will usually show the error on the
browser and not bring up the password dialog
<code>again. HTTP_FORBIDDEN</code> should be used when authentication
succeeded, but the user is not permitted to access a particular URL.
<P>
An example authentication handler might look like this:
<P>
<div class="verbatim"><pre>
def authenhandler(req):
pw = req.get_basic_auth_pw()
user = req.user
if user == "spam" and pw == "eggs":
return apache.OK
else:
return apache.HTTP_UNAUTHORIZED
</pre></div>
<P>
<div class="note"><b class="label">Note:</b>
<code>req.get_basic_auth_pw()</code> must be called prior to using the
<code>req.user</code> value. Apache makes no attempt to decode the
authentication information unless <code>req.get_basic_auth_pw()</code> is called.
</div>
<P>
<DIV CLASS="navigation">
<p><hr>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td><a rel="prev" title="5.1.6 PythonAccessHandler"
rel="prev" title="5.1.6 PythonAccessHandler"
href="dir-handlers-ach.html"><img src='previous.gif'
border='0' height='32' alt='Previous Page' width='32'></A></td>
<td><a rel="parent" title="5.1 Request Handlers"
rel="parent" title="5.1 Request Handlers"
href="dir-handlers.html"><img src='up.gif'
border='0' height='32' alt='Up One Level' width='32'></A></td>
<td><a rel="next" title="5.1.8 PythonAuthzHandler"
rel="next" title="5.1.8 PythonAuthzHandler"
href="dir-handlers-auzh.html"><img src='next.gif'
border='0' height='32' alt='Next Page' width='32'></A></td>
<td align="center" width="100%">Mod_python Manual</td>
<td><a rel="contents" title="Table of Contents"
rel="contents" title="Table of Contents"
href="contents.html"><img src='contents.gif'
border='0' height='32' alt='Contents' width='32'></A></td>
<td><img src='blank.gif'
border='0' height='32' alt='' width='32'></td>
<td><a rel="index" title="Index"
rel="index" title="Index"
href="genindex.html"><img src='index.gif'
border='0' height='32' alt='Index' width='32'></A></td>
</tr></table>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="dir-handlers-ach.html">5.1.6 PythonAccessHandler</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="dir-handlers.html">5.1 Request Handlers</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="dir-handlers-auzh.html">5.1.8 PythonAuthzHandler</A>
<hr>
<span class="release-info">Release 3.2.10, documentation updated on July 19, 2006.</span>
</DIV>
<!--End of Navigation Panel-->
</BODY>
</HTML>
|
