| 1 |
NAME |
| 2 |
Apache2::AuthCASSimple - Apache2 module to authentificate through a CAS |
| 3 |
server |
| 4 |
|
| 5 |
DESCRIPTION |
| 6 |
Apache2::AuthCASSimple is an authentication module for |
| 7 |
Apache2/mod_perl2. It allow you to authentificate users through a Yale |
| 8 |
CAS server. It means you don't need to give login/password if you've |
| 9 |
already be authentificate by the CAS server, only tickets are exchanged |
| 10 |
between Web client, Apache2 server and CAS server. If you not're |
| 11 |
authentificate yet, you'll be redirect on the CAS server login form. |
| 12 |
|
| 13 |
This module allow the use of simple text files for sessions. |
| 14 |
|
| 15 |
SYNOPSIS |
| 16 |
PerlOptions +GlobalRequest |
| 17 |
|
| 18 |
<Location /protected> |
| 19 |
AuthType Apache2::AuthCASSimple |
| 20 |
PerlAuthenHandler Apache2::AuthCASSimple |
| 21 |
|
| 22 |
PerlSetVar CASServerName my.casserver.com |
| 23 |
PerlSetVar CASServerPath / |
| 24 |
# PerlSetVar CASServerPort 443 |
| 25 |
# PerlSetVar CASServerNoSSL 1 |
| 26 |
PerlSetVar CASSessionTimeout 3660 |
| 27 |
PerlSetVar CASSessionDirectory /tmp |
| 28 |
# PerlSetVar CASFixDirectory / |
| 29 |
# PerlSetVar ModProxy 1 |
| 30 |
# PerlSetVar HTTPSServer 1 |
| 31 |
|
| 32 |
require valid-user |
| 33 |
</Location> |
| 34 |
|
| 35 |
or |
| 36 |
|
| 37 |
order deny,allow |
| 38 |
deny from all |
| 39 |
|
| 40 |
require user xxx yyyy |
| 41 |
|
| 42 |
satisfy any |
| 43 |
|
| 44 |
CONFIGURATION |
| 45 |
CASServerName |
| 46 |
Name of the CAS server. It can be a numeric IP address. |
| 47 |
|
| 48 |
CASServerPort |
| 49 |
Port of the CAS server. Default is 443. |
| 50 |
|
| 51 |
CASServerPath |
| 52 |
Path (URI) of the CAS server. Default is "/cas". |
| 53 |
|
| 54 |
CASServerNoSSL |
| 55 |
Disable SSL transaction wih CAS server (HTTPS). Default is off. |
| 56 |
|
| 57 |
CASCaFile |
| 58 |
CAS server public key. This file is used to allow secure connection |
| 59 |
between the webserver using Apache2::AuthCASSimple and the CAS |
| 60 |
server. |
| 61 |
|
| 62 |
DEPRECATED : Authen::CAS::Client use LWP::UserAgent to make https |
| 63 |
requests |
| 64 |
|
| 65 |
CASSessionTimeout |
| 66 |
Timeout (in second) for session create by Apache2::AuthCASSimple (to |
| 67 |
avoid CAS server overloading). Default is 60. |
| 68 |
|
| 69 |
-1 means disable. |
| 70 |
|
| 71 |
0 mean infinite (until the user close browser). |
| 72 |
|
| 73 |
CASSessionDirectory |
| 74 |
Directory where session data are stored. Default is /tmp. |
| 75 |
|
| 76 |
CASFixDirectory |
| 77 |
Force the path of the session cookie for same policy in all |
| 78 |
subdirectories else current directory is used. |
| 79 |
|
| 80 |
ModProxy |
| 81 |
Apache2 mod_perl2 don't be use with mod_proxy. Default is off. |
| 82 |
|
| 83 |
HTTPSServer |
| 84 |
If you want to keep a HTTPS server for all data. Default is 0. |
| 85 |
|
| 86 |
OK AUTH_REQUIRED DECLINED REDIRECT SERVER_ERROR M_GET |
| 87 |
Apache constants to make pod coverage happy |
| 88 |
|
| 89 |
METHOD |
| 90 |
handler |
| 91 |
call by apache2 |
| 92 |
|
| 93 |
VERSION |
| 94 |
This documentation describes Apache2::AuthCASSimple version 0.10 |
| 95 |
|
| 96 |
BUGS AND TROUBLESHOOTING |
| 97 |
* Old expired sessions files must be deleted with an example provided |
| 98 |
script : "delete_session_data.pl" |
| 99 |
|
| 100 |
* Apache::Session::Wrapper certainly need Apache2::Cookie |
| 101 |
|
| 102 |
* $r must be global for sessions with Apache::Session::Wrapper, add |
| 103 |
|
| 104 |
PerlOptions +GlobalRequest |
| 105 |
|
| 106 |
in your virtualhost conf |
| 107 |
|
| 108 |
* Apreq module must be enable in debian |
| 109 |
|
| 110 |
a2enmod apreq |
| 111 |
|
| 112 |
or add |
| 113 |
|
| 114 |
LoadModule apreq_module /usr/lib/apache2/modules/mod_apreq2.so |
| 115 |
|
| 116 |
in your apache configuration file |
| 117 |
|
| 118 |
Please submit any bug reports to [email protected]. |
| 119 |
|
| 120 |
NOTES |
| 121 |
Requires "mod_perl 2" version 2.02 or later Requires Authen::CAS::Client |
| 122 |
Requires Apache::Session::Wrapper |
| 123 |
|
| 124 |
AUTHOR |
| 125 |
Yves Agostini |
| 126 |
CPAN ID: YVESAGO |
| 127 |
Univ Metz |
| 128 |
[email protected] |
| 129 |
http://www.crium.univ-metz.fr |
| 130 |
|
| 131 |
COPYRIGHT |
| 132 |
Copyright (c) 2009 by Yves Agostini |
| 133 |
|
| 134 |
This program is free software; you can redistribute it and/or modify it |
| 135 |
under the same terms as Perl itself. |
| 136 |
|
| 137 |
The full text of the license can be found in the LICENSE file included |
| 138 |
with this module. |
| 139 |
|