We've modified a mod_perl module available from CPAN for use with WebISO. This client has been tested on Apache2 with mod_perl2.
The Apache WebISO module requires a database to store session data. Any type of database should work, Postgres, MySQL, etc. Once a database is installed, the tables need to be setup. A file called 'schema.sql' is included with the download and contains the sql to create the database tables. This file should work with Postgres and MySQL, but may need to be altered for other databases. The command to run the sql for Postgres is:
psql -h <dbhost> -U <dbuser> -f schema.sql <dbname> |
Where <dbhost>, <dbuser>, and <dbname> should be replaced with the settings that match the environment.
This module requires these other modules and libraries:
To install the module, type the following:
perl Makefile.PL make make install |
Configure the module for one of the sites-available files or in .htaccess files.
AuthType Apache::AuthCAS AuthName "CAS" PerlAuthenHandler Apache::AuthCAS->authenticate ... PerlSetVar's ... require valid-user |
| Name | Use | Example |
| CASHost | Host name of the WebISO server. | auth.somedomain.com |
| CASPort | Port number for the WebISO Server. | 443 |
| CASDatabaseDriver | Name of the DBI database driver. | Pg |
| CASDatabaseHost | Host name of the database server. | db.somedomain.com |
| CASDatabasePort | Port number for the database server. | 5433 |
| CASDatabaseName | Name of the database. | cas |
| CASDatabaseUser | User to connect to the database with. | dbuser |
| CASDatabasePass | Password used to connect to the database. | dbpass |
| CASLoginURI | URI on the WebISO server where the login servlet lives. | /WebISO/login |
| CASServiceValidateURI | URI on the WebISO server where the service validate servlet lives. | /WebISO/serviceValidate |
| OptInSingleSignOut | Value stating that this service uses single sign out. | true, 1 |
| MyServiceName | The name of the service that will be shown on the logout page. | My Service Name |
You must include this under the AuthHandler code as single sign out is required:
SetHandler perl-script PerlHandler Apache::AuthCAS->handler |