Skip to page content

CASServiceURL

Minimum version required

The features described on this page require EZproxy 5.1a GA or later.

Overview

CASServiceURL is a position-dependent directive that interacts with other CASServiceURL directives. Typical placement is toward the top of config.txt.

Purpose

CASServiceURL is used to configure EZproxy to act as a Central Authentication Service (CAS) server, allowing other CAS client applications to take advantage of EZproxy for user authentication.

The syntax for CASServiceURL is:

CASServiceURL [-Anonymous] WildcardServiceURL

where -Anonymous is an optional parameter to indicate that EZproxy should send "anonymous" instead of the true username and WildcardServiceURL is a wildcard URL to match against the CAS client's service URL. The wildcard URL is case-insensitive and may use the wildcard ? to match any single character and * to match 0 or more characters. Sample use:

CASServiceURL http://casapp.yourlib.org/*

URLs for client

In your CAS client application, you will need to set a login URL and either a validate (CAS 1.x) or service validate (CAS 2.x) URL. To form the required URLs, use these patterns:

http://ezproxy.yourlib.org:2048/cas/login
http://ezproxy.yourlib.org:2048/cas/validate
http://ezproxy.yourlib.org:2048/cas/serviceValidate

replacing ezproxy.yourlib.org:2048 with your server's hostname and port.