mod_gws installation

The Apache module mod_gws provides authorization based on group memberships at a RESTful group webservice.

1. Prerequisites
2. Installation
3. Configuration
4. Diagnostics

Prerequisites

All prerequisites are standard packages and libraries on most unix distributions.

• Apache version 2.x.
  • You need the development part, which includes libraries, includes, and the apsx utility.

• Curl.
  • You need the development part, which includes libraries and includes.

• A groups webservice.
  • It must support GET requests for effective membership.
  • It must support certificate authentication.

Installation

1. Get the current gws module.
2. Configure, make, and install.
   • If your installation is standard configure will be able to find the necessary libraries.
   • The daemon, gwsd, will be installed at ${prefix}/bin.
   • The module will be installed in apache's module directory.

Configure your installation

• The gwsd daemon relays membership queries from the module (via a local socket) to the webservice.

  See the gwsd configuration manual.

• The module processes group membership authorization directives.

  See the module configuration manual.

Diagnostics

• Try running the gwsd daemon with [-d] and [-n] flags to see more diagnostics.
• Use the client program to manually send queries to gwsd.