Debian Codegraph @

README

raw
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