Forge Home

mod_auth_cas

Configure mod_auth_cas with Apache httpd

15,791 downloads

6,916 latest version

4.6 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

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:
  • ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'jgazeley-mod_auth_cas', '0.4.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add jgazeley-mod_auth_cas
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install jgazeley-mod_auth_cas --version 0.4.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

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.