mod_auth_cas is an Apache module that uses CAS to protect static and dynamic web content served by the Apache HTTP Server.
Note: There is an older version of mod_auth_cas that was extensively modified to work with SFU CAS. This version will still work, but is no longer supported. It only works with Apache 2.2, and that version of Apache is no longer being maintained by The Apache Software Foundation. If you are currently using the old SFU mod_auth_cas, and want to upgrade Apache to version 2.4, see the documentation here on moving from the old SFU mod_auth_cas to the new mod_auth_cas.
Configuring mod_auth_cas at SFU
Once you have built and installed mod_auth_cas in your Apache modules directory (say /etc/httpd/modules), you would edit your Apache configuration to load the mod_auth_cas module with
LoadModule auth_cas_module modules/mod_auth_cas.so
You then need to add a few required parameters to configure mod_auth_cas
CASLoginURL https://cas.sfu.ca/cas/login CASValidateURL https://cas.sfu.ca/cas/serviceValidate CASCookiePath /usr/local/apache2/cas/
mod_auth_cas needs to make a direct connection to the CASValidateURL to validate the Service Ticket from CAS when the user logs in. To allow the SSL connection to be made, you need to install the X509 certificate of the Certificate Authority for the CAS server in your certificate folder (default /etc/ssl/certs/). That certificate is available at ThawtePremiumServerBundleCA-2018-v3.pem. You would then specify the directory containing that certificate using:
You can then protect a directory in your Apache configuration by using:
<Location /secured> Authtype CAS Require valid-user </Location>
You can also protect directories by placing the contents of the Location block in .htaccess files.
Supported Require Directives
||All valid users can access the resource.
|Require user userid [userid] ...
||Only the named users can access the resource.|
|Require cas-attribute member:mail-list
||Only members of the named mail list can access the resource.|
|Require cas-attribute sfuEduPersonAffiliation:staff
||Only SFU staff can access the resource.|
|Require cas-attribute sfuEduPersonAffiliation:undergrad
||Only SFU undergrad students can access the source.
|Require cas-attribute sfuEduPersonAffiliation:grad
||Only SFU grad students can access the resource.
|Require cas-attribute sfuEduPersonAffiliation:faculty
||Only SFU faculty can access the resource.
|Require cas-attribute sfuEduPersonAffiliation:alumnus
||Only SFU alumni can access the resource.
|Require cas-attribute sfuIsLightweight:true
||Only SFU lightweight accounts can access the resource.
|Require cas-attribute sfuIsLightweight:false
||Only SFU fullweight account can access the resource.
CAS Help Topics
More information at CAS Apache Module.