NAME

Apache2::AuthCASSimple - Apache2 module to authentificate trough a CAS server

DESCRIPTION

Apache2::AuthCASSimple is an authentication module for Apache2/mod_perl2. It allow you to authentificate users trough a Yale CAS server. It means you don't need to give login/password if you've already be authentificate by the CAS server, only tickets are exchanged between Web client, Apache2 server and CAS server. If you not're authentificate yet, you'll be redirect on the CAS server login form.

This module allow the use of simple text files for sessions.

SYNOPSIS

  <Location /protected>
    AuthType Apache2::AuthCASSimple
    PerlAuthenHandler Apache2::AuthCASSimple

    PerlSetVar CASServerName my.casserver.com
    PerlSetVar CASServerPath /
    # PerlSetVar CASServerPort 443
    # PerlSetVar CASServerNoSSL 1
    PerlSetVar CASSessionTimeout 60
    PerlSetVar CASSessionDirectory /tmp
    # PerlSetVar CASFixDirectory /
    # PerlSetVar ModProxy 1

    require valid-user
  </Location>

or

  order deny,allow
  deny from all

  require user xxx yyyy

  satisfy any

CONFIGURATION

CASServerName

Name of the CAS server. It can be a numeric IP address.

CASServerPort

Port of the CAS server. Default is 443.

CASServerPath

Path (URI) of the CAS server. Default is "/cas".

CASServerNoSSL

Disable SSL transaction wih CAS server (HTTPS). Default is off.

CASCaFile

CAS server public key. This file is used to allow secure connection between the webserver using Apache2::AuthCASSimple and the CAS server.

DEPRECATED : the Authen::CAS::Client manpage use the LWP::UserAgent manpage to make https requests

CASSessionTimeout

Timeout (in second) for session create by Apache2::AuthCASSimple (to avoid CAS server overloading). Default is 60.

-1 means disable.

0 mean infinite (until the user close browser).

CASSessionDirectory

Directory where session data are stored. Default is /tmp.

CASFixDirectory

Force the path of the session cookie for same policy in all subdirectories else current directory is used.

ModProxy

Apache2 mod_perl2 don't be use with mod_proxy. Default is off.

METHOD

handler

call by apache2

VERSION

This documentation describes Apache2::AuthCASSimple version 0.0.1

BUGS AND TROUBLESHOOTING

• Old expired sessions files must be deleted with an example provided script : delete_session_data.pl
• the Apache::Session::Wrapper manpage certainly need the Apache2::Cookie manpage
• $r must be global for sessions with the Apache::Session::Wrapper manpage, add

    PerlOptions +GlobalRequest

  in your virtualhost conf

• Apreq module must be enable in debian

    LoadModule apreq_module /usr/lib/apache2/modules/mod_apreq2.so

Please submit any bug reports to agostini@univ-metz.fr.

NOTES

Requires mod_perl 2 version 2.02 or later Requires the Authen::CAS::Client manpage Requires the Apache::Session::Wrapper manpage

AUTHOR

    Yves Agostini
    CPAN ID: YVESAGO
    Univ Metz
    agostini@univ-metz.fr
    http://www.crium.univ-metz.fr

COPYRIGHT

Copyright (c) 2008 by Yves Agostini

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.