Mercurial > hg > ngx_http_auth_request_module
annotate README @ 2:187ac993cd15 0.1
Auth request: mention satisfy directive in README.
| author | Maxim Dounin <mdounin@mdounin.ru> |
|---|---|
| date | Sat, 27 Feb 2010 15:15:59 +0300 |
| parents | 436da5355bd5 |
| children | cc231fa95159 |
| rev | line source |
|---|---|
| 0 | 1 Auth request module for nginx. |
| 2 | |
| 3 This module allows authorization based on subrequest result. Once subrequest | |
| 4 returns 2xx status - access is allowed, on 401 or 403 - disabled with | |
| 5 appropriate status. Anything else is considered to be an error. | |
| 6 | |
| 7 For 401 status WWW-Authenticate header from subrequest response will be | |
| 8 passed to client. | |
| 9 | |
|
2
187ac993cd15
Auth request: mention satisfy directive in README.
Maxim Dounin <mdounin@mdounin.ru>
parents:
0
diff
changeset
|
10 Module works at access phase and therefore may be combined nicely with other |
|
187ac993cd15
Auth request: mention satisfy directive in README.
Maxim Dounin <mdounin@mdounin.ru>
parents:
0
diff
changeset
|
11 access modules (access, auth_basic) via satisfy directive. |
|
187ac993cd15
Auth request: mention satisfy directive in README.
Maxim Dounin <mdounin@mdounin.ru>
parents:
0
diff
changeset
|
12 |
| 0 | 13 Configuration directives: |
| 14 | |
| 15 auth_request <uri>|off | |
| 16 | |
| 17 Context: http, server, location | |
| 18 Default: off | |
| 19 | |
| 20 Switches auth request module on and sets uri which will be asked for | |
| 21 authorization. | |
| 22 | |
| 23 Usage: | |
| 24 | |
| 25 location /private/ { | |
| 26 auth_request /auth; | |
| 27 ... | |
| 28 } | |
| 29 | |
| 30 location = /auth { | |
| 31 proxy_pass ... | |
| 32 } | |
| 33 | |
| 34 To compile nginx with auth request module, use "--add-module <path>" option | |
| 35 to nginx configure. | |
| 36 | |
| 37 Development of this module was sponsored by Openstat (http://www.openstat.com/). |