mod_auth_cas

Configure mod_auth_cas with Apache httpd

Jonathan Gazeley

jgazeley

13,598 downloads

5,221 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
    ,
    Ubuntu

Start using this module

Documentation

jgazeley/mod_auth_cas — version 0.4.1 Oct 23rd 2017

mod_auth_cas

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

Overview

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.

Usage

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

certificatepath

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.

loginurl

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

validateurl

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

proxyvalidateurl

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

path

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

version

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

debug

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.

Limitations

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.

Development

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.

Changelog

0.4.0

  • 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.