Forge Home


Configure mod_auth_cas with Apache httpd

Jonathan Gazeley



5,654 latest version

4.6 quality score

Version information

  • 0.4.1 (latest)
  • 0.4.0
  • 0.3.0
  • 0.2.1
  • 0.2.0
  • 0.1.1
  • 0.1.0
released Oct 23rd 2017
This version is compatible with:
  • RedHat

Start using this module


jgazeley/mod_auth_cas — version 0.4.1 Oct 23rd 2017


Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module


This module installs and configures auth_cas for Apache httpd. This module is frequently used for single sign-on systems.

This module depends on puppetlabs/apache to install and configure Apache httpd.


This module takes the following parameters, most of which are required.


The path to the CA certificate used to validate the CAS server. Optional, defaults to /etc/pki/tls/certs/ca-bundle.crt on Red Hat systems and /etc/ssl/certs/ca-certificates.crt on Debian systems.


The URL to redirect users to when they attempt to access a CAS protected resource and do not have an existing session. Required.


The URL to use when validating a ticket presented by a client in the HTTP query string (ticket=...).


The URL to use when performing a proxy validation. This is currently an unimplemented feature, so setting this will have no effect.


The path in which to install the CAS cache. Optional, defaults to /cas.


The version of the CAS protocol to use. Optional, defaults to 1.


Enable debug messages from mod_auth_cas. For this to work, you also need to set LogLevel Debug in your global or vhost config. Optional, defaults to Off.


This module was written for use with CentOS 6 and Apache 2.2 and has since been extended to work with CentOS 7 and Apache 2.4. It should work with Debian too, but this hasn't been tested. Please let me know how you get on.


Feel free to send pull requests for new features. A lot of the possible CAS configuration parameters are not (yet) implemented in this module because they aren't used at my site.

Also welcome are modifications to support other distributions, or simply a note to say it works as-is on your distro.



  • CASValidateServer functionality has been removed to retain compatibility with mod_auth_cas 1.1. Users must either fix their SSL certificate configuration using the CASCertificatePath directive, or switch to communicating with the CAS server over standard HTTP.