=== Plugin Name ===
Contributors: sms225
Tags: authentication, CAS, phpCAS
Requires at least: 2.0.2
Tested up to: 2.3.3
Stable tag: 2.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 <a href="http://www.ja-sig.org/wiki/display/CASC/phpCAS">phpCAS</a> to a directory on your web server.  Comment out lines 60 - 103 of CAS.php unless you plan to configure and use the advanced PGT features.
2. Upload cas-authentication.php to the wp-content/plugins/ directory of your wordpress installation.
3. Log in as administrator and activate the plugin.  Go to the Options tab and configure the plugin.  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 to your blog to make sure that it works.
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 -> General -> Anyone can register (they won't be able to)

== Frequently Asked Questions ==

= Who made this? =

Thanks to <a href="http://dev.webadmin.ufl.edu/~dwc/2005/03/02/authentication-plugins/">this guy</a> for working to make WordPress's login system so flexible, and this plugin possible.

Thanks to Lou Rinaldi for early feedback and encouragement.

Thanks to Ioannis Yessios from Yale ITS for adding the administrator interface.