=== Plugin Name ===
Contributors: sms225
Tags: authentication, cas, phpCAS
Requires at least: 2.0.2
Tested up to: 2.2.1
Stable tag: 1.0

Authenticate users using the phpCAS package (http://www.ja-sig.org/wiki/display/CASC/phpCAS).

== Description ==

Central Authentication System (CAS) is a single signon service provided by some universities.  <a href="http://www.ja-sig.org/wiki/display/CAS/Home">Read about it here.</a>

phpCAS is a client for the CAS service.  You can <a href="http://www.ja-sig.org/wiki/display/CASC/phpCAS">read about that here</a>.  You have to download it separately and point this script to it.

This plugin uses some hooks in WordPress's authentication system to bypass the normal login screen and authenticate over CAS instead.  Note that logged-in state is still maintained in cookies, and user entries are created in the local database.

== Installation ==

1. Download phpCAS.
2. Upload cas-authentication.php to the wp-content/plugins/ directory of your wordpress installation, and configure the phpCAS::client part.  Also configure or disable the email bit on line 85.
3. Activate the plugin, and STAY LOGGED IN to your original administrator account.  You won't be able to log back in once you log out.
4. Open a window in a different browser (i.e. Internet Explorer if you were using FireFox), or on another computer.  Log in through CAS.
5. In the first browser window, make the newly created CAS user the new administrator.  You can log out now. (alternately, you can change some entries in the wp_usermeta table to make a new user the admin)
6. Disable Options -> Membership -> Anyone can register (they won't be able to)

== Frequently Asked Questions ==

= What school was this originally written for? =

Yale. Go Bulldogs.

= What about foo bar? =

Answer to foo bar dilemma.

= Did you come up with this all by yourself? =

Heck no.  <a href="http://dev.webadmin.ufl.edu/~dwc/2005/03/02/authentication-plugins/">This man</a> seems to deserve the credit for making WordPress's login system so flexible.  This plugin was made possible by his HTTP authentication plugin.